AIToday

RepoMap、AIコーディングエージェントに構造図提供

Hacker News9時間前
RepoMap、AIコーディングエージェントに構造図提供

要点

RepoMap は、ソースコードを言語モデルに公開することなく構造を決定論的に解析してコードリポジトリのインタラクティブな構造図を構築する新しいツール。AI コーディングエージェントがより高速に構造について推論でき、トークン使用量を削減できる。インポート、モジュール関係、Git 履歴を抽出し、人間と AI の双方が探索できる編集可能なグラフとしてレンダリングされ、Claude や OpenCode といった AI エージェントと直接連携する。

こういう要約が、毎朝あなたのメールに届きます。

無料で登録 →

3つのポイント

  • 何が起きたか

    AIコーディングエージェント向けツール RepoMap が登場。リポジトリ構造(ディレクトリ階層、インポート、関数シグネチャ、モジュール関係、Git情報)をLLMに送信せずに抽出し、人間とエージェント双方が探索できるインタラクティブな構造図を生成する。

  • なぜ重要か

    現在のコーディングエージェントはファイルを繰り返し開いたりインポートをたどったりしてプロジェクト構造を再構築し、数千トークンを浪費している。RepoMap はこの無駄を排除し、構造表現を一度構築することでトークン消費を削減し、より高速な構造推論を実現しながらソースコードのプライバシーを保護する。

  • 注目点

    RepoMap は OpenCode や Claude といったツールと連携。git clone と npm install でインストール可能で、今後のバージョンではブランチ間の追加・修正・削除ファイルを示す完全な構造差分可視化へと Git 可視化を拡張予定。

詳細

RepoMap はコーディングエージェントにリポジトリ構造の決定論的マップを構築することで「構造認識」を与えるパイプラインツール。対処している問題は明確に定義されている。現代的なコーディングエージェントはプロジェクト構造を非効率的に再構築し、認証がどこで実装されているか、どのモジュールがデータベースに依存しているか、またはコンポーネントがどのように接続されているかといった基本的な質問に答えるためにファイルを繰り返し開いたりインポートをたどったりする。この再構築はセッションごとに発生し、単にリポジトリ理解だけで数千トークンを消費する。

ソリューションは3つのフェーズで動作する。最初に、決定論的アナライザーが LLM を呼び出さずにリポジトリをスキャンし、ディレクトリ階層、インポート、関数シグネチャ、モジュール関係、Git 情報をコンパクトな RawAnalysis に抽出して、ソースコードを公開せずに構造を記述する。次に、LLM はこの構造化解析のみを受け取り、単一の推論ステップを実行して構造ロールを割り当て、構造パターンを識別し、モジュールラベルを改善し、可視化レイアウトを生成する。最後に、RepoMap は結果を React Flow を使用したインタラクティブで編集可能なグラフとしてレンダリング。複数のレイアウト、ブランチベースの編集、ノード検査、ビューポートカリング、永続的なローカルストレージ、および追加・修正・削除ファイルをハイライトしながらコミットを検査したりブランチを閲覧したりできる Git 対応可視化をサポートする。

技術アーキテクチャは4つの主要コンポーネントで構成されている。analyzer.js は LLM 呼び出しなしで決定論的スキャンを実行。index.js はパイプライン—解析、永続化、可視化提供を調整。cli.js はリストおよび open コマンドを提供。visual_src/ は React Flow ベースのインタラクティブレンダラーを含む。RepoGraph 出力フォーマットは、リポジトリ名、推定サイズ、言語、ファイル数およびモジュール数を含むメタデータ、層、モジュール、ファイルをそれらのメタデータで記述するノード配列、インポートと構造関係を強度と信頼度スコアでキャプチャするエッジ配列、および編集と手動追加を格納するオーバーレイセクションを含む JSON 構造。

インストールは簡単。リポジトリをクローンして npm install を実行し、CLI コマンドでローカルリポジトリを解析してインタラクティブマップを提供。スキルは OpenCode と Claude で自動検出される。このツールは Claude や OpenCode のようなコーディングエージェントとの統合を目的として設計されており、エージェントはリポジトリを繰り返し探索する代わりにコンパクトで再利用可能な構造モデルを受け取ることができる。将来のバージョンでは Git 可視化をコミット全体でアーキテクチャがどのように変化するかを示す完全な構造差分可視化へと拡張予定。

背景と解説

RepoMap は、現代的なコーディングエージェントの仕事方法における具体的な非効率性に対処している。現在、エージェントはファイルを開いたりインポートをたどったりフォルダ構造を検査したりしてプロジェクト構造を再構築することに多大な努力を費やしており、この反復的なタスクは決定論的であるにもかかわらずセッションごとに数千トークンを消費する。このツールはリポジトリ構造抽出を構造推論から分離することで解決する。専用アナライザーが LLM を呼び出さずにインポート、モジュール関係、定義を識別し、リポジトリレイアウトをキャプチャするコンパクトな構造表現を生成する。その後、LLM はこの事前計算されたモデルに対して単一の推論ステップで動作し、トークン使用量を大幅に削減しながらより豊かな構造表現を可能にする。

この設計は実用的な洞察を反映している。インポート検索、モジュール発見、定義抽出は言語モデルのインテリジェンスを必要としない決定論的な操作である。この作業を従来のソフトウェアスキャナーにオフロードすることで、RepoMap は LLM のコンテキストウィンドウを実際の構造推論—ロール割り当て、パターン識別、ラベル改善、可視化レイアウト生成に解放する。また、実際のコードが LLM に送信されず、構造メタデータのみが送信されるため、ソースコードのプライバシーを保護する。Claude や OpenCode のような AI エージェントとの統合、および人間の探索とGit対応ブランチ閲覧のためのインタラクティブ可視化により、直近のエージェント効率化とおよび将来の構造差分機能のためのインフラストラクチャとして位置づけられている。

よくある質問

RepoMap はどのようにしてソースコードを LLM に送信しないのか?
RepoMap は決定論的アナライザーを使用してリポジトリをスキャンし、ディレクトリ階層、インポート、関数シグネチャ、モジュール関係、Git 情報のみを抽出して、コンパクトな構造表現を作成する。LLM が受け取るのはこの構造化解析のみであり、実際のソースコードではない。
AI エージェントは RepoMap の出力で何ができるか?
エージェントは、リポジトリを繰り返し探索する代わりに、構造について推論したり可視化したり今後の解析に使用できる、再利用可能なコンパクト構造モデルを受け取る。
RepoMap のインストール方法と使用方法は?
リポジトリをクローンして npm install を実行し、CLI コマンド `node .opencode/skills/repomap/cli.js open my-repo` でローカルリポジトリを解析してインタラクティブマップを提供する。スキルは OpenCode と Claude により自動検出される。

「画像生成」の最新ニュースを、毎朝7時にお届けします

AIが要約して、あなたの選んだトピックだけを1日1通。LINE・Email・Slackで届きます。

登録無料・30秒で完了・いつでも解除できます

ディスカッション

まだコメントがありません。最初のコメントを投稿しましょう!

ログインして議論に参加

関連記事

AIニュースを毎日お届け

200以上のソースから厳選したAIニュースを毎日無料でお届けします。

無料で始める

登録無料・30秒で完了・いつでも解除できます

毎朝1分、AIの要点だけ。

200媒体以上・Email/LINE/Slack 対応

無料で受け取る →