bmad-retrospective
The facts
Its description
Review a finished epic folder in the ticket tree against the evidence it left behind — the epic file, each ticket''s story file and plan, diffs, commits — and produce a retrospective with sourced findings, action items, and an acceptance decision. Use when the user says "run a retrospective" or "lets retro the epic [epic]". Supports -H/--headless
The description the agent reads to decide when to use it.
When it starts
The agent picks this skill when the user asks to run a retrospective over a finished epic in the ticket tree, or names an epic to retro. It is also the stable entry point for an orchestrator calling it headless with an epic folder, id, or slug.
Things a person might say (the model's guesses)
- “run a retrospective”
- “lets retro the epic epic-checkout-flow”
- “retro the epic payments, we just finished it”
A model's summary of when it is used.
Runs scripts
scripts/render_skill.py
Scripts the text names. Found by matching words, so treat them as pointers.
What it leads to
- hands off to bmad-agent-po workflow.md, line 101
- calls bmad only when BMad is not set up in the project line 16
- calls bmad-party-mode only when the user asks for a team discussion workflow.md, line 91
- calls bmad-review workflow.md, line 84
Other skills this one hands off to, calls, requires or offers instead, as a model read them.
Licence
MIT, from LICENSE
The terms its author shares it under, which let it be shown here.
Other files in this skill (9) Close
The text
Most marks come from matching words in the file, so treat them as pointers.
Run the following command exactly once without changing the current working directory.
Replace {project-root} with the nearest folder containing _bmad/, from the working directory upward. Replace {skill-root} with the absolute path to this skill's directory.
uv run --no-cache "{project-root}/_bmad/scripts/render_skill.py" --project-root "{project-root}" --skill "{skill-root}"- The command prints the skill's workflow: follow it.
HALT: <reason>: report the reason and stop. - If the script does not exist, BMad is not set up in this project yet. Offer to set it up using
bmadskill, then run the command again. If you do not have thebmadskill, offer to install it first. - On any other output or failure, including
uvbeing unavailable, report the command output and stop. Do not run any workflow source directly.
From bmad-code-org/BMAD-METHOD at bd70c64, 2026-10-31. Skills read by DeepSeek V4.1 Flash on 2026-11-04. Summary and techniques by Claude Opus 5.5 on 2026-11-06.