Archify：検証可能なシステム図を生成するAIエージェント

背景と概要

AI支援コーディングツールが開発ワークフローの標準となり、エージェントにシステムの内部構造を理解させ描画する需要が高まっている。しかし開発者がアーキテクチャ図やシーケンス図、データフロー図の作成を依頼すると、長年の痛点が浮き彫りになる。モデルは確率的に画像を生成し、存在しないコンポーネントや接続、ルートをでっち上げる。専門的に見えながら検証できず、コードレビューや跨チームコミュニケーションに混入すると判断を誤らせる。この隙間を埋めるため、Archify（tt-a1i/archify）というNode.jsの描画・検証システムが登場した。

アーキテクチャ・アズ・コード運動とコーディングエージェントのツールチェーンが交わる位置に据えられ、ArchifyはCursor、Claude Code、Codex CLI、OpenCodeにエージェントスキルとして組み込まれる。コードベースやシステム記述をインタラクティブで検証可能なシステムマップに変換する。JavaScriptを主体に記述され、agent-skills、architecture-diagram、codex、coding-agentsのタグが付き、現在はv2.17.0-dev.1という開発ビルドにある。GitHubで積み上がる関心が、検証可能なアーキテクチャ図という細かなニッチへの本当の興味を示している。

深掘り分析

Archifyの核心設計は描画と検証の分離にある。エージェントにまず型付きJSONの中間表現（IR）を生成させ、システムがそれを決定論的にHTMLまたはSVGへコンパイルする。図はモデルのサンプリングの自由な産物ではなく、型と決定論的チェックに制約された結果となる。これにより四つの知覚可能な能力が生まれる。第一の「開けば表示」は、五種類の図の型、四つのプリセット、深色と浅色のテーマ、ブランドロゴ、抑えたアニメーションで、チャット窓にも正式な展示にも対応する。

第二の「マージ前のアーキテクチャ変更の審査」は、検証済みの二つのスナップショットをBefore/Delta/Afterの形式で比較し、追加・削除・変更・移動・再ルーティングを正確に報告する。第三の「すべての対話が事実に根ざす」は、ノード検索、改訂検証済みのソースの任意開封、上流・下流の到達性追跡、セマンティック役割の比較、ガイド付きストーリー再生が、トポロジーをでっち上げずに機能することを意味する。第四の「一つファイルで信頼と共有」は、型付きIRと決定論的チェックが自己完結型のHTMLを生成し、PNG、SVG、WebM、1200×630の共有カードへエクスポートできることだ。

導入は意図的に摩擦なく設計されている。インストールはnpx skills add tt-a1i/archify -gという一行のコマンドだけで、Cursorユーザーはエージェント指向のクイックスタートを開き、正確なグローバルとプロジェクトレベルのコマンドを取得できる。リポジトリのクローンは一切不要で、どのエージェントチャットでもシステムを記述するだけで図が生成され、描画動作が既存の対話式ワークフローにシームレスに組み込まれる。ドキュメントはプロジェクトページ、シーンガイド、Proof Labの三つの入口を提供し、そのうちProof Labは十一のチェックイン済みシーンを収録し、各自のJSONソース、名前付きビュー、検証レシートを添えている。

業界への影響

Archifyのより宏观的な意義は、かつてAI出力の中で最も制御困難だった环节に、検証可能性という工程原則を持ち込んだことにある。開発者コミュニティにはエージェント出力を監査可能なアートファクトとして扱う范式を提供し、工学チームにはマージ前のアーキテクチャ変更比較と到達性追跡が、コードレビューとリスク管理に直接奉仕する。本物の現地に根ざすことを示すため、実際のリポジトリmco-org/mcoの特定のコミットから生成されたアーキテクチャマップを、到達性追跡と型付きソースと配套して追跡している。

このツールは観察すべき危険も内包する。図の信頼度がIRの型制約と検証ルールに強く依存するとき、そのルールに隙間があったり、エージェントがIR生成段階で事実から逸脱したりして、検証が形式化に陥る恐れがある。さらに決定論的コンパイルはランダム性を消すが、トポロジー記述が実際のコードと完全に一致する保証はなく、重要な経路は依然として手動の照合を要する。層状の体験は、チャット内の素早いスケッチから審査・共有可能な納品物まで、信頼の必要性に応じて深さを選べるようにする。

今後の展望

観察すべき方向には、検証レシートがチームワークフロー内の標準的な証明書になるか、セマンティック役割の比較とガイド付きストーリーが跨チームコミュニケーションコストをさらに削減できるか、より多くの種類のコーディングエージェントやCIパイプラインにネイティブに採用されるかがある。Archifyは実用的な経路を表す。

より華やかなAIの描画ではなく、信頼できる描画を追求する点だ。アーキテクチャ・アズ・コードの生態系が成熟するにつれ、その決定論ベースの手法は、エージェント生成図の検証・監査・共有の方法に基準を設ける可能性がある。図を使い捨ての画像から検証可能なアートファクトへという再構成は、チームが検証レシートを権威あるものとして扱い、決定論的コンパイルモデルが本番のコードレビューで手動のトポロジー照合を置き換えるのに十分な堅牢性を示すかにかかっている。