## Pre-flight Checklist (feature-pilot)

|   ID   | 項目                                        | 状態 |
| :----: | ------------------------------------------- | :--: |
| PF-001 | 作業タイプ判別完了                          | ---  |
| PF-002 | CONTEXT.json アクセス可能または新規作成可能 | ---  |
| PF-003 | CLAUDE.md ルール確認                        | ---  |
| PF-004 | Tier 判定完了                               | ---  |
| PF-005 | Evidence キャッシュ確認                     | ---  |
| PF-006 | 下位スキル ESP 互換性確認                   | ---  |
| PF-007 | 作業 ID 確定                                | ---  |

**作業タイプ**: [NEW_FEATURE | MODIFY_FEATURE | BUG_FIX | DOCS_ONLY]
**Tier 判定**: [1 | 2 | 3]
**パイプライン**: [該当パイプライン一覧]

---

→ 各項目確認後に本テーブルを再出力 (状態列を ✅/❌ に更新)
→ 全項目 ✅: 実行進行 / 1つでも ❌: 即時中断 + 理由報告

## Post-flight Checklist (feature-pilot)

|   ID    | 項目                                                | 状態 |
| :-----: | --------------------------------------------------- | :--: |
| POF-001 | パイプライン完了または明示的中断                    | ---  |
| POF-002 | CONTEXT.json 最終状態更新                           | ---  |
| POF-003 | QA 検証通過 (pre-quality-gate)                      | ---  |
| POF-004 | 下位スキル Post-flight すべて完了                   | ---  |
| POF-005 | Evidence キャッシュ完了                             | ---  |
| POF-006 | DoD 検証完了 (completion_contract verdict = passed) | ---  |

**最終状態**: [Done | Blocked | AwaitingUser | Failed]
**Evidence キャッシュ**:

- npm_lint: [CACHED until HH:MM | NOT_CACHED]
- npm_test: [CACHED until HH:MM | NOT_CACHED]
- readiness_gate: [CACHED until HH:MM | NOT_CACHED]

---

→ 各項目確認後に本テーブルを再出力 (状態列を ✅/❌ に更新)
→ 全項目 ✅: 完了報告 / 1つでも ❌: 修正後再検証

                          +----------+
                          |   Idle   |
                          +----+-----+
                               | start
                               v
                          +----------+
              +---------->| Briefing |
              |           +----+-----+
              |                | brief_done
              |                v
              |         +--------------+
              |         | SpecDrafting |<--------------+
              |         +------+-------+               |
              |                | spec_done             |
              |                v                       |
              |         +--------------+         +-----+-------+
              |         | UiApproval   |         | SpecUpdating |
              |         +------+-------+         +-----+-------+
              |                | ui_approved           |
              |                v                       | update_done
              |         +--------------+               |
              |         | Implementing |<--------------+
              |         +------+-------+
              |                | impl_done
              |                v
              |         +--------------+
              |         | SyncingStatus|
              |         +------+-------+
              |                | sync_done
              |                v
              |         +-----------+
              |         | Reviewing |
              |         +-----+-----+
              |               | review_pass
              |               v
              |         +----------+
              |         |   Done   |
              |         +----------+
              |
              |  +-----------+
              +--| BugFixing | (from any state)
                 +-----------+

---------- 例外状態 ----------

+-----------------+     +--------------+     +----------+     +----------+
| AwaitingUser    |     |   Blocked    |     |  Failed  |     | Archived |
| (7問上限到達    |     | (質問未解決) |     |(復旧不可)|     |(終了)    |
|  ユーザー待機)  |     |              |     |          |     |          |
+-----------------+     +--------------+     +----------+     +----------+
       ^                      ^
       |                      |
       +----------------------+--- (from any state)

## CONTEXT.json チェック

1. `docs/features/<id>/CONTEXT.json` 存在確認
2. 存在:
   - quick_resume セクションを読み現在状態を即時把握
   - lock.locked 確認 → locked なら警告
   - references.current_focus 確認 → 参照すべき文書を把握
3. 未存在:
   - `docs/_templates/context_template.json` をコピーして新規作成
   - feature_id, title, why, success_criteria を初期化

