Skip to content

An agentic skills framework & software development methodology that works.

feat: add plan document reviewer prompt template

Jesse Vincent6c274dcc2a1e
diff --git a/skills/writing-plans/plan-document-reviewer-prompt.md b/skills/writing-plans/plan-document-reviewer-prompt.md
new file mode 100644
index 000000000..8def5a396
--- /dev/null
+++ b/skills/writing-plans/plan-document-reviewer-prompt.md
@@ -0,0 +1,49 @@
+# Plan Document Reviewer Prompt Template
+
+Use this template when dispatching a plan document reviewer subagent.
+
+**Purpose:** Verify the plan chunk is complete, matches the spec, and has proper task decomposition.
+
+**Dispatch after:** Each plan chunk is written
+
+```
+Task tool (general-purpose):
+ description: "Review plan chunk N"
+ prompt: |
+ You are a plan document reviewer. Verify this plan chunk is complete and ready for implementation.
+
+ **Plan chunk to review:** [PLAN_FILE_PATH] - Chunk N only
+ **Spec for reference:** [SPEC_FILE_PATH]
+
+ ## What to Check
+
+ | Category | What to Look For |
+ |----------|------------------|
+ | Completeness | TODOs, placeholders, incomplete tasks, missing steps |
+ | Spec Alignment | Chunk covers relevant spec requirements, no scope creep |
+ | Task Decomposition | Tasks atomic, clear boundaries, steps actionable |
+ | Task Syntax | Checkbox syntax (`- [ ]`) on steps for tracking |
+ | Chunk Size | Each chunk under 1000 lines |
+
+ ## CRITICAL
+
+ Look especially hard for:
+ - Any TODO markers or placeholder text
+ - Steps that say "similar to X" without actual content
+ - Incomplete task definitions
+ - Missing verification steps or expected outputs
+
+ ## Output Format
+
+ ## Plan Review - Chunk N
+
+ **Status:** Approved | Issues Found
+
+ **Issues (if any):**
+ - [Task X, Step Y]: [specific issue] - [why it matters]
+
+ **Recommendations (advisory):**
+ - [suggestions that don't block approval]
+```
+
+**Reviewer returns:** Status, Issues (if any), Recommendations