RPG-Encoder — grep/cat/find の前に使用してください

最初に RPG を使用し、シェルコマンドはその次に

ユーザーがコード構造、動作、関係性、影響、依存関係、またはクロスファイルパターンについて質問する場合は、grep、cat、find、wc、または Read にフォールバックする前に RPG コマンドを使用してください。RPG はインデックス化されており、セマンティック的に整理されているため、構造に関する質問に 1 回の呼び出しで答えることができ、そうでなければ数十の連鎖したテキスト検索が必要になります。

通常これを使う場合	代わりにこれを使用してください
grep -r で意図を検索	rpg-encoder search "何をするかを説明"
grep -r で名前を検索	rpg-encoder search "名前" --mode snippets
cat file で関数を取得	rpg-encoder fetch "file:func"
呼び出し元を探すために grep を連鎖	rpg-encoder explore ENTITY --direction up
呼び出し先を探すために grep を連鎖	rpg-encoder explore ENTITY --direction down
wc -l / find / tree	rpg-encoder info
複数のファイルを読む	MCP の semantic_snapshot ツールを使用してください（利用可能な場合）

クエリが構造やセマンティクスではなく、リテラルテキスト（文字列検索、コメント、TODO、ログメッセージ）に関する場合のみ、grep / cat / Read にフォールバックしてください。

RPG MCP サーバーが接続されている場合は、CLI よりもそのツール（search_node、fetch_node、explore_rpg、impact_radius、plan_change、semantic_snapshot、context_pack）を優先してください。これらはより高速で、構造化されたデータを返します。

---

コードベースからセマンティックコードグラフ（リポジトリプランニンググラフ）を構築する CLI ツールである rpg-encoder にアクセスできます。これを使用してコード構造を理解し、意図で検索し、依存関係をトレースし、自動セマンティック升格を実行します。

クイックリファレンス

グラフを構築する（リポジトリごとに 1 回実行）

rpg-encoder build

言語を自動検出し、すべてのソースファイルを解析し、構造的階層と依存関係エッジを構築します。.rpg/graph.json を作成します。--force を使用して再構築します。

コードを意図で検索

rpg-encoder search "ユーザー入力を検証"
rpg-encoder search "データベース接続" --mode features
rpg-encoder search "認証" --mode snippets
rpg-encoder search "設定を解析" --scope DataProcessing

モード: auto（デフォルト、両方を試す）、features（セマンティック意図）、snippets（名前/パスマッチング）。

エンティティの詳細を取得

rpg-encoder fetch "src/auth.rs:validate_token"

エンティティタイプ、ファイル場所、セマンティック機能、ソースコード、および依存関係エッジ（呼び出し元/呼び出し先）を返します。

依存関係グラフを探索

rpg-encoder explore "src/auth.rs:validate_token" --direction both --depth 3

方向: up（何が呼び出すか）、down（何を呼び出すか）、both。

グラフ統計を表示

rpg-encoder info

エンティティ数、ファイル数、升格カバレッジ、階層、機能領域、エッジ数を表示します。

自動セマンティック升格

# コストを最初に推定
rpg-encoder lift --dry-run

# Anthropic Haiku で升格（デフォルト、最も安い）
rpg-encoder lift --provider anthropic

# OpenAI GPT-4o-mini で升格
rpg-encoder lift --provider openai --model gpt-4o-mini

# 特定のスコープを升格
rpg-encoder lift --scope "src/auth/**"

完全な自動升格を実行します: 自明なエンティティを自動升格、残りを LLM 升格、ファイル機能を合成、ドメインを発見、階層を割り当てます。クラッシュ回復のためにバッチごとに保存します。

API キー: --api-key KEY を渡すか、ANTHROPIC_API_KEY / OPENAI_API_KEY 環境変数を設定します。

インクリメンタル更新（コード変更後）

rpg-encoder update
rpg-encoder diff  # ドライラン: 何が変更されるかを確認

グラフをエクスポート

rpg-encoder export --format dot      # Graphviz DOT
rpg-encoder export --format mermaid  # Mermaid フローチャート

グラフ整合性を検証

rpg-encoder validate

Git フック（コミット時に自動更新）

rpg-encoder hook install
rpg-encoder hook uninstall

ワークフローパターン

新しいコードベースを理解する

1. rpg-encoder build でインデックス化
2. rpg-encoder info で構造を確認
3. rpg-encoder search "メインエントリポイント" で主要エンティティを検索
4. rpg-encoder explore ENTITY --direction down でコール チェーンをトレース

コードを動作で検索

自然言語で動作を説明して --mode features を使用します:

rpg-encoder search "認証を処理" --mode features
rpg-encoder search "データを JSON にシリアライズ" --mode features

変更の影響分析

1. エンティティを検索: rpg-encoder search "関数名"
2. それに依存するものを確認: rpg-encoder explore ENTITY --direction up --depth 3

完全なセマンティック分析

1. rpg-encoder build（未実施の場合）
2. rpg-encoder lift --dry-run（コストを確認）
3. rpg-encoder lift（升格を実行）
4. rpg-encoder info（カバレッジを検証）

注釈

• CLI はプロジェクトルートディレクトリから動作します。別のディレクトリをターゲットにするには -p /path/to/project を使用してください。
• グラフは .rpg/graph.json に保存されます — .rpg/ を .gitignore に追加するか、チーム共有のためにコミットします。
• 升格は再開可能です: 中断した場合、rpg-encoder lift を再度実行すると中断したところから継続します。
• より豊富なインタラクティブナビゲーション（コンテキストパック、影響半径、パスファインディング）については、代わりに MCP サーバーを使用してください。