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.mdnew file mode 100644index 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