bmad-retrospective

Reviews what your team built to find what worked, what didn't, and what to do next time.

Installation
Run `npx skills add "https://github.com/bmad-code-org/bmad-method" --skill "bmad-retrospective"` to install this skill, then follow its SKILL.md instructions for my next request.

Paste this into Claude Code, Cursor, or any agent that can run commands.

SKILL.mdShow the author's original SKILL.md
---
name: bmad-retrospective
description: 'Review a completed epic against the evidence it left behind — spec, stories, diffs, commits, sprint status — 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'
---

Run the following command exactly once without changing the current working directory. Replace `{project-root}` with the absolute path to the project root and `{skill-root}` with the absolute path to this skill's directory:

```bash
uv run --no-cache "{project-root}/_bmad/scripts/render_skill.py" --project-root "{project-root}" --skill "{skill-root}"
```

- On success, read and follow the one absolute `workflow.md` instruction printed to stdout.
- If `{project-root}/_bmad/scripts/render_skill.py` is not found, this BMad installation is not set up yet: read the installed `bmad` skill's SKILL.md (a sibling of this skill's directory) and follow its setup flow, then run the command above once more.
- On any other failure (including `uv` being unavailable), report the command output and HALT. Do not run any workflow source directly.

Ships with 13 supporting files:

  • customize.toml
  • module-manifest.toml
  • references/acceptance-verdict.md
  • references/aggregate-views.md
  • references/evidence-gathering.md
  • references/retro-document.md
  • references/team-discussion.md
  • scripts/git_evidence.py
  • scripts/sprint_status.py
  • scripts/tests/fixtures/sprint-status-template.yaml
  • scripts/tests/test_git_evidence.py
  • scripts/tests/test_sprint_status.py
  • workflow.md

Mirrored from the author's public source. Install counts from the open skills registry.

The systems behind these skills get built for partners every week.

Partner with us