bmad-retrospective

Facilitates post-epic retrospectives extracting lessons learned and action items from sprint records.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-retrospective-unbakedcosmos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-retrospective
Source: https://github.com/unbakedcosmos/thumbnailer/tree/main/.claude/skills/bmad-retrospective
Command: npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-retrospective-unbakedcosmos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After completing an epic, teams often skip structured reflection, losing valuable lessons from story records, review feedback, and technical debt. This Skill runs a guided, multi-agent retrospective that mines sprint-status files and story documents to surface patterns, verify follow-through on prior action items, and prepare for the next epic. ## Core Features & Use Cases - Epic Discovery & Verification: Detects the completed epic from sprint-status.yaml with priority fallback logic, and warns when stories are still pending before running a partial retro. - Deep Story Analysis: Reads every story file to extract dev notes, review feedback patterns, technical debt, testing insights, and velocity trends across the epic. - Continuity Tracking: Loads the previous epic's retrospective and cross-references action items and lessons to measure follow-through. - Next Epic Preparation: Previews the upcoming epic, maps dependencies on completed work, and identifies technical prerequisites and preparation gaps. - Use Case: After finishing Epic 3, say "run a retrospective" and the facilitator agent leads a blameless team discussion, then writes a retrospective document with action items and updates sprint-status. ## Quick Start Ask the assistant to run a retrospective on the epic you just completed, for example by saying "lets retro the epic 3".

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 after completing an epic?▼

Say "run a retrospective" or "lets retro the epic [number]" to activate the workflow. It detects the completed epic from sprint-status.yaml, analyzes all story records, and facilitates a structured team discussion ending in a retrospective document.

What inputs does the retrospective workflow need?▼

It reads sprint-status.yaml for story completion, story Markdown files for dev notes and review feedback, the epic and PRD/architecture documents for context, and optionally the previous epic's retrospective for continuity tracking.

Can I run a retrospective if some stories are not done?▼

Yes, but the workflow warns you first and lists pending stories. You can choose to complete remaining stories, run a partial retrospective, or refresh sprint planning before proceeding.

Does the retrospective track previous action items?▼

Yes. It loads the prior epic's retrospective, cross-references each committed action item against current sprint status and story evidence, and marks them completed, in progress, or not addressed.

How do I customize the retrospective workflow behavior?▼

Edit the customize.toml workflow block or add team and user override TOML files under _bmad/custom. You can append activation steps, inject persistent facts, and set an on_complete hook without modifying the base skill.