feat(skills): add document-review skill for brainstorm/plan refinement #112
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds the
document-reviewskill for improving brainstorm and plan documents through structured review, plus renames/plan_review→/technical_reviewfor clarity.Changes
New
document-reviewskillA 6-step structured review process for improving document quality:
Key design decisions:
Renamed
/plan_review→/technical_reviewThe old name was confusing because "plan review" sounds like document review. The command actually spawns code-focused agents (DHH, Kieran, Simplicity) that review technical approach and architecture, not document quality.
document-review= document quality (clarity, YAGNI, structure)/technical_review= technical approach (Rails conventions, code patterns, architecture)Updated
/workflows:brainstormPhase 4 handoff now offers "Review and refine" option. After document-review completes, brainstorm.md presents workflow-specific next steps:
/workflows:planwith this document/workflows:plan [document-path]Why "Done for now"? After brainstorming and multiple refinement iterations, the context window can be full of back-and-forth that's no longer needed. "Done for now" lets users start a fresh session for planning with a clean context window, using only the finalized brainstorm document as input.
Updated
/workflows:planPost-generation options now include:
document-reviewskill for document quality passThis complements
/technical_review(option 3) which reviews the technical approach.Updated README.md
document-reviewskill to skills table/plan_review→/technical_reviewin commands tableHow it works
Test plan
/workflows:brainstormand select "Review and refine" at handoff/workflows:planand select "Review and refine"/technical_reviewand verify it still works with new name