bmad-skills/scrum-master/SKILL.md
Sprint planning and agile workflow specialist. Breaks epics into user stories, estimates complexity using story points, plans sprint iterations, and tracks velocity. Trigger keywords - sprint planning, user story, story points, velocity, backlog, sprint, epic breakdown, estimation, burndown, agile planning.
npx skillsauth add aj-geddes/claude-code-bmad-skills scrum-masterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Role: Phase 4 - Implementation Planning specialist
Function: Break down work into manageable stories, plan sprints, track velocity, and facilitate agile delivery.
Fibonacci Scale:
Rule: If a story exceeds 8 points, it must be broken into smaller stories.
See story-sizing-guide.md for detailed sizing guidance.
Velocity:
Capacity:
Burndown:
See REFERENCE.md for detailed metrics calculations.
.bmad/sprint-status.yaml if existspython scripts/calculate-velocity.py <sprint-status-file>
Calculates current velocity and 3-sprint rolling average.
bash scripts/generate-story-id.sh <project-name>
Generates next sequential story ID (STORY-001, STORY-002, etc.).
python scripts/sprint-burndown.py <sprint-status-file>
Generates burndown chart data from sprint status.
This skill leverages parallel subagents to maximize context utilization (each agent has up to 1M tokens on Claude Sonnet 4.6 / Opus 4.6).
Pattern: Parallel Section Generation Agents: N parallel agents (one per epic)
| Agent | Task | Output | |-------|------|--------| | Agent 1 | Break down Epic 1 into user stories with estimates | bmad/outputs/epic-1-stories.md | | Agent 2 | Break down Epic 2 into user stories with estimates | bmad/outputs/epic-2-stories.md | | Agent N | Break down Epic N into user stories with estimates | bmad/outputs/epic-n-stories.md |
Coordination:
Pattern: Parallel Section Generation Agents: 3 parallel agents
| Agent | Task | Output | |-------|------|--------| | Agent 1 | Analyze dependencies and create dependency graph | bmad/outputs/dependencies.md | | Agent 2 | Calculate velocity and capacity for upcoming sprints | bmad/outputs/velocity-capacity.md | | Agent 3 | Generate sprint goals based on epics and business value | bmad/outputs/sprint-goals.md |
Coordination:
Pattern: Story Parallel Implementation Agents: N parallel agents (for independent story refinement)
| Agent | Task | Output | |-------|------|--------| | Agent 1 | Refine and detail STORY-001 with full acceptance criteria | docs/stories/STORY-001.md | | Agent 2 | Refine and detail STORY-002 with full acceptance criteria | docs/stories/STORY-002.md | | Agent N | Refine and detail STORY-N with full acceptance criteria | docs/stories/STORY-N.md |
Coordination:
Task: Break down "User Authentication" epic into user stories
Context: Read bmad/context/sprint-context.md for requirements and architecture
Objective: Create 5-8 user stories with Fibonacci estimates and acceptance criteria
Output: Write to bmad/outputs/epic-1-stories.md
Deliverables:
1. 5-8 user stories following "As a [user], I want [capability] so that [benefit]" format
2. Each story includes Fibonacci estimate (1, 2, 3, 5, or 8 points)
3. Each story has 3-5 clear, testable acceptance criteria
4. Stories are sequenced with dependencies noted
5. Stories are right-sized (1-3 days each, max 8 points)
Constraints:
- Break any story >8 points into smaller stories
- Ensure each story delivers independent user value
- Map stories back to functional requirements from PRD
- Consider architecture constraints (authentication approach, data model)
- Stories should be implementable in 1-3 days
.bmad/sprint-status.yamlUser: /sprint-planning
Scrum Master:
I'll plan your sprints based on the PRD and architecture.
[Loads project config]
Project: e-commerce-platform
Level: 2 (Medium complexity)
[Loads PRD]
- 4 Epics identified
- 15 high-level requirements
[Loads architecture]
- MERN stack (MongoDB, Express, React, Node.js)
- RESTful API design
- JWT authentication
Breaking down epics into implementable stories...
Sprint 1 (2 weeks, 40 points capacity)
Goal: Complete user authentication and begin product catalog
Epic 1: User Authentication (18 points)
- STORY-001: User registration API (5 points)
- STORY-002: User login with JWT (3 points)
- STORY-003: Password reset flow (5 points)
- STORY-004: Email verification (3 points)
- STORY-005: User profile management (2 points)
Epic 2: Product Catalog (22 points)
- STORY-006: Product listing API (5 points)
- STORY-007: Product detail API (3 points)
- STORY-008: Product listing page (8 points)
- STORY-009: Product detail page (5 points)
Sprint 1 Total: 40 points (matches capacity)
Sprint 2 (2 weeks, 40 points capacity)
Goal: Complete product catalog and shopping cart
[Remaining stories allocated...]
Sprint plan created: docs/sprint-plan-e-commerce-platform-2025-12-09.md
Sprint status updated: .bmad/sprint-status.yaml
Ready to begin Sprint 1!
Next step: Run /dev-story STORY-001 to start implementation
Remember: Good sprint planning makes development smooth and predictable. Break big problems into small, achievable tasks. Keep work visible, trackable, and focused on delivering user value incrementally.
testing
Solutioning-phase UX planning skill (optional; activate when the project has a UI). Produces TWO planning documents: DESIGN.md (the visual system — design tokens, color palette, typography, spacing, component specs, WCAG 2.1 AA contract) and EXPERIENCE.md (user journeys, flow diagrams, screen states, error/empty/loading handling). Use when the user says "design the UX", "create UX planning docs", "define the design system", "map the user flows", "UX for this feature", "wireframe the flows", "what are the user journeys", "accessibility design", "WCAG compliance", "design tokens", "responsive design plan", "mobile-first design", or "create DESIGN.md / EXPERIENCE.md". Runs after architecture is drafted and before stories are created. Supports Create / Update / Validate intents.
testing
Quick Flow lightweight technical specification for small-scope work (1-15 stories). Replaces the full PRD + architecture pair when scope is small and requirements are clear. Produces bmad-output/tech-spec.md as the single planning artifact before story creation. Use when the user says: "write a tech spec", "create a technical specification", "I need a tech spec for this feature", "quick spec", "small project spec", "we don't need a full PRD", "just a tech spec", "spec out this change", "document this feature". QUICK FLOW TRACK ONLY (1-15 stories). If scope grows beyond ~15 stories or involves multiple teams / external integrations at scale, stop and redirect to bmad-prd + bmad-architecture instead — those skills are built for that complexity. Supports three intents: Create (new spec), Update (revise an existing tech-spec.md), Validate (review a draft for completeness against BMAD criteria).
tools
Orchestration handoff bridge: emits and maintains sprint-status.yaml as the project's sequencing system-of-record. Orders stories by epic then dependency, assigns parallel-set (wave) membership, and drives the status lifecycle (backlog → ready-for-dev → in-progress → review → done) as a view — never as a metric. Use when the user says "sequence the stories", "build the sprint status", "plan the waves", "create sprint-status.yaml", "assign parallel sets", "order stories by dependency", "what can run in parallel", "set up story sequencing", "initialize sprint tracking", "ready the backlog", or "prepare for dev handoff". Also triggers on "sprint planning" when the project already has epics defined. SCOPE: SEQUENCING AND ORCHESTRATION ONLY. No velocity, no burndown, no committed points, no coverage metrics. Capacity is expressed as wave width (concurrent story count), not points. The final artifact is a ready-for-dev handoff manifest; implementation is delegated to external dev tools.
development
Distills ANY messy input — brain dump, transcript, long PRD, stakeholder notes, feature request, voice memo — into a tight five-field SPEC.md kernel that any downstream planning skill can consume. The five fields are: Problem, Capabilities, Constraints, Non-Goals, Success Metrics. Use when the user says "create a spec", "write a spec for", "distill this into a spec", "I have a brain dump", "turn this into something structured", "clean up these notes", "make a SPEC from", "I want to define the problem", "help me scope this", "summarize what we're building", "I have a PRD but need a kernel", "what are we actually solving?", or drops raw text/transcript and asks for structure. Also use when starting any new initiative and a clean shared definition is missing.