Compare commits

...

2 Commits

Author SHA1 Message Date
Jesse Vincent
84cd6e7c20 fix: move scope assessment into understanding phase
Testing showed the model skipped scope assessment when it was a
separate step after "Understanding the idea." Inlining it as the
first thing in understanding ensures it fires before detailed questions.
2026-02-08 16:50:33 -08:00
Jesse Vincent
eac29a909f feat: add project-level scope assessment to brainstorming pipeline
Brainstorming now assesses whether a project is too large for a single
spec and helps decompose into sub-projects. Spec reviewer checks scope.
Writing-plans has a backstop if brainstorming missed it.
2026-02-08 16:50:33 -08:00
3 changed files with 8 additions and 1 deletions

View File

@@ -13,7 +13,9 @@ Start by understanding the current project context, then ask questions one at a
**Understanding the idea:** **Understanding the idea:**
- Check out the current project state first (files, docs, recent commits) - Check out the current project state first (files, docs, recent commits)
- Ask questions one at a time to refine the idea - Before asking detailed questions, assess scope: if the request describes multiple independent subsystems (e.g., "build a platform with chat, file storage, billing, and analytics"), flag this immediately. Don't spend questions refining details of a project that needs to be decomposed first.
- If the project is too large for a single spec, help the user decompose into sub-projects: what are the independent pieces, how do they relate, what order should they be built? Then brainstorm the first sub-project through the normal design flow. Each sub-project gets its own spec → plan → implementation cycle.
- For appropriately-scoped projects, ask questions one at a time to refine the idea
- Prefer multiple choice questions when possible, but open-ended is fine too - Prefer multiple choice questions when possible, but open-ended is fine too
- Only one question per message - if a topic needs more exploration, break it into multiple questions - Only one question per message - if a topic needs more exploration, break it into multiple questions
- Focus on understanding: purpose, constraints, success criteria - Focus on understanding: purpose, constraints, success criteria

View File

@@ -23,6 +23,7 @@ Task tool (general-purpose):
| Consistency | Internal contradictions, conflicting requirements | | Consistency | Internal contradictions, conflicting requirements |
| Clarity | Ambiguous requirements | | Clarity | Ambiguous requirements |
| YAGNI | Unrequested features, over-engineering | | YAGNI | Unrequested features, over-engineering |
| Scope | Focused enough for a single plan — not covering multiple independent subsystems |
| Architecture | Units with clear boundaries, well-defined interfaces, independently understandable and testable | | Architecture | Units with clear boundaries, well-defined interfaces, independently understandable and testable |
## CRITICAL ## CRITICAL

View File

@@ -18,6 +18,10 @@ Assume they are a skilled developer, but know almost nothing about our toolset o
**Save plans to:** `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md` **Save plans to:** `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md`
- (User preferences for plan location override this default) - (User preferences for plan location override this default)
## Scope Check
If the spec covers multiple independent subsystems, it should have been broken into sub-project specs during brainstorming. If it wasn't, suggest breaking this into separate plans — one per subsystem. Each plan should produce working, testable software on its own.
## File Structure ## File Structure
Before defining tasks, map out which files will be created or modified and what each one is responsible for. This is where decomposition decisions get locked in. Before defining tasks, map out which files will be created or modified and what each one is responsible for. This is where decomposition decisions get locked in.