feat(quick-dev): experimental combined execution mode (WIP)

[alexeyv]

Draft / WIP — pushed for visibility and review. Not ready to merge.

Summary

• Adds quick-dev as an experimental alternate child step alongside the existing split create/dev/auto/review flow. A single Quick Dev child session handles planning, coding, test generation, and review; Automator still verifies the story/sprint-status done gate before commit.
• Threads a new overrides.executionMode (split | quick-dev) through preflight, the state document template, and the Story Progress table (adds a quick-dev column).
• Wires the new step into agent resolution (orchestrator.py, orchestrator_epic_agents.py, agent_config.py), runtime policy validation, and orchestration policy (data/orchestration-policy.json) with review_completion as the success verifier.
• Adds the data/prompts/quick-dev.md prompt template and data/parse/quick-dev.json parse schema.
• Updates step-03-execute.md with a Quick Dev branch that bypasses sections A/B when the mode is active, and makes step-03a / step-03b row updates execution-mode aware.
• Updates docs (README, cli-reference, scripts-reference, workflow-commands), the smoke test, and unit tests (test_agent_config_model, test_runtime_policy, test_success_verifiers) to cover the new mode.

This does not replace the main automator loop — quick-dev is strictly opt-in via the executionMode override and a bmad-quick-dev skill must be installed.

Motivation: in local trials the combined Quick Dev session has been roughly 2x faster and used about half the tokens of the split flow. Once it has soaked in, it may become the default, but for now it ships side-by-side.

Status / known gaps

• Branch is intentionally WIP — needs review and likely further refinement before this could be considered for default-on.
• The bmad-quick-dev skill itself is upstream of this repo; this PR only adds the Automator-side integration.

Test plan

• Touched unit tests pass: PYTHONPATH=skills/bmad-story-automator/src python -m unittest tests.test_agent_config_model tests.test_runtime_policy tests.test_success_verifiers (currently 122 tests OK locally)
• Full scripts/smoke-test.sh run with a bmad-quick-dev skill installed
• End-to-end orchestrator run on a real story with overrides.executionMode: quick-dev
• End-to-end orchestrator run with the default split mode to confirm no regression in the existing flow
• Verify Story Progress table renders correctly in both modes (extra quick-dev column)

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e43b6733-f5e7-4ca8-adbf-499785a7375f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}