{
  "execution": {
    "lock": {
      "locked": true,
      "locked_by": "claude-session-20260211-1430",
      "locked_at": "2026-02-11T14:30:00+09:00",
      "lock_expires_at": "2026-02-11T15:00:00+09:00"
    }
  }
}

{
  "history": [
    {
      "at": "2026-02-11T14:35:00+09:00",
      "from_state": "Briefing",
      "to_state": "SpecDrafting",
      "triggered_by": "feature-spec-generator",
      "note": "SPEC-029.md 作成完了"
    }
  ]
}

{
  "decisions": [
    {
      "at": "2026-02-11T15:00:00+09:00",
      "summary": "状態管理にReact Hooksを選択（Zustandの代わり）",
      "rationale": "プロジェクト規模に対して適切な軽量性 + 既存パターンとの一貫性"
    }
  ]
}

{
  "open_questions": [
    {
      "id": "Q1",
      "question": "コード分析結果のキャッシュ期間は?",
      "status": "open",
      "impact": "API設計 + ストレージ設計",
      "resolution": null
    }
  ]
}

## 完了チェックリスト

- [ ] current_state → Done
- [ ] lock.locked → false
- [ ] touched_files リスト最終確認
- [ ] history に完了記録追加

// 各スキルが直接 CONTEXT.json 読取 → 修正 → 保存
Read docs/features/<id>/CONTEXT.json
Edit:
  - quick_resume.current_state → 新状態
  - quick_resume.current_task → 次の作業
  - quick_resume.next_actions → 次のアクション
  - quick_resume.last_updated_at → 現在時刻
  - progress.details.FR-XXXNN → 進行状態更新
  - history[] → 状態遷移記録追加

{
  "quick_resume": {
    "current_state": "SpecDrafting",
    "current_task": "Readiness Gate 検証待ち",
    "next_actions": ["Readiness Gate 実行", "Go 判定時に実装開始"],
    "last_updated_at": "2026-02-11T14:35:00+09:00"
  },
  "progress": {
    "percentage": 10,
    "fr_total": 5,
    "fr_completed": 0,
    "fr_in_progress": 0
  },
  "history": [
    {
      "at": "2026-02-11T14:35:00+09:00",
      "from_state": "Briefing",
      "to_state": "SpecDrafting",
      "triggered_by": "feature-spec-generator",
      "note": "SPEC-029.md 作成完了"
    }
  ]
}

{
  "architecture": {
    "domain_model": {
      "path": "docs/features/029-vocabulary-book/DOMAIN-MODEL.md",
      "bounded_contexts": ["VocabularyManagement"],
      "ubiquitous_language_count": 12,
      "generated_at": "2026-02-11T10:00:00+09:00"
    },
    "adr": null,
    "system_design": null,
    "discovery_gate": {
      "verdict": "Go",
      "verified_at": "2026-02-11T10:30:00+09:00",
      "blocking_count": 0,
      "warning_count": 0
    },
    "tier_applied": "M"
  }
}

{
  "quick_resume": {
    "current_state": "Archived",
    "current_task": "",
    "next_actions": [],
    "last_updated_at": "2026-02-11T16:00:00+09:00"
  },
  "archived_reason": "superseded",
  "archived_ref": "046-vocabulary-book-v2"
}

## Blocked 状態からの復旧

1. `open_questions` 中 status="open" 項目確認
2. ユーザーに質問一覧を提示
3. 回答受信後:
   - status → "resolved"
   - resolution フィールドに回答記録
4. すべての質問が resolved の場合:
   - current_state → previous_state
   - previous_state → null

## Turbo Mode 活性化 (Phase 1)

### 作業一覧

| ID  | 作業                                 | タイプ | ティア |
| --- | ------------------------------------ | ------ | ------ |
| T1  | 既存 Custom Hook パターン検索        | Read   | Haiku  |
| T2  | 関連 API Route 確認                  | Read   | Haiku  |
| T3  | 類似機能テストパターン調査           | Read   | Haiku  |
| T4  | 再利用候補探索 (類似 Component/Hook) | Read   | Haiku  |

