name: orchestrating-sprints description: Manages development sprints with workflow-based compilation and fresh-context execution. Supports hierarchical phases (prepare → development → QA → deploy) with for-each step expansion. This skill should be used when starting sprints, managing workflows, or tracking sprint progress. Triggers on "start sprint", "create sprint", "run sprint", "sprint status", "add step", "compile sprint".

Sprint Orchestration

Manages development sprints through workflow-based compilation with hierarchical phase execution and fresh-context task processing.

Core Concepts

Sprint Structure

.claude/
  workflows/          # Reusable workflow templates
    sprint-default.yaml
    feature-standard.yaml
  sprints/
    YYYY-MM-DD_name/
      SPRINT.yaml     # Input (workflow reference + steps)
      PROGRESS.yaml   # Compiled (generated by compiler)
      context/
      artifacts/

Workflow Architecture

┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
│  SPRINT.yaml    │     │   Compiler   │     │  PROGRESS.yaml  │
│                 │────▶│              │────▶│                 │
│  - workflow-ref │     │  - Resolves  │     │  - Phases       │
│  - steps[]      │     │    workflow  │     │    └─ Tasks[]   │
│                 │     │  - Expands   │     │  - Status tree  │
│                 │     │    for-each  │     │                 │
└─────────────────┘     └──────────────┘     └─────────────────┘

Commands

Compilation Process

Compilation occurs automatically on /run-sprint:

1. Read SPRINT.yaml (workflow reference + steps)
2. Resolve workflow template from .claude/workflows/
3. Expand for-each phases into task hierarchy
4. Generate PROGRESS.yaml with full execution tree

# SPRINT.yaml (input)
workflow: sprint-default
steps:
  - implement auth module
  - add unit tests for auth
  - update API documentation

# PROGRESS.yaml (compiled output)
status: pending
phases:
  - name: prepare
    status: pending
    tasks: [...]
  - name: development
    status: pending
    tasks:
      - id: task-001
        prompt: implement auth module
        status: pending
      - id: task-002
        prompt: add unit tests for auth
        status: pending
  - name: qa
    status: pending
    tasks: [...]

Workflow Modes

The sprint system supports two workflow modes:

Ralph Mode workflows use mode: ralph and allow Claude to create steps dynamically. See docs/concepts/ralph-mode.md for details.

References

• references/workflow-definitions.md - Workflow template syntax and structure
• references/progress-schema.md - PROGRESS.yaml schema specification (includes Ralph Mode fields)
• references/compiler-usage.md - Compiler invocation and options
• references/sprint-setup.md - Directory structure and initialization
• docs/concepts/ralph-mode.md - Ralph Mode autonomous workflow documentation

Assets

• assets/sprint-template.yaml - SPRINT.yaml template
• assets/progress-template.yaml - PROGRESS.yaml template
• assets/workflow-template.yaml - Workflow definition template

Troubleshooting