/ _bmad / agents / scrum-master-agent.md
scrum-master-agent.md
 1  # Scrum Master Agent
 2  
 3  ## Persona
 4  **Scrum Master Sam** -- Stateless orchestrator. A script, not an LLM.
 5  
 6  ## Role
 7  Decomposes epics into stories. Manages story lifecycle. Maintains traceability matrix. Orchestrates the sprint loop by invoking other agents in sequence. Sam is a **stateless orchestrator** -- a deterministic script that manages the lifecycle of other agents, not an LLM that reasons about project management.
 8  
 9  ## When Invoked
10  **Always** -- Manages every sprint. Sam is the harness that drives the discovery-plan-architect-design-generate-evaluate cycle.
11  
12  ## Context
13  Fresh per task. No memory of previous sessions. Reads current state from files on disk (epic tables, story statuses, traceability matrix) to determine what to do next.
14  
15  ## Owns
16  - `epics/epic-*.md`
17  - `epics/stories/s*-*.md`
18  - `_bmad/traceability.md`
19  - Sprint lifecycle (which agent runs next, what inputs it gets)
20  
21  ## Key Inputs
22  - `_bmad/prd.md` -- Requirements for epic/story decomposition
23  - `openspec/capabilities/*/spec.md` -- For traceability mapping
24  - Story status fields, epic story tables -- For lifecycle management
25  - Architect's implementation readiness verdicts -- For sprint admission
26  
27  ## Key Outputs
28  - `epics/epic-*.md` -- Epics with story tables
29  - `epics/stories/s*-*.md` -- Individual story files with acceptance criteria
30  - `_bmad/traceability.md` -- FR-to-story-to-implementation mapping
31  - Sprint plans -- Sequenced story batches with agent invocation order
32  
33  ## Decision Authority
34  - Story decomposition and sizing
35  - Sprint scope and sequencing
36  - Status lifecycle transitions
37  - Agent invocation order within a sprint
38  
39  ## Stateless Orchestration
40  Sam does not reason -- Sam follows a script:
41  1. Read current state from files on disk
42  2. Determine which stories are ready (based on readiness verdicts)
43  3. Invoke agents in sequence with explicit context (story file + referenced specs)
44  4. Collect outputs and update status files
45  5. Repeat until sprint is complete
46  
47  Between every agent invocation, **context resets**. Each agent receives only the files it needs, not the full conversation history.
48  
49  ## Sprint Contract
50  At sprint start, Sam:
51  1. Selects stories from the backlog based on priority and readiness
52  2. Presents the sprint contract (proposed stories + effort estimates) for user approval
53  3. Locks the sprint scope once approved -- scope changes require a new change proposal
54  
55  ## Coordination
56  - **Orchestrates**: All other agents (Discovery, PM, Architect, Design, Dev)
57  - **Receives from**: PM Agent (priority input), Architect Agent (readiness verdicts, dependency info)
58  - **Hands off to**: Dev Agent (story assignment with full context package)
59  - **Escalates to user**: Blockers, sprint scope negotiations, stories that fail readiness checks