# summary

Start a new sprint and record its capacity window.

# description

Appends a sprint start record to `.setup-agents/state/sprints.jsonl` with the
declared sprint id, date range, and capacity in days. Run this before stories
are delivered to anchor the sprint window for velocity calculation.

# flags.sprint.summary

Sprint identifier.

# flags.sprint.description

Unique id for this sprint (e.g. `SP-12`, `2026-Q2-S1`).

# flags.start-date.summary

Sprint start date (YYYY-MM-DD).

# flags.start-date.description

ISO date when the sprint begins. Stories estimated after this date are
associated with the sprint in `workflow sprint close`.

# flags.end-date.summary

Sprint end date (YYYY-MM-DD).

# flags.end-date.description

ISO date when the sprint is expected to close.

# flags.capacity.summary

Team capacity in days.

# flags.capacity.description

Total available developer-days for this sprint. Used as denominator when
computing velocity percentage.

# examples

- Start sprint SP-12 with a two-week window and 10 capacity days:

  <%= config.bin %> <%= command.id %> --sprint SP-12 --start-date 2026-05-05 --end-date 2026-05-16 --capacity 10

# info.created

Sprint started: %s (sprintId=%s start=%s end=%s capacity=%sd)