### 依存性分析

T1, T2, T3, T4: すべて Read → 独立 → 並列可能

### バッチ構成

バッチ 1 (並列): T1, T2, T3, T4

### 実行

→ 4つの Task を **単一応答で同時呼出**

Task 1: subagent_type="Explore", model="haiku", prompt="src/features/ で Custom Hook パターン検索"
Task 2: subagent_type="Explore", model="haiku", prompt="src/app/api/ で関連 API Route 確認"
Task 3: subagent_type="Explore", model="haiku", prompt="tests/ で類似テストパターン調査"
Task 4: subagent_type="Explore", model="haiku", prompt="src/features/ + src/shared/ で再利用可能な類似 Component/Hook 探索"

→ 4つの結果同時返却 (待機時間 1/4)

## Turbo Mode 活性化 (Step 4)

### 依存性分析 (レイヤー基準)

- TypeScript Type + Zod Schema, API Layer: 独立 → 並列可能
- Custom Hook: Type 必要 → Type 後に実行
- Component: Hook 必要 → Hook 後に実行

### バッチ構成

バッチ 1 (並列): TypeScript Type + Zod Schema, API Layer
バッチ 2 (順次): Custom Hook
バッチ 3 (順次): Component
バッチ 4 (順次): Test (API Test, Hook Test, Component Test)

### 実行

→ バッチ 1: 2つの Sonnet Task 同時呼出
→ バッチ 2-4: 順次実行

if tier == 1 and work_type in ["NEW_FEATURE", "MODIFY_FEATURE"]:
    activate_persistent_mode()

if "最後まで" in user_request or "止めないで" in user_request:
    activate_persistent_mode()

Skill ツール:
- skill: "pre-quality-gate"

→ make q.check 実行 (lint + test + architecture check)
→ 失敗時は修正 → 再実行 (最大 5回)
→ 同一エラー 3回 → 停止

## 作業分類完了

**要求**: [ユーザー要求要約]
**作業タイプ**: NEW_FEATURE
**関連機能**: なし (新規)

### 実行計画

| Step | 状態 | スキル/アクション         | 説明                                                    |
| :--: | :--: | ------------------------- | ------------------------------------------------------- |
|  0   | ---  | `/research-pilot`         | Product Discovery (条件付: リサーチ/妥当性キーワード時) |
|  1   | ---  | `/feature-architect`      | CONTEXT.json 作成                                       |
|  2   | ---  | `/feature-spec-generator` | SPEC.md + Screen 作成                                   |
|  3   | ---  | **Readiness Gate**        | Go/No-Go 検証 (内蔵)                                    |
|  4   | ---  | 実装進行                  | SPEC 基準                                               |
|  5   | ---  | テスト + 品質検証         | lint + test + architecture check                        |

→ 各ステップ完了時に本テーブルを再出力し状態列を ✅/❌/⏭️ に更新
→ 全ステップ ✅/⏭️: 完了 / 1つでも ❌: 中断 + 理由報告

進行しますか?

Phase -1: research-pilot (条件付実行)
        +------------------------------------+
        | 条件: 以下のいずれかに該当する場合     |
        |  - ユーザーが「リサーチ」「妥当性」   |
        |    「調査」「ゼロベース」と言及       |
        |  - ユーザーが /research-pilot 明示呼出|
        |  - Tier XL 判定時に実行提案          |
        |                                    |
        | Skill ツール使用:                    |
        | - skill: "research-pilot"          |
        | - args: "<機能説明>"               |
        |                                    |
        | BUILD 決定時:                       |
        |   → RESEARCH.md 作成               |
        |   → CONTEXT.json research 準備     |
        |   → Phase 0.5 へ進行               |
        |                                    |
        | SKIP/DEFER 決定時:                  |
        |   → RESEARCH.md 記録後パイプライン終了|
        |                                    |
        | キャッシュ: 既存 RESEARCH.md 30日以内 |
        |   → 再実行省略、キャッシュ使用       |
        +------------------------------------+
        v BUILD → Phase 0.5 / SKIP/DEFER → 終了

