cartographer は何をしますか？
エージェントファーストのコード理解システム — コードベースの永続的で証拠に基づいたワールドモデルを構築します。
概要
miltonian/cartographer は、AIエージェントがコードベースを深く理解するための基盤を提供します。このスキルは、コードベースの構造、型、依存関係、コメントなどをスキャンし、それらを永続的な知識ベース（ワールドモデル）として保存します。保存されたモデルは、エージェントが後続のクエリで利用でき、毎回コードベース全体を再スキャンする必要がなくなります。
主な機能
- 永続的なワールドモデル: コードベースの解析結果を一度保存し、エージェント間で共有可能。
- 証拠に基づく解析: 抽象的な推測ではなく、コード内の具体的な定義、参照、型情報に基づいてモデルを構築。
- エージェントファースト設計: Claude Code、Cursor、Codexなどのエージェントツールと直接連携。
- 効率的なクエリ: モデルへのクエリは、コードベースの再スキャンよりも高速で、トークン消費を低減。
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他AIコードエージェント（標準的な入出力形式に対応）
使用方法
- 初期化: プロジェクトのルートでスキルを初期化します。
cartographer init - モデル構築: コードベースをスキャンしてワールドモデルを構築します。
cartographer build - クエリ実行: 構築されたモデルに対して質問を投げます。
cartographer query "関数 X のすべての呼び出し元を列挙してください"
環境変数
CARTOGRAPHER_ENABLE_DEBUG: デバッグログを有効にするにはtrueを設定。CARTOGRAPHER_MODEL_PATH: ワールドモデルの保存先パス（デフォルト:.cartographer/model）。
アーキテクチャ
cartographer は3つの主要コンポーネントから構成されます：
- スキャナー: コードベースを走査し、ファイル、型、依存関係を抽出。
- モデルビルダー: 抽出された情報をグラフ構造に変換し、永続化。
- クエリエンジン: グラフ構造に対して自然言語または構造化クエリを実行。
制限事項
- 大規模リポジトリでは初期ビルドに時間がかかる場合があります。
- 動的言語（Python、JavaScript）の型推論は完全ではありません。
- バイナリファイルは解析対象外です。
ライセンス
MIT