sprint-start

name	sprint-start
version	2.7.1
description	Pre-sprint checks, feature branch creation, and sprint planning. Ensures clean state, defines sprint goal and scope, creates sprint spec document.
trigger	manual
depends-on	[]
references	[]
disable-model-invocation	true
user-invocable	true
allowed-tools	Read, Glob, Grep, Bash, Edit, Write
argument-hint	[branch-name] [--worktree]

---

sprint-start

Skill metrics: Emit a start event to the activity log:

echo "{\"type\":\"skill\",\"event\":\"start\",\"skill\":\"sprint-start\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" >> docs/sessions/.activity-log.jsonl

Starting a new sprint.

Profile-Adaptive Behavior

Read the **Profile:** line from CLAUDE.md to determine the active project profile.

**Lean mode:** Skip steps 1.5 (Metrics Health Check), 1.6 (Debt Health Check), and step 3 (Sprint Planning ceremony — no sprint spec generation, no story selection, no PRD check). Perform only: 1a-1d (pre-flight checks), step 2 (create feature branch), and update `docs/progress.md` with branch name and sprint number. **Strict mode:** All steps mandatory. Metrics and debt checks must produce actionable output (not just "all clear"). Sprint spec generation is required with explicit quality gate plan section.

1. Pre-flight Checks

Verify the workspace is ready for new work:

1a. Check for open PRs

gh pr list --author @me --state open

If open PRs exist:

• Check if any are approved → merge them: gh pr merge --squash --delete-branch
• If awaiting review → inform user and ask whether to proceed or wait

1b. Verify clean working tree

git status

If uncommitted changes exist:

• Warn user — they must commit, stash, or discard before proceeding
• Do NOT proceed with dirty working tree

1c. Ensure on default branch and up to date

Read the Default branch from CLAUDE.md's Git Workflow section. If not set, detect it at runtime:

# Read from CLAUDE.md first, fall back to detection
DEFAULT_BRANCH=$(grep -oP '^\- \*\*Default branch:\*\* \K\S+' CLAUDE.md 2>/dev/null)
if [ -z "$DEFAULT_BRANCH" ]; then
    DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
fi
if [ -z  ]; 
     branch  main master develop; 
         git show-ref --verify --quiet ; 
            DEFAULT_BRANCH=
            
        
    

Scan `docs/technical-debt.md` for debt that should influence sprint planning: After branch creation, ask the user if they want to create a draft PR for early CI feedback: **Sprint Definition of Done** (derived from PRD): Read PRD Section 6 (NFRs) and Section 7 (scope boundaries). Include applicable thresholds: - Performance targets from NFRs (e.g., "API < 200ms P95") - Security requirements from NFRs (e.g., "all PII encrypted") - Implementation boundaries from Section 7 (Always/Ask first/Never rules)