inkboard/system-atlas

何を解決するか

System Atlas は、古くなりがちな静的なアーキテクチャ図の問題を解決します。手動で描かれた図はすぐに「嘘」になってしまうため、単一の真実の源（データファイル）を使用して、インタラクティブな等軸図マップと詳細なテキストベースのドキュメントファイル（SYSTEM.md）を生成することで、視覚的表現と文章による記述が常に同期された状態を保ちます。

動作方法

このツールはシンプルなビルドパイプラインで動作します：ユーザーまたはAIエージェントが、システムの構造、フロー、意思決定を含む data.mjs ファイルを編集します。その後、ビルドスクリプト（build.mjs）がこのデータをテンプレートに処理し、以下の2つの出力を生成します：

1. インタラクティブなHTMLマップ：自己完結型の等軸図可視化で、構造にマウスオーバーすると情報が表示され、クリックで実行ステップを確認でき、データパケットがコンポーネント間を移動する様子を視覚化できます。
2. テキストの双子：決定テーブル、フローテーブル、オープンな質問の追跡インデックスを含む SYSTEM.md ファイル。

対象ユーザー

複雑なシステム設計を他者に伝える必要がある開発者やアーキテクト、およびリポジトリの変更に基づいてパイプラインのマッピングやアーキテクチャドキュメントの更新を自動化できるAIエージェント（skills CLI経由）向けに設計されています。

特徴

• 段階的公開：システムを「章」に分けて情報過多を防ぎ、構造を段階的に提示します。
• 簡潔な視覚表現：特定の等軸図の形状（ブレイン、ストア、ツールデッキなど）を異なる役割に割り当て、凡例なしでもマップの読み取りが可能になります。
• 検査可能なデータフロー：実際のリクエストを移動するドットとして可視化し、クリックでJSONペイロードを確認できます。
• 安定した質問追跡：オープンな質問に安定したID（例：Q-<code><n>）を割り当て、複数の設計ラウンドにわたってフィードバックや解決状況を追跡できます。
• エージェント対応：AIエージェントが特定の設計言語とプロセスを学べるように、「スキル」として提供され、アトラスの作成・維持を可能にします。