/sprint-plan

name: sprint-plan
description: "New or updated sprint plan from the current milestone, completed work, and available capacity."
argument-hint: "[new|update|status] [--review full|lean|solo]"
user-invocable: true
allowed-tools: Read, Glob, Grep, Write, Edit, Agent, AskUserQuestion, Bash(bash "*/.claude/skills/sprint-plan/../../hooks/yaml-helper.sh" resolve_config *), Bash(ls production/sprints/*)
model: sonnet

!`bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys review_mode,automation,story_granularity,workflow`

Resolved above — use as-is; `--review` overrides `review_mode`. No block → defaults in `.claude/docs/config-resolution.md`.

Sprint Plan

Existing Sprints

!`ls production/sprints/ 2>/dev/null || echo "(no production/sprints/ directory yet)"`

Resolved before this skill runs — use it to identify the previous sprint in Phase 1 rather than re-globbing.

---

Phase 0: Parse Arguments

Extract the mode argument (`new`, `update`, or `status`).

See `.claude/docs/director-gates.md` for the full check pattern. Individual gate definitions live in `.claude/docs/director-gates/[gate-id].md` — the spawned agent reads its own gate file; do not read it in the parent session.

Every `AskUserQuestion` call follows `.claude/docs/automation-modes.md` (collaborative asks always · guided major-only · autonomous logs and proceeds; `automation_always_ask` categories always prompt).

**`story_granularity`** — it sets how many stories to allocate per sprint, scaled by velocity: **2–4** at `coarse` (the default, via `rigor: minimal`), **6–10** at `balanced` (`rigor: standard`), **15–25** at `fine`. A Ready backlog smaller than the range is planned whole — never padded with invented stories.

**Review mode check** (before gates run):

• Use the review mode from the resolved block above (`--review` overrides it

for this run) — do not re-resolve it, and do not ask for it. With nothing configured it follows `modes.rigor`: `solo` at `minimal`, `lean` at `standard`.

• **Never write a review mode** — not to `project.yaml`, not to

`production/review-mode.txt`. `modes.review_mode` is one of the knobs `modes.rigor` fronts: pinning it in `project.yaml` shadows the rigor expansion, and the legacy file sits *above* that expansion, so either write would freeze director-review depth for good. `--review` covers a one-off. If the user wants a different depth to persist, point them to changing `modes.rigor` (`/project-settings modes.rigor=<minimal|standard|full>`), or to pinning it on purpose with `/project-settings --local modes.review_mode=<full|lean|solo>` (a personal override in `project.local.yaml`).

---

Phase 1: Gather Context

1. **Read the current milestone** from `production/milestones/` **if it exists**. No skill writes this directory — it is authored by hand from `.claude/docs/templates/milestone-definition.md`. On the majority of projects it is absent, which is the normal state, not a gap: note "no milestone defined — planning against the story backlog alone" and continue. Never block sprint planning on it, and never infer a milestone from the sprint files.

2. **Read the previous sprint** (if any) from `production/sprints/` to understand velocity and carryover. In `new` mode:

• The new sprint's number `[N]` is the highest `sprint-NNN.md` in the

Existing Sprints listing plus one (`001` when there is none). It is the `[N]` in the plan's title, its QA plan path and the write ask.

• Every story of the previous sprint that is not `Complete` — by its status

in `production/sprint-status.yaml`, else its story file's Status line — goes in the Carryover table with a Reason and a New Estimate. It appears only there, never again as new Must Have / Should Have / Nice to Have work.

3. **Find the stories to plan** — this is the actual backlog, and it is the one input this phase cannot do without:

   Glob production/epics/**/story-*.md
   Grep pattern="^> \*\*Status\*\*" glob="production/epics/**/story-*.md" output_mode="content"

Stories live at `production/epics/[epic-slug]/story-NNN-[slug].md` — that is where `/create-stories` writes them and where `/dev-story` looks for them. Plan from the ones marked `Ready`. Use the grep rather than reading each story: at this stage you need status and title, not the body.

If the glob returns nothing: "No stories found under `production/epics/`. Run `/create-stories` first (at `standard`/`full`, `/create-epics` before it)." Do not proceed to invent work items — a sprint plan that references stories which do not exist cannot be implemented. Verdict: **BLOCKED** — no stories to plan.

4. **Scan design documents** in `design/gdd/` for additional context on the features those stories implement. Read each by section: find the headings you need with the Grep tool (pattern `^#`, content mode) and Read those ranges with offset and limit. At `workflow: minimal` there are no per-system GDDs — use `design/game-brief.md` instead, and do not treat the absent GDDs as missing work. (Note: `/sprint-plan` is **optional** at `minimal` — the brief's Build order already is the plan.)

5. **Check the risk register** at `production/risk-register/` **if it exists**. Like the milestone above, no skill writes it — entries are authored by hand from `.claude/docs/templates/risk-register-entry.md`. If the directory is absent, say so once ("no risk register — risks assessed from the sprint contents only") rather than skipping risk assessment silently.

---

Phase 2: Generate Output

For `new`:

**Generate a sprint plan** following this format and present it to the user. Do not ask to write yet — the gate phases run first and may require revisions before the file is written: the producer feasibility gate (Phase 4, spawned only in `full` review mode — skipped in `lean`/`solo`) and the QA plan check (Phase 5, all modes).