feat(skills): add document-review skill for brainstorm/plan refinement#112
Merged
kieranklaassen merged 2 commits intoEveryInc:mainfrom Feb 8, 2026
Merged
Conversation
7d666d7 to
5fcccae
Compare
5fcccae to
29b29d8
Compare
Add optional review and refine step to workflows:brainstorm and workflows:plan that checks documents for clarity, completeness, user intent, and YAGNI. - New document-review skill with review questions and evaluation criteria - Brainstorm Phase 4 offers "Review and refine" option - Plan post-generation offers "Review and refine" after technical review - Includes YAGNI-based simplification guidance - Max 2 iteration rounds before suggesting to proceed
29b29d8 to
a17ff11
Compare
kprimdal
added a commit
to primux-dk/laravel-compound-engineering
that referenced
this pull request
Jan 24, 2026
Adds the document-review skill for improving brainstorm and plan documents through structured review, plus renames /plan_review → /technical_review for clarity. Changes: ### New document-review skill A 6-step structured review process for improving document quality: 1. Get the document 2. Assess (surface issues via reflective questions) 3. Evaluate (score against criteria) 4. Identify critical improvement 5. Make changes (auto-fix minor, ask approval for substantive) 6. Offer next action ### Renamed /plan_review → /technical_review The old name was confusing because "plan review" sounds like document review. The command actually spawns code-focused agents that review technical approach and architecture. - document-review = document quality (clarity, YAGNI, structure) - /technical_review = technical approach (Laravel conventions, patterns) ### Updated workflows - /workflows:brainstorm now offers "Review and refine" option - /workflows:plan includes "Review and refine" option - /deepen-plan references updated to /technical_review Note: Please manually delete commands/plan_review.md (blocked by hook) Inspired by EveryInc#112 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
criztiano
pushed a commit
to criztiano/coen
that referenced
this pull request
Feb 10, 2026
EveryInc#112) Add optional review and refine step to workflows:brainstorm and workflows:plan that checks documents for clarity, completeness, user intent, and YAGNI. - New document-review skill with review questions and evaluation criteria - Brainstorm Phase 4 offers "Review and refine" option - Plan post-generation offers "Review and refine" after technical review - Includes YAGNI-based simplification guidance - Max 2 iteration rounds before suggesting to proceed Co-authored-by: Kieran Klaassen <kieranklaassen@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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