Plan Quality Check

---
name: plan-quality-check
description: "計画の不足情報・リスク・暗黙の前提・完了条件・次アクションを軽量に構造化抽出する。Use when: 計画の品質を実装前に確認したい時、Missing Items / Risks / Assumptions / Done Criteria を JSON 化したい時、重い Gate を使わず計画健全性を素早く見える化したい時。"
---

# Plan Quality Check

計画文書（目的・スコープ・成功条件・完了条件）を読み、品質を構造化して
返す軽量 Check の Skill。重い Gate / Agent orchestration / PR review /
QA automation には依存しない（手動実行可能・補助情報）。

## カテゴリ

Design

## 想定 Phase

計画レビュー前後の軽量確認（計画作成直後・実装着手前）

## 役割

3 種の Check を単独または統合（combined）で実行する:

| Check | 目的 | 主出力 |
| --- | --- | --- |
| `plan_check` | 目的・対象・成功条件・スコープの明確さを確認 | score / missing_items / summary |
| `risk_check` | 失敗要因・依存関係・未決事項・暗黙の前提を確認 | risks / assumptions / next_actions |
| `done_check` | 完了条件・検証方法・リリース後確認を確認 | done_criteria / validation_notes |

> 補足: `done_check` は**停止条件（completion / stop condition）**の記述有無を、`risk_check` は**再計画トリガ（前提崩壊・逸脱を検知する定量条件）**の記述有無を確認観点に含める。いずれも汎用観点であり、具体のチェック項目はプロジェクト側テンプレート（例 review-self）で定義する。

> 補足2: high-risk / critical の実装タスクでは **rollback（戻し手順）の記述有無**を `done_check` の確認観点に含める。rollback 欠落は安全側（`needs_clarification`）に倒す。具体項目は review-self テンプレで定義（C1-TODO-RB）。
> 補足3（TASK-0129 / #543）: **Loop 安全制御チェック**を `done_check` / `risk_check` 観点に追加する:
>
> | ID | チェック内容 | 判定 |
> |----|------------|------|
> | C1-LOOP-01 | plan に Stop Condition（停止条件）が記入されているか | 未記入 → `WARN`（high-risk/critical では `FAIL`）|
> | C1-LOOP-02 | plan に Replan Triggers と機械値（閾値）が記入されているか | 未記入 → `WARN`、機械値なし → `WARN`（high-risk/critical では `FAIL`）|
>
> これらは `#544/#551` の Loop 安全制御（Phase1 検出）と連動し、
> C-3 承認不可の strict Gate（Phase2）へ接続する（`docs/ai/review-gate-decision-mapping.md` §5 参照）。

## 入力

- 計画文書（目的 / スコープ / 受入基準 / 完了条件を含むテキスト）
- 任意: 確認したい Check 種別（plan_check / risk_check / done_check / combined）

## 出力

- 結果 JSON（`score`, `decision`, `summary`, `missing_items`, `risks`,
  `assumptions`, `done_criteria`, `next_actions`, 任意 `score_breakdown`,
  `validation_notes`）
- 出力構造はリポジトリ側スキーマ（`schemas/plan-quality-check.schema.json`）
  に準拠させる
- 自由文サマリも併記してよいが、機械処理対象は JSON とする

## Plan Health Score の考え方

0-100。最小内訳: goal_clarity / scope_defined / success_metric /
risks_identified / done_criteria_defined。閾値で助言的に
`ready` / `needs_clarification` / `insufficient` を返す。

## 制約

- 本 Check の `decision` は **助言**であり、人間承認・ゲート判定の
  代替にしない。
- 重い自動実行（PR review / browser QA / pair-agent）を呼び出さない。
- 不足が判定不能なときは安全側（より低い score / needs_clarification）。