code-reading

name: code-reading description: | コードリーディングを3層フレームワーク（取得・処理・管理）で効率的に実行する。 コードの理解、調査、学習を求められた時に使用。複雑なケースではサブエージェント起動を推奨。

Code Reading Expert

核心原則: 実装をむやみに精読しない。インターフェイスと役割の理解に集中し、読む箇所を極小化する。

判断基準: スキル vs サブエージェント

IF 単純なケース（以下すべて該当）:
├─ 対象ファイル: 1-3個
├─ ゴール: 明確（特定の関数の動作確認など）
├─ 依存関係: 浅い
└─ → スキル内で完結（下記フローに従う）

IF 複雑なケース（以下いずれか該当）:
├─ 対象: 複数モジュール跨ぎ
├─ ゴール: 探索的（「どう動いているか全体像を把握」など）
├─ 依存関係: 深い・不明
└─ → サブエージェント（explore）を起動

3層フレームワーク

┌─────────────────────────────────────────────────────────┐
│  Layer 1: 取得 (Acquisition)                            │
│  → どの情報を、どの順序で読むか                           │
├─────────────────────────────────────────────────────────┤
│  Layer 2: 処理 (Processing)                             │
│  → 読んだ情報をどう解釈・判断するか                       │
├─────────────────────────────────────────────────────────┤
│  Layer 3: 管理 (Management)                             │
│  → 理解した情報をどう記録・参照可能にするか               │
└─────────────────────────────────────────────────────────┘

クイックフロー（単純なケース）

Step 1: ゴール定義

Q: 何を達成したいか？
├─ バグ修正      → 問題箇所の特定と原因理解
├─ 機能追加      → 拡張ポイントと依存関係の把握
├─ レビュー      → 設計意図と実装品質の評価
├─ 学習          → パターンと設計思想の吸収
└─ 調査          → 特定の振る舞いの確認

出力: 1文でゴールを明文化（例: 「認証フローでトークン検証がどこで行われるかを特定する」）

Step 2: 境界設定

1. エントリーポイントを1つ特定
2. 直接依存のみを対象範囲に含める
3. 必要になったら拡張（前倒しで広げない）

Step 3: 情報取得（優先順位順）

Step 4: 理解の記録

understanding-record.md のテンプレートを使用

サブエージェント起動テンプレート

複雑なケースでは以下のプロンプトで explore サブエージェントを起動:

【ゴール】
{1文で明文化したゴール}

【対象範囲】
{ディレクトリパスまたはファイルパターン}

【探索の深さ】
{quick / medium / very thorough}

【期待する出力】
- 理解記録テンプレート形式で各モジュールを要約
- 依存関係図（テキストまたはMermaid）
- 発見した重要なパターンやハマりポイント

詳細参照

アンチパターン（避けるべき）