skip to content
日替わり OSS
Table of Contents

リポジトリ

  • tt-a1i/archify
  • 主要言語: HTML / ライセンス: MIT / ★ 18,519

Archifyとは

Archifyは、コードベースやシステム説明から、美しく検証可能なインタラクティブな技術マップを生成する画期的なエージェントスキルです。開発者が手動で作成する構成図やフロー図は、システムの進化とともに陳腐化しやすく、実際のコードとの乖離が生じがちです。Archifyは、この課題に対し、自然言語の指示や既存のコードベースから、常に最新で信頼性の高いシステム図を自動的に生成することで応えます。

生成される成果物は、モーションやダーク/ライトテーマ切り替え機能を含む自己完結型のHTMLファイルであり、PNG、SVG、WebMといった静止画や動画形式でのエクスポートもサポートしています。これにより、システムの設計意図を正確に伝え、チーム内外でのコミュニケーションを大幅に円滑にすることが可能です。Raven、Cursor、Claude Code、Codex CLIといった様々なエージェントと連携し、開発者の日々のワークフローにシームレスに組み込むことができます。

Archifyの主要機能と注目点

1. 多様な図の生成とインタラクティブな可視化

Archifyは、単一の静的な図だけでなく、以下のような様々なタイプの図を生成できます。

  • アーキテクチャ図: システム全体のコンポーネントとそれらの関係性
  • ワークフロー図: ビジネスプロセスやデータフローの流れ
  • シーケンス図: 特定の操作におけるコンポーネント間の相互作用
  • データフロー図: データの入力、処理、出力の流れ
  • ライフサイクル図: オブジェクトやシステムのライフサイクル

これらの図は単なる画像ではなく、以下のインタラクティブな機能を備えています。

  • ノード検索とソースコードへのリンク: 図中の特定のコンポーネントを検索し、関連するソースコードに直接移動できるため、詳細な実装の理解を深めることができます。
  • Upstream/Downstreamの追跡: 特定のコンポーネントが依存している（Upstream）または依存されている（Downstream）関係を視覚的に追跡し、変更の影響範囲を素早く把握できます。
  • Guided Story: あらかじめ定義されたシナリオに沿って、システムの特定のパスや機能を順を追って解説する機能を持ち、複雑なシステムもスムーズに理解できます。
  • プレゼンテーションモードとテーマ: フルスクリーン表示やダーク/ライトテーマの切り替えが可能で、プレゼンテーション資料としても非常に強力です。

2. 変更の検証と差分表示 (Before / Delta / After)

Archifyの最も注目すべき機能の一つは、システム変更時のアーキテクチャの検証と差分表示です。これは、特定のコミット前後のコードベースから図を生成し、以下の形式で比較できることを意味します。

  • Before: 変更前のアーキテクチャ
  • Delta: 変更点（追加、削除、変更、移動、再ルーティングされた要素を正確にハイライト）
  • After: 変更後のアーキテクチャ

この機能は、プルリクエストのレビュープロセスにおいて特に強力です。開発者は、コードの変更がシステムアーキテクチャにどのような影響を与えるかを視覚的に確認でき、設計の意図が正しく実装されているかを容易に検証できます。これにより、設計レビューの品質を向上させ、潜在的な問題を早期に発見し、手戻りを大幅に削減することが可能です。

3. 高い信頼性と共有性

Archifyは、型付きJSON IR (Intermediate Representation) と決定論的なチェックに基づいて図を生成します。これにより、生成される図の信頼性が高く、常に一貫性のある結果が得られます。 生成された図は、自己完結型のHTMLファイルとして出力されるため、ブラウザがあればどこでも開くことができ、共有も非常に簡単です。また、PNG、SVG、WebM、そしてソーシャルメディア投稿に最適な1200x630ピクセルのシェアカードといった多様な形式でエクスポートできるため、用途に応じて最適な形で情報を共有できます。

なぜArchifyは注目されているのか

