bmad-retrospective

Reviews completed epics against git evidence and renders a sourced acceptance verdict.

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-retrospective-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-retrospective
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-retrospective
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-retrospective-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruamel.yaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? After an epic ships across many coding sessions, no single session saw the whole change, so defects like god-class growth, duplication, and spec drift go unnoticed. This Skill reads the evidence an epic left behind — specs, story files, diffs, commits, and sprint status — and produces a sourced retrospective with an honest acceptance verdict. ## Core Features & Use Cases - Evidence-based analysis: Gathers the epic spec, story files, diff range, and per-story commits via deterministic scripts, then derives aggregate views (architecture delta, duplication map, god-class growth, spec reconciliation) where every finding carries a file, line, or commit reference. - Acceptance verdict with hard rules: Judges the epic against declared or profiled acceptance criteria as accepted, accepted-with-open-items, or rejected; unfinished stories force a machine verdict of rejected unless a human overrides. - Sprint-status integration: Updates sprint-status.yaml atomically through a comment-preserving script that marks the retro done, appends owned action items with stable ids, and validates every write with rollback on failure. - Use Case: After an unattended agent run finishes epic 4, run the retrospective to discover that three stories collectively grew a 3,000-line class, verify the behavior end to end, and record a rejected verdict with routed action items before starting epic 5. ## Quick Start Run a retrospective on the last completed epic and show me the findings with their sources and the acceptance verdict.

Frequently Asked Questions about bmad-retrospective

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a retrospective on a completed epic?

Invoke the skill with the epic number or let it auto-detect the highest epic with a done story from sprint-status.yaml. It gathers the spec, stories, and diff evidence, then produces findings and an acceptance verdict in a retrospective document.

How does the retrospective detect unfinished stories?

The sprint_status.py detect-epic command returns pending_stories scoped to the selected epic, listing story keys whose status is not done. A non-empty list forces the machine verdict to rejected, though an interactive user may override.

Can I run the epic retrospective headless in CI automation?

Yes, pass -H with an explicit epic number for the stable orchestrator interface. Headless mode skips confirmations and team discussion, records every assumption in the document, and never writes action-item status transitions.

Does the retrospective work without a sprint-status.yaml file?

Yes, stories mode reads a spec folder containing SPEC.md, an ordered stories.yaml, and story artifacts instead. It finalizes RETROSPECTIVE.md in that folder and never creates or edits sprint-status files.

Why does the verdict show rejected when the code looks complete?

The machine verdict is rejected whenever any of the epic's stories is not marked done, a blocking finding stands unresolved, or acceptance criteria are unmet. A human decision can override interactively, but headless runs keep the rejected verdict.