tldr-router

TLDR スマートルーター

質問を最適な tldr コマンドに割り当てます。適切なレイヤーを選ぶ際に使用してください。

質問 → コマンドのマッピング

「どのようなファイル／関数がありますか？」

tldr tree . --ext .py          # File overview
tldr structure src/ --lang python  # Function/class overview

使用方法： 調査の開始、全体像の把握

「X は何を呼び出しますか／X を呼び出すのは誰ですか？」

tldr context <function> --project . --depth 2
tldr calls src/

使用方法： アーキテクチャの理解、エントリーポイントの特定

「X の複雑さはどの程度ですか？」

tldr cfg <file> <function>

使用方法： リファクタリング候補の特定、難易度の把握

「変数 Y はどこから来ますか？」

tldr dfg <file> <function>

使用方法： デバッグ、データフローの理解

「行 Z に影響するものは何ですか？」

tldr slice <file> <function> <line>

使用方法： 影響分析、安全なリファクタリング

「パターン P を検索する」

tldr search "pattern" src/

使用方法： コードの検索、構造検索

判断ツリー

START
  │
  ├─► "What exists?" ──► tree / structure
  │
  ├─► "How does X connect?" ──► context / calls
  │
  ├─► "Why is X complex?" ──► cfg
  │
  ├─► "Where does Y flow?" ──► dfg
  │
  ├─► "What depends on Z?" ──► slice
  │
  └─► "Find something" ──► search

意図の検出キーワード

意図	キーワード	レイヤー
ナビゲーション	"what", "where", "find", "exists"	tree, structure, search
アーキテクチャ	"calls", "uses", "connects", "depends"	context, calls
複雑さ	"complex", "refactor", "branches", "paths"	cfg
データフロー	"variable", "value", "assigned", "comes from"	dfg
影響	"affects", "changes", "slice", "dependencies"	slice/pdg
デバッグ	"bug", "error", "investigate", "broken"	cfg + dfg + context

自動フック連携

tldr-read-enforcer フックと tldr-context-inject フックは、次の処理を自動的に行います。

1. メッセージから意図を検出する
2. 適切なレイヤーに振り分ける
3. ツール呼び出しにコンテキストを挿入する

これらのコマンドを手動で実行する必要はありません。フックが代わりに実行します。

手動での上書き

フックが提供しなかった特定のレイヤーが必要な場合：

# Force specific analysis
tldr cfg path/to/file.py function_name
tldr dfg path/to/file.py function_name
tldr slice path/to/file.py function_name 42