Archifyは、現代のソフトウェア開発が抱える複数の課題に対し、革新的なアプローチを提供することで注目を集めています。

  • 設計ドキュメントの自動更新と正確性: 手動によるドキュメント作成・更新の負担を軽減し、常に実際のシステムと同期した正確なアーキテクチャ図を提供します。これにより、「ドキュメントが古い」という問題から解放されます。
  • 開発チームの生産性向上: コードベースから直接図を生成することで、開発者はシステムの全体像や特定の機能の動作を素早く把握できます。特に大規模なモノリスやマイクロサービス環境において、新規参画者のオンボーディングや機能理解にかかる時間を大幅に短縮します。
  • レビュープロセスの効率化と品質向上: 変更差分表示機能は、コードレビューにおける設計変更の検証を劇的に効率化します。視覚的なフィードバックは、レビューアがより深い洞察を得る手助けとなり、システムの健全性を維持する上で不可欠です。
  • コミュニケーションの障壁低減: 開発者、プロダクトマネージャー、テストエンジニア、デザイナーなど、異なる職種間でシステムの理解度に差があることは珍しくありません。Archifyが生成するインタラクティブで視覚的な図は、専門知識の有無にかかわらず、誰もがシステムについて共通認識を持つことを促進し、円滑な議論を可能にします。

どんな現場でArchifyは役立つか

Archifyは、以下のような多岐にわたる開発現場でその真価を発揮します。

  • 大規模なモノリシックアプリケーションの開発: 長年開発され、コンポーネント間の依存関係が複雑化したシステムにおいて、その全体像を明確にし、変更の影響範囲を分析する際に役立ちます。
  • マイクロサービスアーキテクチャの管理: 多数のサービスが連携するマイクロサービス環境では、サービス間のインタラクションやデータフローの可視化が極めて重要です。Archifyは、これらの複雑な関係性を明確にし、ボトルネックや障害点を特定する手助けとなります。
  • 既存システムのレガシー脱却・リファクタリング: 古いシステムのリファクタリングや現代化を進める際、現状のアーキテクチャを正確に把握し、変更計画を立てる上で不可欠なツールとなります。
  • 新規プロジェクトの設計と初期段階: プロジェクトの初期段階で、システムの設計思想や主要コンポーネントを視覚的に定義し、チーム内で合意形成を行うのに役立ちます。
  • 外部パートナーとの連携や顧客への説明: システムの構造や動作を外部のパートナー企業や顧客に説明する際、インタラクティブな図は非常に強力なツールとなります。特に、変化を比較できる機能は、提案の説得力を高めます。
  • CI/CDパイプラインへの組み込み: 自動化されたテストやデプロイの一部として、アーキテクチャ図の自動更新を組み込むことで、ドキュメントの鮮度を常に保つことができます。

導入と利用のヒント

Archifyは、npx skills コマンドを通じて簡単に導入できます。

Terminal window
npx skills add tt-a1i/archify -g

インストール後、連携しているエージェントに対して、自然言語で図の生成を指示します。 例えば、リポジトリのランタイムアーキテクチャ図を作成したい場合、以下のように指示できます。

Use archify to map this repository's runtime architecture.

より質の高い図を得るためには、プロンプトに具体的な要件を含めることが重要です。

  • 「8〜12個の主要コンポーネントを表示してほしい」
  • 「主要なパスを一つ示してほしい」
  • 「外部依存関係と信頼境界を含めてほしい」
  • 「詳細な情報はカードに含め、エッジは増やさないでほしい」

このように、図の粒度や含めるべき要素を明確に指定することで、Archifyはあなたの意図に沿った、より精度の高い図を生成します。

まとめ

Archifyは、コードベースやシステム説明から、検証可能でインタラクティブな技術マップを生成する革新的なエージェントスキルです。設計と実装の乖離という長年の課題に対し、自動化された図生成と変更差分表示という強力な解決策を提供します。これにより、開発の生産性、レビューの品質、そしてチーム内外のコミュニケーションが飛躍的に向上します。

常に最新かつ正確なシステム図が手元にあることで、開発者はより創造的な作業に集中できるようになり、システムの成長とともにドキュメントが陳腐化する心配はなくなります。Archifyは、現代の複雑なソフトウェア開発において、設計ドキュメントのあり方を再定義し、より効率的で信頼性の高い開発プロセスを支援する、まさに未来志向のツールと言えるでしょう。