tt-a1i/archify

何を解決するか

Archifyは技術的記述や既存のコードベースをインタラクティブで洗練されたシステムマップに変換します。複雑なシステム内のコンポーネント間の実際の関係を追跡できない、静的で一般的な図表の問題を解決します。

動作方法

ArchifyはAIエージェント（Cursor、Claude Code、Codex CLIなど）向けに設計されたレンダリングおよび検証システムです。以下の手順で動作します：

1. 生成：AIエージェントがシステムの記述に基づいて型付きJSON中間表現（IR）を生成します。
2. 検証：バンドルされた検証ルールとレイアウト規則を実行し、JSONソースの正しさとレイアウトの決定論的性を保証します。
3. プレビュー／配信：検証済みJSONを自己完結型のHTML/SVGファイルにコンパイルします。このファイルには、マップを探索し、ルートを追跡し、ガイド付きストーリーを再生できるインタラクティブビューアが含まれます。
4. 反復：構造の安定性を維持しながら、JSONソースを更新することで図を改善できます。

対象ユーザー

AI支援ツールを使ってシステム設計を伝える、マージ前のアーキテクチャ変更のレビュー、または新メンバー向けのコードベースドキュメント作成が必要なソフトウェアアーキテクト、開発者、技術リーダー。

特徴

• 5種類の図形式：アーキテクチャ図、ワークフロー図、シーケンス図、データフローダイアグラム、ライフサイクル図をサポート。
• 決定論的レンダリング：型付きJSON IRを使用して、一般的な自動レイアウトではなく、再現可能で一貫性のあるレイアウトを確保。
• アーキテクチャ差分：2つの検証済みスナップショットを比較し、システムアーキテクチャで何が追加、削除、移動されたかを正確に確認可能。
• インタラクティブな探索：ノード検索、上流／下流の到達範囲の追跡、特定の有向ルートの調査機能を備える。
• ポータブル出力：1つのHTMLファイルを生成し、PNG、SVG、WebM、共有カードとしてエクスポート可能。
• ソースの根拠付け：必要に応じて、アーキテクチャノードをGit検証済みのファイルと行範囲にリンク可能。