Skip to content

Commit f93790c

Browse files
committed
feat: add explicit 'What NOT to Do' section to generate-spec
Restores and enhances the guidance from original 'Final instructions' section that was integrated during restructuring. New section explicitly lists 8 forbidden actions: 1. Do NOT implement the spec (workflow creates specs only) 2. Do NOT skip clarifying questions (Phase 2 is mandatory) 3. Do NOT make technical decisions without evidence 4. Do NOT write specs in isolation (check context first) 5. Do NOT proceed without user validation (respect STOP points) 6. Do NOT include implementation details (focus on WHAT/WHY) 7. Do NOT assume requirements (ask when unclear) 8. Do NOT continue after spec approved (workflow ends) This makes boundaries crystal clear and prevents common errors where AI agents might: - Jump straight to implementation - Skip clarifying questions when prompt seems clear - Make technology choices without checking existing patterns - Batch all questions instead of iterative dialog - Continue past approval into task breakdown Addresses user feedback about missing 'do not do' clarity.
1 parent 02ff6fb commit f93790c

File tree

1 file changed

+44
-0
lines changed

1 file changed

+44
-0
lines changed

prompts/generate-spec.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -181,6 +181,50 @@ Assume the primary reader of the Spec is a **junior developer**. Therefore, requ
181181
5. **Explicit unknowns:** Flag gaps in knowledge rather than guessing
182182
6. **Stop when complete:** Once spec is approved, workflow is done
183183

184+
## What NOT to Do
185+
186+
**Explicitly forbidden actions:**
187+
188+
1. **❌ Do NOT start implementing the spec**
189+
- This prompt creates specifications only
190+
- Implementation happens in a separate workflow
191+
- Stop after Phase 5 - do not write code
192+
193+
2. **❌ Do NOT skip clarifying questions**
194+
- Even if the request seems clear, ask questions
195+
- Phase 2 is mandatory, not optional
196+
- Better to over-clarify than make assumptions
197+
198+
3. **❌ Do NOT make technical decisions without evidence**
199+
- Don't suggest technologies without checking codebase-context
200+
- Don't recommend patterns that don't exist in the codebase
201+
- Always cite existing code or docs when suggesting approaches
202+
203+
4. **❌ Do NOT write specs in isolation**
204+
- Check for codebase-context document first
205+
- Check for related existing specs
206+
- Ask user about integration with existing features
207+
208+
5. **❌ Do NOT proceed without user validation**
209+
- Stop at every ⛔ checkpoint
210+
- Wait for user answers before continuing
211+
- Don't batch all questions at once
212+
213+
6. **❌ Do NOT include implementation details (HOW)**
214+
- Focus on WHAT (features) and WHY (value)
215+
- Leave HOW (implementation) to developers
216+
- Exception: When architectural constraints exist
217+
218+
7. **❌ Do NOT assume requirements**
219+
- If something is unclear, ask
220+
- Flag unknowns explicitly in "Open Questions"
221+
- Mark confidence levels honestly
222+
223+
8. **❌ Do NOT continue after spec is approved**
224+
- Once user says "approved", workflow ends
225+
- Do not start task breakdown
226+
- Do not begin implementation
227+
184228
## Quality Checklist
185229

186230
Before finalizing the spec, verify:

0 commit comments

Comments
 (0)