Phase 0.5: Turbo Mode コンテキスト収集 (自動活性化)
        +------------------------------------+
        | turbo-mode v2.0 自動活性化          |
        |                                    |
        | 作業一覧作成 → 依存性分析 → バッチ構成|
        |                                    |
        | 並列実行 (単一応答で複数 Task):       |
        | - Task 1: 既存パターン検索 [Haiku]   |
        | - Task 2: 関連 API 確認 [Haiku]     |
        | - Task 3: テストパターン調査 [Haiku]  |
        | - Task 4: 再利用候補探索 [Haiku]     |
        |                                    |
        | 予想時間短縮: 60-70%                 |
        +------------------------------------+
        v コンテキスト収集完了 (並列結果マージ)

Step 1: Skill ツールで feature-architect 呼出 - 必須ゲート
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "feature-architect"       |
        | - args: (なし) または "--quick" (Tier 3)|
        |                                    |
        | CONTEXT.json 作成の唯一の責任者     |
        | この段階はスキップ不可               |
        +------------------------------------+
        v CONTEXT.json 作成 (必須)

Step 2: Skill ツールで feature-spec-generator 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "feature-spec-generator"  |
        | - args: "<機能ID>"                 |
        |                                    |
        | 前提条件: CONTEXT.json 必須         |
        | (Step 1 で architect が作成)        |
        +------------------------------------+
        v SPEC.md, screens/*.md 作成

Step 2.5: Skill ツールで ui-approval-gate 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "ui-approval-gate"        |
        | - args: "<機能ID>"                 |
        |                                    |
        | ユーザー承認必須ゲート               |
        | ワイヤーフレーム作成 + レビュー + 承認 |
        | 承認なしでは次段階へ進行不可          |
        +------------------------------------+
        v 承認 → Step 3 / 却下 → Blocked

Step 3: [内蔵] Readiness Gate Protocol 実行
        +------------------------------------+
        | 別途スキル呼出なしで直接検証          |
        | - Phase 1: 上流契約検証              |
        | - Phase 2: 技術契約検証              |
        | - Phase 3: 実装安全性検証            |
        | → 下記「Readiness Gate Protocol」参照|
        +------------------------------------+
        v Go → Step 4 / No-Go → Step 2 へ復帰

Step 4: 実装開始 (Sequential Mode)
        +------------------------------------+
        | turbo-mode v2.0 バッチ並列           |
        | → バッチ 1: Type+Zod+API (並列)     |
        | → バッチ 2: Custom Hook (順次)       |
        | → バッチ 3: Component (順次)         |
        | → バッチ 4: Test (順次)              |
        +------------------------------------+
        v SPEC の FR 順にコード作成 + テスト

Step 4.5: Skill ツールで feature-wiring 呼出 - INTEGRATED
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "feature-wiring"          |
        | - args: "<機能ID>"                 |
        |                                    |
        | データソース連動 + ナビゲーション連結  |
        | 実装完了後に必ず実行                  |
        +------------------------------------+
        v 統合連動完了

Step 4.6: Skill ツールで pre-quality-gate 呼出 (QA サイクル)
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "pre-quality-gate"        |
        |                                    |
        | lint → test → アーキテクチャ検査      |
        | すべての検証通過まで最大 5回繰返し    |
        | 同一エラー 3回 → 停止               |
        | 通過後 Step 5 へ進行                 |
        +------------------------------------+
        v QA サイクル通過

Step 5: Skill ツールで feature-status-sync 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "feature-status-sync"     |
        | - args: "<機能ID>" (省略可)         |
        +------------------------------------+
        v index.md 状態同期

Step 6: Skill ツールで priority-analyzer 呼出 (選択的)
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "priority-analyzer"       |
        | - args: "<機能ID> --apply"         |
        |                                    |
        | 選択的実行条件:                      |
        | - progress 変化 >= 10%              |
        | - または priority.last_updated 14日+|
        +------------------------------------+
        v 優先順位再計算 (CONTEXT.json 更新)

Step 7: Skill ツールで pre-quality-gate 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "pre-quality-gate"        |
        +------------------------------------+
        v 最終品質検証

Step 1: Skill ツールで feature-spec-updater 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "feature-spec-updater"    |
        | - args: "<機能ID>"                 |
        +------------------------------------+
        v 既存 SPEC ロード、変更範囲分析、diff 出力

Step 2: feature-spec-updater 結果確認
        - SPEC 変更事項レビュー
        - 変更履歴追加確認
        - 連鎖影響文書確認
        v

Step 2.5: Skill ツールで ui-approval-gate 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "ui-approval-gate"        |
        | - args: "<機能ID>"                 |
        |                                    |
        | 変更された UI のユーザー承認必須     |
        | ワイヤーフレーム更新 + レビュー       |
        +------------------------------------+
        v 承認 → Step 3 / 却下 → Blocked

Step 3: [内蔵] Readiness Gate Protocol 実行
        +------------------------------------+
        | 別途スキル呼出なしで直接検証          |
        | → 下記「Readiness Gate Protocol」参照|
        +------------------------------------+
        v Go → Step 4 / No-Go → Step 2.5 へ復帰

Step 4: 実装 + テスト (SPEC の修正された FR 基準)
        v

Step 4.5: Skill ツールで feature-wiring 呼出 (必要時) - INTEGRATED
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "feature-wiring"          |
        | - args: "<機能ID>"                 |
        |                                    |
        | 実行条件:                            |
        | - 新規 Hook/画面追加時               |
        | - データ/エントリポイント変更時       |
        +------------------------------------+
        v 統合連動

Step 5: Skill ツールで feature-status-sync 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "feature-status-sync"     |
        | - args: "<機能ID>"                 |
        +------------------------------------+
        v index.md 状態同期

Step 6: Skill ツールで priority-analyzer 呼出 (選択的)
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "priority-analyzer"       |
        | - args: "<機能ID> --apply"         |
        |                                    |
        | 選択的実行条件:                      |
        | - progress 変化 >= 10%              |
        | - または priority.last_updated 14日+|
        +------------------------------------+
        v 優先順位再計算

Step 7: Skill ツールで pre-quality-gate 呼出 (選択)
        v 品質検証

Step 1: Skill ツールで bug-fix 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "bug-fix"                 |
        | - args: "<バグ症状説明>"            |
        +------------------------------------+
        v Phase 1: バグ分析 (症状整理、関連コード探索)
        v Phase 2: 根本原因分析 (仮説樹立、検証)
        v Phase 3: 修正実装 (回帰テスト → コード修正)
        v Phase 4: 検証完了 (全テスト、lint)

Step 2: 修正完了確認
        - 回帰テスト追加確認
        - 全テスト通過確認
        - npm run lint 通過確認
        v

Step 3: (選択) Skill ツールで pre-quality-gate 呼出
        +------------------------------------+
        | Skill ツール使用:                    |
        | - skill: "pre-quality-gate"        |
        +------------------------------------+
        v 最終品質検証 (コミット前)

## 進行状況

**作業**: 001-code-analysis (NEW_FEATURE)

| 段階           |   状態   | 成果物                    |
| -------------- | :------: | ------------------------- |
| CONTEXT 作成   |   Done   | `CONTEXT.json`            |
| SPEC 作成      |   Done   | `SPEC-001.md`, `screens/` |
| Readiness Gate |   Done   | Go 判定                   |
| 実装           |   Done   | FR-00101~00105 完了       |
| 状態同期       | Progress | index.md 更新中           |
| 品質検証       | Pending  | -                         |

### 現在の作業

feature-status-sync: index.md 状態同期中...

cd .claude/skills/feature-pilot/scripts
python validate_spec.py <SPEC_PATH>

# 例
python validate_spec.py docs/features/001-code-analysis/SPEC-001-code-analysis.md

+-------------------------------------------------------------+
| Phase 0: 機械検証 (Automated Validation)                      |
| - validate_spec.py スクリプト実行                              |
| - BLOCKING パターン検査 (プレースホルダー、TODO 等)             |
| - 必須セクション存在検査 (セクション 0, 0.1~0.3, 1, 2, 3, 5)   |
| - FR 完全性検査 (AC、テストパス、実装パス)                      |
|     → Exit 1 なら即座に No-Go (Phase 1-3 進行せず)            |
+-------------------------------------------------------------+
| Phase 1: 上流契約検証 (Upstream Contract)                      |
| - CONTEXT <-> SPEC 整合性 (Why, Constraints, Success)         |
| - BRIEF <-> CONTEXT <-> SPEC Why/Scope/Constraints 整合性     |
| - Manifest 有効性                                             |
+-------------------------------------------------------------+
| Phase 1.5: BRIEF <-> SPEC 追跡性検証 (Traceability)           |
| - BRIEF.md 存在 + Section 0 保存確認                          |
| - User Story → FR マッピングカバレッジ検証                     |
| - BDD Scenario → FR マッピングカバレッジ検証                   |
| - マッピングされた FR の SPEC 内の実在確認                     |
+-------------------------------------------------------------+
| Phase 2: 技術契約検証 (Technical Contract)                     |
| - コア 5 完備チェック                                         |
|   - Target Files (予想パス)                                   |
|   - UI Mapping (画面-機能マッピング)                           |
|   - Verification Strategy (テスト方針)                        |
|   - Cross-Feature Dependencies (依存性)                       |
|   - Failure Handling (エラーシナリオ)                          |
| - SPEC 完全性 (必須セクション存在)                             |
+-------------------------------------------------------------+
| Phase 2.5: Product/UX Readiness                               |
| - 適用判定 (UI がある機能のみ、Backend-only 免除)              |
| - Engagement Design (Hook Model: Trigger→Reward→Investment)   |
| - JTBD Full (Functional + Emotional + Social Job)             |
| - Retention Design (AARRR: Activation, Retention Loop)        |
| - Conversion Design (BJ Fogg MAP + Soft Paywall)              |
| - Competitive Benchmark (競合の類似機能ベンチマーク)           |
|     → Blocking: Aha Moment 未定義, Functional Job 未定義,     |
|       Hard Paywall 検出                                       |
+-------------------------------------------------------------+
| Phase 3: 実装安全性検証 (Implementation Safety)                |
| - Tier 自動判定 (チェックリスト基準)                           |
| - 3 Gate (Breaking Change, Security, Testability)              |
| - 追加検証 (マイグレーション、オフライン)                      |
+-------------------------------------------------------------+

# Readiness Gate 検証結果

> **検証日**: 2026-02-11 14:30
> **対象**: Feature 001 - コード分析機能
> **Tier**: 2 (外部 API 連携)

---

## 最終判定: Go

---

## Phase 1: 上流契約検証 - Pass

| 項目                                       | 状態 |
| ------------------------------------------ | :--: |
| Why 一致 (BRIEF -> CONTEXT.why -> SPEC)    | Pass |
| Scope 一致 (BRIEF -> SPEC Goals/Non-Goals) | Pass |
| Hard Constraints 遵守 (BRIEF -> SPEC)      | Pass |
| Success Contracts カバレッジ               | Pass |

## Phase 1.5: BRIEF <-> SPEC 追跡性検証 - Pass

| 項目                                             | 状態 |
| ------------------------------------------------ | :--: |
| BRIEF.md 存在                                    | Pass |
| Section 0 (Original Request) 保存                | Pass |
| US カバレッジ (全 US → 最低 1つ FR)              | Pass |
| BDD カバレッジ (全 AC → 最低 1つ FR)             | Pass |
| FR 存在確認 (マッピングされた FR が SPEC に存在) | Pass |

> **CONTEXT.json 更新 (Phase 1.5 完了時)**:
>
> - `traceability.validated_at` → 現在時刻 (ISO 8601)
> - `traceability.user_story_to_fr` → Phase 1.5 で検証された US→FR マッピング
> - `traceability.bdd_to_fr` → Phase 1.5 で検証された BDD→FR マッピング
> - `traceability.unmapped_user_stories` → マッピングされなかった US リスト
> - `traceability.unmapped_bdd_scenarios` → マッピングされなかった BDD リスト

---

## Phase 2: 技術契約検証 - Pass

### コア 5 状態

| 要素                 | 状態 |
| -------------------- | :--: |
| Target Files         | Pass |
| UI Mapping           | Pass |
| Verification & Test  | Pass |
| Cross-Feature Impact | Pass |
| Failure Handling     | Pass |

---

## Phase 2.5: Product/UX Readiness - Pass

| 領域                    | 状態 | 備考                                                                |
| ----------------------- | :--: | ------------------------------------------------------------------- |
| Engagement (Hook Model) | Pass | Aha Moment: "初回コード分析で改善提案を受信"                        |
| JTBD Full               | Pass | Functional: コード品質向上, Emotional: 成長実感, Social: スキル証明 |
| Retention (AARRR)       | Pass | 日次学習ループ設計済み                                              |
| Conversion (BJ Fogg)    | Pass | 無料 3回/日 → Soft Paywall                                          |
| Competitive             | Pass | 他サービス対比 AI 駆動インタラクティブ教育で差別化                  |

---

## Phase 3: 実装安全性検証 - Pass

### 3 Gate 結果

| Gate | 質問             | 結果 |
| :--: | ---------------- | :--: |
|  A   | Breaking Change? | Pass |
|  B   | Security Risk?   | Pass |
|  C   | Testable?        | Pass |

---

## 次のステップ

実装を開始します。SPEC の FR 順に進行します。

> **CONTEXT.json 更新 (Go 判定時)**:
>
> - `artifacts.spec_locked_at` → 現在時刻 (ISO 8601)
> - `artifacts.spec_validation.last_run_at` → 現在時刻
> - `artifacts.spec_validation.verdict` → "Go" | "Conditional Go"
> - `artifacts.spec_validation.blocking_count` → 検出された Blocking 件数
> - `artifacts.spec_validation.warning_count` → 検出された Warning 件数

# Readiness Gate 検証結果

> **最終判定**: No-Go

## 失敗事由

- **Phase 2 - Verification & Test**: FR-00103 に AC 欠落
- **Phase 2.5 - Engagement**: Aha Moment 未定義

## 修正指示

1. SPEC-001.md の FR-00103 に受入条件(AC) 追加必要
2. 予想テストシナリオ明示必要
3. BRIEF に Aha Moment 定義追加 → SPEC に反映

## 次のアクション

→ **Step 2 へ復帰**: feature-spec-generator 再実行して SPEC 補完

ユーザー: "コード分析機能を追加して"

ユーザー: "001-code-analysis のコード改善提案ロジックを GPT ベースから Gemini に変更して"

ユーザー: "SPEC まで作って、実装は後で"

7問質問上限到達

未回答項目は推奨案で自動選択されました:

- Q4: オフライン動作 → 「ローカル保存後に同期」 (推奨案)
- Q5: エラー表示 → 「トースト通知」 (推奨案)

仮定事項として記録されました。変更が必要な場合は回答してください。

{
  "autonomy_control": {
    "max_questions_per_session": 7,
    "auto_stop_conditions": [
      "7問質問上限到達",
      "BLOCKING パターン発見",
      "Tier 1 セキュリティ関連作業",
      "DB マイグレーション必要"
    ],
    "current_autonomy_level": "supervised",
    "tier": 2,
    "claude_md_checked": true,
    "claude_md_version": "2026-02-11"
  }
}

## CLAUDE.md チェック (Phase 0 必須)

1. CLAUDE.md ファイル読取
2. autonomy_control.claude_md_checked → true
3. autonomy_control.claude_md_version → `git log -1 --format='%ai' -- CLAUDE.md` の出力 (YYYY-MM-DD 形式)
   - git 未使用環境: ファイル冒頭の `# currentDate` 値、または読取時の現在日付
4. 遵守事項 (Rules to Follow) セクション確認
5. 禁止事項 (MUST NOT) 違反時 → 即座に No-Go

# 自然言語で要求 (推奨)
"ユーザーが提出したコードを分析して教育的な説明を生成する機能が必要"

# 具体的な修正要求
"001-code-analysis でコード分析後の説明テキストの品質を改善"

# バグ修正要求
"Diff表示画面でシンタックスハイライトが動かない問題を修正して"

# リサーチ要求
"競合サービスのコード教育機能を分析して"