JordanCoin/codemap

解決する課題

コードエージェントは、通常、個々のファイルのテキストしか見ることができないため、コードベース内の構造的関係を理解するのが困難です。特定のファイルに依存しているファイルがどれか、変更の「爆発半径」はどれくらいか、またビルドシステムのルール（go.mod や tsconfig のエイリアスなど）がインポートにどのように影響するかを簡単に把握できません。codemap は、エージェントが手動でスキャンすることなく、依存関係やプロジェクトの構造を正確に理解できる構造的「真実」を提供します。

動作方法

codemap は、単純な文字列マッチングではなく、エコシステム固有のルールを使ってリポジトリを分析します。Rust 用の cargo metadata、Go 用の go.mod、JS/TS 用の package.json などのビルドツールと統合し、インポートを正確に解決します。21 言語にわたる一般的なインポート抽出には ast-grep を使用します。信頼性を確保するために、「カバレッジ契約」を実装しており、依存関係を解決できない場合は明示的に報告するため、エージェントが部分的なグラフを完全なものと誤認するのを防ぎます。

対象ユーザー

AI コードエージェント（Claude Code や Codex など）を使用する開発者向けです。プロジェクトのアーキテクチャや依存関係の流れについて、より深い構造的理解を持つエージェントが必要な場合に最適です。

主な特徴

• ビルドシステム対応の解決: Go、Rust、JS/TS、Dart/Flutter における実際のエコシステムルールに基づいてインポートを解決。
• 爆発半径分析: 「ハブファイル」（頻繁にインポートされるファイル）を素早く特定し、変更によって影響を受ける対象を正確に把握。
• エージェント統合: 19 のツールを備えた MCP サーバー、自動コンテキスト用のセッションフック、機械可読なプロジェクトインテリジェンス用のコンテキストプロトコルを提供。
• エージェント間連携: どのエージェントがどのファイルを編集したかを追跡し、異なる AI ツール間を切り替えてもスムーズに継続可能。
• リモート分析: ローカルの完全なクローンを必要とせずに、公開されている GitHub や GitLab リポジトリを分析可能。