Compare commits

...

2 Commits

Author SHA1 Message Date
Alex Verkhovsky 14dd13fb0e
Merge cf12697dfb into 04e3dc8f75 2026-02-01 09:51:46 -07:00
Alex Verkhovsky cf12697dfb fix: replace quote delimiters with output-block tags in step-04-review
Double-quote delimiters around multi-line output template blocks are
visually ambiguous to humans (opening quote on one line, closing quote
many lines later) and confuse linters and LLM code reviewers into
filing false issues (see #1434).

A/B tested across 5 models (Opus, Sonnet, Haiku, Codex 5.2, Gemini):
removing quotes entirely causes Haiku to refuse instructions in 1/3
runs, but any explicit block delimiter works equally well. XML-style
output-block tags are the best fit: visually obvious boundaries,
self-documenting, linter-clean, and consistent with existing BMAD
XML tag conventions (step, action, check, template-output).

Relates to #1433
2026-01-29 01:11:48 -07:00
1 changed files with 14 additions and 6 deletions

View File

@ -31,19 +31,25 @@ wipFile: '{implementation_artifacts}/tech-spec-wip.md'
**Present to user:**
"Here's your complete tech-spec. Please review:"
<output-block>
Here's your complete tech-spec. Please review:
</output-block>
[Display the complete spec content - all sections]
"**Quick Summary:**
<output-block>
**Quick Summary:**
- {task_count} tasks to implement
- {ac_count} acceptance criteria to verify
- {files_count} files to modify"
- {files_count} files to modify
</output-block>
**Present review menu:**
Display: "**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode"
<output-block>
**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode
</output-block>
**HALT and wait for user selection.**
@ -173,7 +179,8 @@ b) **HALT and wait for user selection.**
**When user selects [D]:**
"**All done!** Your tech-spec is ready at:
<output-block>
**All done!** Your tech-spec is ready at:
`{finalFile}`
@ -183,7 +190,8 @@ When you're ready to implement, run:
quick-dev {finalFile}
```
Ship it!"
Ship it!
</output-block>
---