Skip to content

Latest commit

 

History

History
144 lines (95 loc) · 4.71 KB

File metadata and controls

144 lines (95 loc) · 4.71 KB

Sprints

Auto-BMAD sprints run each step as a fresh-context task, write progress after every story, and continue through failures where possible.

What Runs Per Story

Quick mode:

Create story -> Develop -> Code review

Full BMM mode:

Create story
-> Adversarial review
-> ATDD
-> Develop
-> Edge-case hunt
-> Code review 1
-> Code review 2
-> Code review 3
-> Trace
-> Test automate

Quick Mode Sprint

/auto-bmad-sprint-quick 1

Lifecycle:

story 1-1 -> story 1-2 -> ... -> retrospective

There is no epic-start phase. Each story runs create, develop, and review. At epic end, a retrospective captures lessons learned and action items.

Full Mode Sprint

/auto-bmad-sprint 1

Lifecycle:

epic-start
-> story 1-1
-> story 1-2
-> ...
-> epic-end

Epic start creates test design. Epic end runs traceability, NFR assessment, test review, retrospective, and project-context refresh.

Failure Handling

If a story crashes, Auto-BMAD retries once. If it still fails, it rolls back to the last checkpoint, logs the failure, and moves to the next story.

Test failures inside a story are not treated as coordinator crashes. The responsible BMAD step should fix them or halt with a blocker.

If story 1-1 fails, dependent stories such as 1-2 and 1-3 may also fail. Independent stories can still complete. Fix the root cause, then rerun the same sprint command.

Resume

Sprints are resumable. Run the same command again, or ask Claude Code to resume. Auto-BMAD reads sprint-status.yaml, skips completed stories, and starts from the next pending item.

Sprint resume after terminal crash

Terminal crashed mid-sprint. Resume picked up at story 1-4; stories 1-1 through 1-3 were already committed and skipped.

Sprint Wizard Resume

The sprint wizard stores its selected multi-epic plan at:

_bmad-output/auto-bmad-artifacts/sprint-plan.yaml

When a plan exists, the wizard should show current epic/story/step, remaining story and task counts, selected steps, and capability warnings before asking whether to resume, skip, rebuild, or cancel.

Use reset when the saved plan is stale or you want to answer the wizard questions again:

$auto-bmad sprint wizard reset

Reset creates timestamped safety files before removing the active plan:

sprint-plan-backup-before-reset-<datetime>.yaml
sprint-plan-archived-<datetime>.yaml

Then it shows the wizard questions again. reset autonomous pre-fills autonomous recommendations but still shows the rebuilt questions and asks before proceeding.

If the plan contains optional/full steps, the wizard checks capability. Quick mode requires only BMAD-METHOD. E2E requires bmad-qa-generate-e2e-tests. Full/TEA steps require _bmad/tea/config.yaml and matching bmad-testarch-* skills.

Progress and Reports

Auto-BMAD writes progress after every story, including:

  • status
  • duration
  • commit hashes
  • failure details
  • report paths

At the end of a sprint, review the sprint report before starting the next epic.

Sprint report

Context Management

The coordinator keeps only pass/fail state and short summaries. Each step gets a fresh context window, so long sprints do not degrade because earlier task output filled the active context.

Duration and Token Comparison

Command Duration Tokens
/auto-bmad-story-quick workload-dependent varies
/auto-bmad-sprint-quick workload-dependent varies by story count
/auto-bmad-story full workload-dependent; slower than quick higher than quick
/auto-bmad-sprint full workload-dependent; slower than quick higher than quick
/auto-bmad-plan workload-dependent varies by input/artifact size

Wall time depends heavily on host throughput, model reasoning effort (low, medium, high, xhigh), test/build runtime, retries, and how much review work is needed. For GPT-5.5 planning, a rough baseline is about 60 output tokens/sec, but full sprint time is usually dominated by tool calls, tests, fixes, and hidden reasoning rather than output streaming alone. Treat any estimate as a rough planning hint, not a promise.

RTK for Token Savings

RTK (Rust Token Killer) is a CLI proxy that filters verbose tool output before it reaches Claude's context window. It can reduce token usage on common dev operations such as git, build, test, lint, and package install commands.

Install:

cargo install rtk-cli
rtk init --global

After setup, commands such as git status, cargo build, and pnpm install are automatically rewritten through RTK filters. Auto-BMAD does not need separate configuration for this.