1. Plan Mode で計画作成
2. ExitPlanMode 実行 → hook によりブロック
3. /validate-plan 実行（このスキル）
   ├─ logic-validator で論理検証
   └─ 必要なら外部レビュー
4. 検証結果に応じた判定:
   ├─ 問題なし/軽微 → 5へ
   ├─ 中程度（修正可能） → 修正して再検証（最大2回）
   └─ 決定的な欠落 → 実装停止、計画再作成
5. 計画ファイルに <!-- validated --> マーカーを追加
6. ExitPlanMode を再実行 → 成功
7. 実装開始

# settings.jsonの plansDirectory 設定に応じた場所を確認
# デフォルト: ~/.claude/plans/ またはプロジェクトの .claude/plans/

ls -lt ~/.claude/plans/*.md 2>/dev/null | head -5
# または
ls -lt .claude/plans/*.md 2>/dev/null | head -5

Read({ file_path: "~/.claude/plans/plan-name.md" })

Task({
  subagent_type: "logic-validator",
  description: "Validate plan logic",
  prompt: `
# 実装計画の論理的整合性検証

[計画ファイルの内容をここに貼り付け]

## 検証ポイント
1. 各ステップの目的と依存関係は明確か
2. 検証なしに成功を仮定していないか
3. エッジケース・失敗シナリオは考慮されているか
4. 必要なファイル確認ステップが含まれているか
5. 根本原因分析なしに症状的修正を提案していないか

## 参考ルール
CLAUDE.md のデバッグガイドライン、タスク完了プロトコルに照らして評価してください。
`
})

# codex-review使用
/codex-review

# 相談内容
「以下の実装計画について、アーキテクチャの観点からレビューしてください。
特に、[具体的な懸念点]について評価をお願いします。

[計画の要約]」

Edit({
  file_path: "/path/to/plan.md",
  old_string: "元のステップ記述",
  new_string: "改善されたステップ記述（検証ポイント追加等）"
})

// 計画ファイルの末尾に追加
Edit({
  file_path: "/path/to/plan.md",
  old_string: "[計画ファイルの最後の行]",
  new_string: "[計画ファイルの最後の行]\n\n<!-- validated -->"
})

// 1つのメッセージで複数Taskを呼び出し
Task({
  subagent_type: "logic-validator",
  description: "Validate plan logic",
  prompt: "..."
})

// 続けて外部レビュー（必要な場合）
/codex-review

# 1. 計画ファイル確認
ls -lt ~/.claude/plans/*.md | head -1
# 出力: ~/.claude/plans/jwt-auth-plan.md

Read({ file_path: "~/.claude/plans/jwt-auth-plan.md" })

# 2. 論理検証
Task({
  subagent_type: "logic-validator",
  description: "Validate JWT auth plan",
  prompt: `
# JWT認証実装計画の検証

[計画内容]

## 検証ポイント
1. JWT生成・検証ロジックの完全性
2. トークン保存・リフレッシュ戦略
3. エラーハンドリングの網羅性
4. セキュリティベストプラクティスの考慮
5. テストステップの妥当性
`
})

# 3. セキュリティ視点でレビュー（認証なので重要）
/codex-review

「JWTベースの認証実装計画について、セキュリティの観点からレビューしてください。
特に以下の点を評価してください：
- トークンの保存方法（httpOnly cookie vs localStorage）
- リフレッシュトークン戦略
- XSS/CSRF対策
- トークン有効期限設定

[計画の要約]」

# 4. 重大な指摘があれば計画を改善
# （例：CSRF対策が不足していた場合）
Edit({
  file_path: "~/.claude/plans/jwt-auth-plan.md",
  old_string: "ステップ5: JWTトークンを生成して返す",
  new_string: `ステップ5: JWTトークンを生成
- トークン生成にはRS256アルゴリズムを使用
- httpOnly, secure, sameSite=strict cookieとして設定
- CSRF対策: ダブルサブミットクッキーパターンを実装
- 検証: トークン生成後、デコードして内容確認`
})

# 5. 問題なしと判定されたら実装開始
# （計画はすでに ~/.claude/plans/ に保存されている）

# 複数の場所を確認
ls -lt ~/.claude/plans/*.md 2>/dev/null
ls -lt .claude/plans/*.md 2>/dev/null

// ❌ Wrong subagent_type
Task({ subagent_type: "logic-validation", ... })

// ✅ Correct
Task({ subagent_type: "logic-validator", ... })

# 基本フロー（ExitPlanMode がブロックされた後）
1. 計画ファイル確認: ls -lt ~/.claude/plans/*.md
2. 読み取り: Read({ file_path: "~/.claude/plans/plan.md" })
3. 論理検証: Task(logic-validator)
4. 外部レビュー（必要なら）: /codex-review
5. 判定:
   - 🚫 決定的な欠落 → 実装停止、計画再作成
   - ⚠️ 中程度 → 改善: Edit({ ... }) → 再検証（最大2回）
   - ✅ 問題なし → 6へ
6. 検証完了マーカーを追加:
   Edit({ file_path: "plan.md", old_string: "[last line]", new_string: "[last line]\n\n<!-- validated -->" })
7. ExitPlanMode を再実行 → 実装開始

# 検証レベルの選択
- Simple plan → logic-validator のみ
- Medium complexity → + codex-review
- Complex/security-critical → + self-review

# 重要原則
- 決定的な欠落がある状態では、絶対に実装を開始しない
- <!-- validated --> マーカーがないと ExitPlanMode はブロックされる