bmad-retrospective

Reviews completed epics against git diffs, commits, and sprint status to produce sourced retrospective reports.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ArchaonHW/MingGoRTS --skill bmad-retrospective-archaonhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-retrospective
Source: https://github.com/ArchaonHW/MingGoRTS/tree/main/.agents/skills/bmad-retrospective
Command: npx skills add https://github.com/ArchaonHW/MingGoRTS --skill bmad-retrospective-archaonhw

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? After an epic finishes, no single coding session saw the whole change, so cross-story defects, god-class growth, and spec drift go unnoticed. This Skill reads the evidence an epic left behind — spec, story files, full diff range, per-story commits, sprint status — and produces a retrospective where every finding carries a source reference, ending in an acceptance verdict. ## Core Features & Use Cases - Evidence-gathering pipeline: Derives the diff range and per-story commit attribution via bundled git scripts, with explicit recording of missing evidence so readers can tell "checked and clean" from "never checked." - Aggregate analysis views: Detects architecture deltas, duplication, god-class growth, pattern divergence, and spec-to-implementation drift that per-commit review cannot see. - Acceptance verdict and sprint-status update: Renders accepted / accepted-with-open-items / rejected, writes a structured retrospective document, and safely updates sprint-status.yaml with action items through a comment-preserving, rollback-validated script. - Use Case: After an unattended multi-story epic run, ask for a retrospective to get a sourced findings report, routed action items with owners, and a machine-readable verdict an orchestrator can gate the next epic on. ## Quick Start Ask the AI to run a retrospective on the most recently completed epic and produce a sourced findings report with an 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, story files, diff range, and commits, then produces findings with source references and an acceptance verdict.

How does the retrospective detect cross-story defects?

It derives aggregate views over the full epic diff range: architecture delta, duplication map, god-class growth, pattern divergence, and spec-to-implementation reconciliation. A bundled git_evidence.py script measures per-file churn and per-story commit attribution deterministically.

Can the retrospective run headless for automation?

Yes, the -H or --headless flag skips all confirmations, takes the epic from the invocation, and records every assumption in the retrospective document. The stable orchestrator interface is -H <epic> paired with detect-epic --epic <N>.

What happens if an epic has unfinished stories?

The machine verdict is forced to rejected whenever pending_stories is non-empty, and the unfinished story keys are named in the document. Interactive runs let a human override; headless runs record the rejection without inventing a confirmation.

Does the retrospective modify sprint-status.yaml safely?

Updates go through a bundled script that round-trips the YAML with comment preservation, writes atomically, and validates the result, restoring the original bytes on any failure. Hand-editing the file is explicitly forbidden.

What are the limitations of the retrospective findings?

Every finding must carry a source reference to a file, line, commit, or log; anything that cannot be pointed at is dropped. Missing evidence such as absent session logs narrows the analysis scope, and the narrowing is recorded rather than hidden.