# bmad-retrospective

> Claude/Codex skill by [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars · Updated 2026-10-16

Review a finished epic folder in the ticket tree against the evidence it left behind — the epic file, each ticket 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

Tags: agile, ai, context-engineering, sdlc, spec-driven-development

## Install

```sh
git clone https://github.com/bmad-code-org/BMAD-METHOD /tmp/BMAD-METHOD && ln -s /tmp/BMAD-METHOD/skills/bmad-retrospective ~/.claude/skills/bmad-retrospective
```

## From README

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. The command should print one line to stdout. read and follow : read that file and follow it. HALT: : 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 bmad skill, then run the command again. If you do not have the bmad skill, offer to it first. On any other output or failure, including uv being unavailable, report the command output and stop. Do not run any workflow source directly.

## Links

- HTML page: https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-retrospective/
- GitHub: https://github.com/bmad-code-org/BMAD-METHOD
- Author: [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md)

## More from this repo

- [bmad](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad/index.md) — Answers BMad questions and recommends the next skill from what is installed.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars
- [bmad-advanced-elicitation](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-advanced-elicitation/index.md) — Push the LLM to reconsider, refine, and improve its recent output.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars
- [bmad-agent-analyst](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-agent-analyst/index.md) — Business analyst for market research, competitive analysis, and requirements.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars