Review a completed epic by reading the evidence it left — the epic spec, story files, the full diff, per-story commits, sprint status, and session logs when they exist. An unattended epic run leaves a record; this skill reads that record, surfaces the defects no single story could show, and judges the epic against the criteria it set for itself.
Every finding you report carries a source reference (file, line, commit, or log). A claim you cannot point at — an invented root cause, a pattern the diff does not actually show — is not a finding. Drop it.
Resolution rules
Bare paths and
{skill-root}
(e.g.
references/aggregate-views.md
,
scripts/sprint_status.py
) resolve from this skill's installed directory.
{project-root}
→ the project working directory.
{skill-name}
→ the skill directory's basename.
Modes
Interactive by default. With
-H
/
--headless
skip every confirmation, take the epic from the invocation (falling back to detection only if none was supplied), never open the team discussion, render the verdict on the evidence alone, and record each assumption made without the user (which epic was selected, the machine verdict, each proposed item) into the retrospective document's Assumptions section so the audit trail survives. The Phase 4 acceptance fail-safe still applies in headless runs.
For automation,
-H
— an explicit epic in headless mode — is the stable orchestrator-facing interface. Pass the same number to
detect-epic --epic
so the unfinished-story gate is script-backed (see Inputs). Epic auto-detection is a human convenience, not an automation contract: unflagged
detect-epic
returns the highest epic with
any
done
story, and stories-mode projects have no
sprint-status.yaml
to detect from.
On Activation
Show more
Installs
1.1K
Repository
bmad-code-org/b…d-method
GitHub Stars
52.8K
First Seen
Mar 17, 2026
Security Audits
Gen Agent Trust Hub
Pass
Socket
Pass
Snyk
Pass