v3: OSS スキャン → Mechanism 発見 → 抽象的評価 → 適用 0
v4: 我々の Problem → OSS で Decision 逆追跡 → 具体的 Recipe → 適用追跡

1. README.md → 目的、核心機能、使い方
2. マニフェスト → 技術スタック、Primary Language
3. ディレクトリ 1-depth → モジュール境界
4. Import Hotspot → 核心モジュール TOP 5
5. Entry/Extension Points → 拡張点識別

1. CLAUDE.md → プロジェクトルール/制約 → 違反可能性の高い領域
2. .claude/hooks/ + .claude/scripts/ → 現在の自動化レベルとギャップ
3. .claude/skills/ → 現在のスキル能力と限界
4. git log (最近 20 コミット) → 繰り返し作業、回帰パターン
5. Known Issues → TODO, FIXME, HACK 収集

### Problem: {ID} — {Title}

**Statement**: {一文}

**Forces** (衝突する制約):

- **F1**: {制約 1} — Evidence: {根拠}
- **F2**: {制約 2} — Evidence: {根拠}
- _(F1 と F2 がなぜ同時充足が困難か説明)_

**Current State**: {現在どのように (未) 対処しているか}

| Problem | OSS モジュール (仮説) | 根拠 | Phase 2 探索優先順位 |
| ------- | --------------------- | ---- | :------------------: |

### Problem: {Problem IDから参照}

**Forces**:

- **F1**: {制約 1} — Evidence: {OSS コード/ドキュメント根拠}
- **F2**: {制約 2} — Evidence: {OSS コード/ドキュメント根拠}

### Decision: {決定名}

**Chosen**: {選択された方式}
**Why This Way**: {Forces 解決方式の説明}

**Alternatives Considered** (最低 1個):
| 代替案 | 却下理由 | Evidence |
|------|----------|----------|
| {代替案 A} | {Forces の1つを解決できない} | {根拠} |

### Mechanism

- **Symbol**: {関数名/クラス名} ← Primary Identifier
- **Module**: {モジュール名}
- **File**: {ファイルパス}

**Interface**:

- Input: {型/シグネチャ}
- Output: {型/戻り値}

**How It Works**:

1. {ステップ}: {説明} + コードスニペット
2. ...

### Consequences

| タイプ      | 説明           | Evidence |
| ----------- | -------------- | -------- |
| ✅ Positive | {肯定的結果}   | {根拠}   |
| ⚠️ Negative | {否定的結果}   | {根拠}   |
| ↔️ Tradeoff | {トレードオフ} | {根拠}   |

### プロジェクト Relevance

- **Problem Match**: {LK のどの Problem に該当するか}
- **Forces Match**: {F1/F2 が LK でも同一か}
- **Forces Mismatch**: {LK では異なる制約があるか}
- **Adaptation Needed**: {そのまま適用可能 / 変形必要 / 不適合}

| 属性         | OSS ({name}) | プロジェクト            |   Gap   |
| ------------ | ------------ | ------------------------ | :-----: |
| Language     | {言語}       | TypeScript/Next.js             | {H/M/L} |
| Runtime      | {ランタイム} | Mobile (iOS/Android)     | {H/M/L} |
| Architecture | {パターン}   | Feature-First + React Hooks | {H/M/L} |
| Scale        | {規模}       | Solo dev + AI assisted   | {H/M/L} |
| Backend      | {方式}       | Supabase (PostgreSQL)    | {H/M/L} |
| Hook System  | {方式}       | Claude Code Hooks (.mjs) | {H/M/L} |
| Deployment   | {方式}       | App Store releases       | {H/M/L} |

              High Fit      Medium Fit     Low Fit
High Impact │  ADOPT       │  TRIAL        │  ASSESS
Medium      │  TRIAL       │  ASSESS       │  HOLD
Low Impact  │  ASSESS      │  HOLD         │  HOLD

### Recipe: {Decision Name}

**Goal**: {一行の目標}

**Prerequisites**:

- {事前条件 1}
- {事前条件 2}

**Adaptation Notes**:

- {OSS と LK の差異に基づく変形事項}

**Steps** (Pseudocode):

1. {ステップ}: {説明}
   ```pseudo
   {擬似コード}
   ```

**成果物**: `adoption.md` (テンプレート: `templates/adoption.template.md`)

---

## Output Specification

### 成果物: 3個

### カタログ: docs/oss/_catalog/catalog.json

```json
{
  "schema_version": "4.0",
  "description": "OSS Problem-Decision-Recipe Catalog",
  "last_updated": "ISO date",
  "entries": [
    {
      "id": "{kebab-case-id}",
      "problem": {
        "id": "{problem-id}",
        "title": "{問題タイトル}",
        "forces": ["{Force 1 要約}", "{Force 2 要約}"]
      },
      "decision": {
        "name": "{Decision 名}",
        "chosen": "{選択された方式}",
        "adoption": "adopt | trial | assess | hold",
        "context_fit": "high | medium | low",
        "impact": "high | medium | low"
      },
      "recipe": {
        "id": "{recipe-id または null}",
        "exists": true | false,
        "complexity": "low | medium | high"
      },
      "source": {
        "oss": "{oss-name}",
        "module": "{module-name}",
        "symbol": "{function/class name}",
        "file": "{relative path}"
      },
      "follow_up": {
        "status": "pending | in_progress | done | abandoned",
        "implemented_at": "{ファイルパスまたは null}",
        "implementation_path": "{実装パスまたは null}",
        "note": "{任意メモ}"
      },
      "analysis_path": "docs/oss/{oss}/v4/decisions.md#{anchor}",
      "analyzed_at": "{ISO date}"
    }
  ]
}

# 基本分析
/oss-analyzer --source {oss-sources-path}

# 特定の問題に集中
/oss-analyzer --source {path} --problem {problem-id}

# 特定領域に集中
/oss-analyzer --source {path} --focus {area}

# OSS スキャンのみ (Problem Discovery 省略)
/oss-analyzer --source {path} --oss-only

# キャッシュ無視で再分析
/oss-analyzer --source {path} --force