Qiuner/birdview

解決する問題

Birdviewは、AIコーディングエージェントの「ブラックボックス」問題に対処します。この問題では、開発者はAIの推論や変更のアーキテクチャへの影響を理解せずに、最終的なコードの差分のみを確認することがよくあります。実装を開始する前に、エージェントがプロジェクトをマッピングし、影響を受けるモジュールとファイルを宣言することを強制することで、スコープの誤りを防止します。

動作原理

BirdviewはAIエージェント向けのスキルとして機能します。プロセスは2段階で進行します：

1. マッピング: エージェントはソースコードを分析し、モジュール、その責任、および接続方法を記述する architecture.json ファイルを作成します。
2. 実行: タスク実行中、エージェントは計画されたスコープと進捗を activity.jsonl ファイルに記録します。

これらのファイルは検証され、スタンドアロンのインタラクティブなHTMLページにレンダリングされます。このページにより、開発者はシステムマップ、エージェントが変更を予定している特定のファイル、それらの主張を支えるソースのエビデンス、およびエージェントが実行した検証チェックを視覚化できます。

対象ユーザー

AIコーディングエージェント（Claude Code、Codex、DeepSeek Harnessなど）を使用し、AIがコードベースに導入する変更に対してより高い透明性とアーキテクチャ制御を求める開発者向けに設計されています。

ハイライト

• ビジュアルアーキテクチャマッピング: プロジェクト構造をモジュールと関係のインタラクティブなマップに変換します。
• $’$Architecture-as-Code’$ アプローチ: JSONスキーマを使用して、エージェントのシステム理解が構造化され一貫性があることを保証します。
• 実装前検証: AIがコード編集を完了する前に、ユーザーがスコープエラーを検出できるようにします。
• ゼロインフラストラクチャビューア: デプロイされたサーバーを必要とせず、任意のブラウザで開けるスタンドアロンのHTMLファイルを生成します。