パターンを読み込んでいます…
構造を考慮したコードベース検索（Repo Map）
コードに特化した検索で、埋め込みの代わりに（あるいは埋め込みと併用して）プログラム構造を活用する。リポジトリは tree-sitter によって AST、およびシンボルと依存関係のグラフへと解析される。ファイルやシンボルはグラフ中心性でランク付けされ（Aider の PageRank 重み付けタグマップ）、グラフ走査ツールが呼び出し・定義・インポートの各エッジをたどり（AutoCodeRover やコードグラフ系エージェント）、スペクトルベースのフォールトローカライゼーションが失敗したテストから探索範囲を絞り込める。これにより、コーディングエージェントは自身のコンテキストウィンドウをはるかに超える大きさのリポジトリから、最小限で関連性の高いコンテキストを組み立てられる。`graph-rag` とは別物であり、後者のグラフはコードの意味論ではなく文書中のエンティティから構築される。
30秒でわかる概要
- 概要
- コードを AST に解析してシンボルの依存関係グラフを構築し、中心性でファイルと関数をランク付けして、タスクに最も関連するコードだけを取得します。
- 使いどころ
- 埋め込みだけでは構造的な関係を捉えきれない大規模コードベースや、コーディングエージェントが呼び出し連鎖とインポートをたどって文脈を理解する必要がある場合。
- 注意点
- グラフの構築とランク付けは初期コストが高く、解析の間にコード構造が変わるとグラフが古くなり取得漏れが起きます。
このパターンについてAIエキスパートに質問
質問が入力済みの状態でアシスタントが開きます。送信前に内容を確認できます。
構造を考慮したコードベース検索（Repo Map）: 概要
コードに特化した検索で、埋め込みの代わりに（あるいは埋め込みと併用して）プログラム構造を活用する。リポジトリは tree-sitter によって AST、およびシンボルと依存関係のグラフへと解析される。ファイルやシンボルはグラフ中心性でランク付けされ（Aider の PageRank 重み付けタグマップ）、グラフ走査ツールが呼び出し・定義・インポートの各エッジをたどり（AutoCodeRover やコードグラフ系エージェント）、スペクトルベースのフォールトローカライゼーションが失敗したテストから探索範囲を絞り込める。これにより、コーディングエージェントは自身のコンテキストウィンドウをはるかに超える大きさのリポジトリから、最小限で関連性の高いコンテキストを組み立てられる。`graph-rag` とは別物であり、後者のグラフはコードの意味論ではなく文書中のエンティティから構築される。
- Tree-sitter AST parse into a symbol table
- Symbol and dependency graph over call, def, and import edges
- PageRank-style centrality ranking of files and symbols
- Graph-traversal tools over the code graph
- Conversation-mentioned identifiers boosted in ranking
- Optional spectrum-based fault localization from failing tests
The Agent Architect
1つのパターン、1つのトレードオフ、1つの本番障害事例。エージェントシステムを構築する人のための短い週刊ブリーフィング。
週1回のメール、ワンクリックで購読解除できます。アドレスはブリーフィングの送信のみに使用します。
参考文献
このパターンの根拠となる論文、仕様、リポジトリです。
このカタログを作ったエンジニアが担当
エージェント構成をレビューします
このページが扱うのは1つのパターンです。実際のシステムは数十を組み合わせて動き、障害の多くはその繋ぎ目で起きます。カタログの288パターンに照らして設計全体をレビューします。アーキテクチャ、信頼性、評価、コストまで、指摘ごとに対応するパターンを示します。
€750（通常€1,500）・1週間・文書レポートとウォークスルーコール・9月30日まで