codecartographer

CodeCartographerは、AIコーディングエージェントを使用して馴染みのないコードベースを理解し、検証済みで言語非依存の再実装仕様を生成するためのフレームワークです。Pi拡張機能、MCPサーバー、またはMarkdownとYAMLファイルのドロップイン`.codecarto/`テンプレートとして配布されます。 仕組み：「コード」は`.codecarto/`内の構造化MarkdownとYAMLです。`GUIDE.md`はLLMのエントリポイント、`workflow/pipeline.yaml`はフェーズと依存関係を定義し、`workflow/status.yaml`はプロジェクトごとの可変状態を保持し、`workflow/VALIDATE.md`は検証プロトコルを説明します。フェーズはDAGを形成します—契約とプロトコルはアーキテクチャ後に並行実行でき、移植は両方を待ち、再実装仕様は最後です。ホストはアクティブなパイプラインを読み取り、依存関係が完了した次のフェーズを見つけ、そのフェーズの指示をLLMに渡し、出力を検証して、ステータスを進めます。 エビデンスと検証：各フェーズは`.codecarto/findings/`の下に、より小さなテンプレート化されたエビデンスタグ付きアーティファクトを書き込み、後のフェーズは必要な特定の上流ファイルを再読み取りします。発見は、観察された事実、強い推論、移植性の危険、外部動作の主張、または未解決の質問としてタグ付けされます。各フェーズ出力は、各完了基準をPASS、PARTIAL、またはFAILとしてエビデンス付きでマークする`## Validation`テーブルで終わります。検証はそのテーブルを解析し、エビデンス/アクションのペアリングと宣言された二次出力を相互チェックし、FAIL、出力の欠落、または読み取り不能な判定で進行を拒否します。 生成されるアーティファクトには、アーキテクチャマップ、欠陥レポート、欠陥修正トラッカー、動作契約、プロトコルと状態、移植バンドル、モジュール、受け入れシナリオ、既知の未知事項を含む最終再実装仕様が含まれます。 パイプラインのバリエーション：デフォルトは7フェーズのディープ監査実行で、欠陥スキャンを機械的パスと意味的パスに分割します。他のバリエーションには、スカウトファースト（8フェーズ）、フル監査付き（6）、フル（5）、欠陥スキャン（2）、ライト（3）、アーキテクチャのみ（1）、合成（4）があります。バリエーションは、発見や進行を削除せずにその場で切り替えられます。 コンテキストの回復力：会話ではなくファイルシステムが永続メモリです。各フェーズは新しいコンテキストウィンドウを取得し、完了した発見はディスクに保存され、`status.yaml`は進行、未解決の質問、繰り越し項目、パイプライン後のバックログを記録します。Piフェーズのトランスクリプトはファイルバックアップされ、`/resume`、`/tree`、`/export`を通じて利用可能です。フェーズ対応の圧縮サマリーは`.codecarto/scratch/checkpoints/`の下にチェックポイントされます。READMEは、フェーズ内のコンテキスト圧力が排除されるのではなく制限されることを指摘しています。 サーフェスと機能：Pi拡張機能は、スラッシュコマンド、ライブエージェントウィジェット、ファイルバックアップのフェーズセッション、フェーズ完了サマリー、オプトインのLLM誘導シードプロンプト、フェーズごとの使用状況追跡、ツールインターセプト（bashブロック、編集/書き込みは`.codecarto/`に限定）を追加します。MCPサーバーは、他のMCP対応エージェント向けにフェーズプロンプト、検証、実験的なライブラリ公開/リスト/再インデックス操作を公開します。単一ファイルのHTMLダッシュボードは、進行、リンク、使用状況、オプションのナラティブサマリーを集約します。フォワード合成は、製品ビジョンと人間が確認したライブラリ仕様を組み合わせて、来歴バックアップのプロジェクト計画を生成し、ランタイム事前チェックは、マージまたは最終化の前に明示的な人間の確認を必要とします。