gitnexus-exploring

GitNexus でコードベースを調べる

使用する場面

• 「認証はどのように機能しますか？」
• 「プロジェクトの構成はどうなっていますか？」
• 「主要なコンポーネントを見せてください」
• 「データベースのロジックはどこにありますか？」
• 初めて見るコードを理解するとき

ワークフロー

1. READ gitnexus://repos                          → Discover indexed repos
2. READ gitnexus://repo/{name}/context             → Codebase overview, check staleness
3. gitnexus_query({query: "<what you want to understand>"})  → Find related execution flows
4. gitnexus_context({name: "<symbol>"})            → Deep dive on specific symbol
5. READ gitnexus://repo/{name}/process/{name}      → Trace full execution flow

ステップ 2 で「インデックスが古くなっています」と表示された場合は、ターミナルで npx gitnexus analyze を実行してください。

チェックリスト

- [ ] READ gitnexus://repo/{name}/context
- [ ] gitnexus_query for the concept you want to understand
- [ ] Review returned processes (execution flows)
- [ ] gitnexus_context on key symbols for callers/callees
- [ ] READ process resource for full execution traces
- [ ] Read source files for implementation details

リソース

リソース	得られる情報
gitnexus://repo/{name}/context	統計情報、古さに関する警告（約150トークン）
gitnexus://repo/{name}/clusters	結合度スコア付きのすべての機能領域（約300トークン）
gitnexus://repo/{name}/cluster/{name}	ファイルパス付きの領域メンバー（約500トークン）
gitnexus://repo/{name}/process/{name}	実行トレースの手順（約200トークン）

ツール

gitnexus_query — 概念に関連する実行フローを見つけます。

gitnexus_query({query: "payment processing"})
→ Processes: CheckoutFlow, RefundFlow, WebhookHandler
→ Symbols grouped by flow with file locations

gitnexus_context — シンボルを360度の視点から確認します。

gitnexus_context({name: "validateUser"})
→ Incoming calls: loginHandler, apiMiddleware
→ Outgoing calls: checkToken, getUserById
→ Processes: LoginFlow (step 2/5), TokenRefresh (step 1/3)

例：「決済処理はどのように機能しますか？」

1. READ gitnexus://repo/my-app/context       → 918 symbols, 45 processes
2. gitnexus_query({query: "payment processing"})
   → CheckoutFlow: processPayment → validateCard → chargeStripe
   → RefundFlow: initiateRefund → calculateRefund → processRefund
3. gitnexus_context({name: "processPayment"})
   → Incoming: checkoutHandler, webhookHandler
   → Outgoing: validateCard, chargeStripe, saveTransaction
4. Read src/payments/processor.ts for implementation details