m42-sprint

- **Worktree setup is handled by runtime CLI setupWorktreeIfNeeded, not command skills**: Command skills like `/run-sprint` should NOT manually set up worktrees before launching the runtime CLI. This duplicates logic and can use incorrect paths or versions. The runtime CLI (`runtime/src/cli.ts`) automatically handles worktree setup via `setupWorktreeIfNeeded()` (lines 354-454): loads SPRINT.yaml, checks if worktree needed, resolves paths, creates worktree, copies sprint files, returns target directory. Command skills should: parse arguments, run preflight checks, compile workflow if needed, launch runtime CLI directly (which handles worktree internally), launch status server. Do NOT duplicate worktree setup logic in command skills.

Add step to sprint SPRINT.yaml

Clean up sprint worktree after completion

Export sprint progress to PDF

Show sprint plugin help and available commands

Bulk import steps to sprint SPRINT.yaml

Initialize new sprint directory structure

Pause sprint after current task

Resume paused sprint execution

Start sprint execution loop (fresh context per task)

Show sprint progress dashboard

Start status server for existing sprint or open the dashboard

Initialize new sprint directory structure

Stop active sprint loop immediately

Guide for creating sprint definitions in SPRINT.yaml. This skill should be used when users want to create sprint, new sprint planning, sprint definition best practices, or define steps for autonomous execution. Triggers on "create sprint", "new sprint", "sprint definition", "define steps".

Guide for creating sprint workflow definitions. This skill should be used when users want to create a new workflow, modify existing workflows, understand workflow schema, or define phase sequences. Triggers on "create workflow", "new workflow", "workflow definition", "define phases".

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".

Validates sprint workflow YAML files and displays formatted results. This skill should be used when users request workflow validation, when Claude detects potential workflow issues before sprint execution, or when troubleshooting workflow errors. Triggers on "validate workflow", "check workflow", "workflow validation", "is this workflow valid", or "workflow errors".