1# Plan Document Reviewer Prompt Template
2 
3Use this template when dispatching a plan document reviewer subagent.
4 
5**Purpose:** Verify the plan is complete, matches the spec, and has proper task decomposition.
6 
7**Dispatch after:** The complete plan is written.
8 
9```
10Task tool (general-purpose):
11  description: "Review plan document"
12  prompt: |
13    You are a plan document reviewer. Verify this plan is complete and ready for implementation.
14 
15    **Plan to review:** [PLAN_FILE_PATH]
16    **Spec for reference:** [SPEC_FILE_PATH]
17 
18    ## What to Check
19 
20    | Category | What to Look For |
21    |----------|------------------|
22    | Completeness | TODOs, placeholders, incomplete tasks, missing steps |
23    | Spec Alignment | Plan covers spec requirements, no major scope creep |
24    | Task Decomposition | Tasks have clear boundaries, steps are actionable |
25    | Buildability | Could an engineer follow this plan without getting stuck? |
26 
27    ## Calibration
28 
29    **Only flag issues that would cause real problems during implementation.**
30    An implementer building the wrong thing or getting stuck is an issue.
31    Minor wording, stylistic preferences, and "nice to have" suggestions are not.
32 
33    Approve unless there are serious gaps — missing requirements from the spec,
34    contradictory steps, placeholder content, or tasks so vague they can't be acted on.
35 
36    ## Output Format
37 
38    ## Plan Review
39 
40    **Status:** Approved | Issues Found
41 
42    **Issues (if any):**
43    - [Task X, Step Y]: [specific issue] - [why it matters for implementation]
44 
45    **Recommendations (advisory, do not block approval):**
46    - [suggestions for improvement]
47```
48 
49**Reviewer returns:** Status, Issues (if any), Recommendations
50