Archify: AIがコードベースを美しいシステムアーキテクチャ図に変換

Archifyを知るべき理由#

手動でシステムアーキテクチャ図を描いて、コードが変わるたびに更新し直す…そんなことに何時間も費やしたことはありませんか？ Archifyはこの問題を解決します。自然言語で説明するだけで、AIがコードベースをインタラクティブで美しいアーキテクチャ図に変換します。

[!TIP] Archifyは現在GitHubでトレンド中で、数千のスターを獲得しています。現在最も人気のあるAIエージェントスキルの一つです。

Archifyとは？#

Archifyは、Cursor、Claude Code、Codex CLI、OpenCode向けのエージェントスキルとして機能するオープンソースのレンダリングおよびバリデーションシステムです。手描きやMermaid構文に悩む代わりに、AIに「このリポジトリのランタイムアーキテクチャをマッピングして」と言うだけで、Archifyが以下を行います：

1. 型付きJSON IRを生成 — AIがシステムを構造化データとして記述
2. 自動バリデーション — スキーマ、レイアウト、HTML/SVG、ルートの確認
3. HTMLにレンダリング — 単一の自己完結HTMLファイルとして出力

[!NOTE] Archifyは汎用の描画エディタでもMermaidテーマでもありません。技術的な意図をコミュニケーションアーティファクトに変換します。

5つの図のタイプ#

Archifyは5つの主要な図タイプをサポートしています：

インストールと使い方#

npx skills add tt-a1i/archify -g

インストール後、チャットでAIエージェントに指示するだけです：

Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.

Archifyの独自性#

インテリジェントなレイアウト#

汎用の自動レイアウトではなく、AIが階層、間隔、ルート、強調を選択します。エンドポイントは1つのミッドポイントに矢印が重なるのではなく、決定的に分散します。

型付きJSON IR#

すべてのレンダーバックモードにはスキーマと再現可能なソースがあります。任意の図をdiff、検証、再現できます。

原子的バリデーション#

配信前にArchifyは5つの検証ステップを実行します：

• スキーマバリデーション
• レイアウトルールチェック
• HTML/SVGレンダリング
• ルートクリアランス
• ラベル間ルートクリアランス

ラストグッドプレビュー#

オプションのデスクトップループがソースを監視し、すべてのゲートを通過した後にのみリフレッシュします。保存が無効な場合、以前の検証済み図が表示されたままになります。

他のツールとの比較#

実際の例#

Use archify to draw this login flow: Browser -> Web App -> API -> JWT validation ->
Redis session lookup -> PostgreSQL fallback. Keep the cache-miss path secondary.

Archifyは以下を含むインタラクティブHTMLファイルを生成します：

• ダーク/ライトテーマ切り替え
• ズームとパン
• ノード検索
• ルートトレーシング
• PNG、SVG、WebMへのエクスポート

まとめ#

Archifyはシステムアーキテクチャのコミュニケーション方法を変革しています。手描きや手動更新の代わりに、AIがコードベースの分析から美しい共有可能な図のレンダリングまですべてを処理します。

[!WARNING] Archifyは現在開発版（v2.16.0-dev.0）です。リポジトリをウォッチして最新情報をお楽しみください。

🔗 リポジトリ: github.com/tt-a1i/archify ↗

参考資料#

• Archify GitHub リポジトリ ↗
• Agent Skills Standard ↗
• Claude Code ドキュメント ↗