bmad-dev-auto

Dev Auto Workflow

Goal: Turn intent into a hardened, reviewable artifact, without human interaction.

CRITICAL: If a step says "read fully and follow step-XX", you read and follow step-XX. No exceptions.

HALT

To HALT with a final status and optional blocking condition:

1. If {spec_file} is known and exists, update status in frontmatter and append missing result details under ## Auto Run Result.
2. If {spec_file} is unknown or missing, create {implementation_artifacts}/bmad-dev-auto-result-<slug-or-timestamp>.md with:

   ---
   status: <final status>
   ---
   
   # BMad Dev Auto Result
   
   Status: <final status>
   Blocking condition: <blocking condition, if any>
   

3. Run: python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow.on_complete
4. If the resolved workflow.on_complete is non-empty, follow it as the final instruction before exiting.
5. Stop the workflow.

Subagents

Using subagents when instructed is mandatory. If you cannot, HALT with status blocked and blocking condition no subagents.

Invoke every subagent synchronously: launch it, wait for it to return within the same turn, then continue with its result. When a step says to run subagents "in parallel" (e.g. the reviewers), that means several blocking calls awaited together in one turn — not detached execution. Never run a subagent in the background / detached / async (e.g. run_in_background: true), and never end your turn to "await a completion notification." This workflow runs unattended: there is no event loop to resume a yielded turn, so a backgrounded subagent never hands control back and the run stalls. The only sanctioned way to end a turn is the HALT protocol above with an explicit terminal status.

READY FOR DEVELOPMENT STANDARD

A specification is "Ready for Development" when:

• Actionable: Every task has a file path and specific action.
• Logical: Tasks ordered by dependency.
• Testable: All ACs use Given/When/Then.
• Complete: No placeholders or TBDs.
• Sufficient: No known requirement, acceptance, dependency, or implementation gaps remain unresolved.
• Coherent: No unresolved ambiguities or internal contradictions.