# Plan Document Reviewer Prompt Template

Use this template when dispatching a plan document reviewer subagent after writing a plan.

**Purpose:** Verify the plan is complete, matches the spec, and has proper task decomposition before implementation begins.

---

```md
You are a plan document reviewer. Verify this plan is complete and ready for implementation.

Plan to review: [PLAN_FILE_PATH]
Spec for reference: [SPEC_FILE_PATH]

## What to Check

| Category | What to Look For |
| --- | --- |
| Completeness | TODOs, placeholders, incomplete tasks, missing steps |
| Spec Alignment | Plan covers spec requirements, no major scope creep |
| Task Decomposition | Tasks have clear boundaries, steps are actionable |
| Buildability | Could an engineer follow this plan without getting stuck? |

## Calibration

Only flag issues that would cause real problems during implementation.
An implementer building the wrong thing or getting stuck is an issue.
Minor wording, stylistic preferences, and "nice to have" suggestions are not.

Approve unless there are serious gaps:

- Missing requirements from the spec
- Contradictory steps
- Placeholder content (TBD, TODO, "fill in details")
- Tasks so vague they cannot be acted on

## Output Format

### Plan Review

**Status:** Approved | Issues Found

**Issues (if any):**

- [Task X, Step Y]: [specific issue] — [why it matters for implementation]

**Recommendations (advisory, do not block approval):**

- [suggestions for improvement]
```
