bmad-retrospective

Facilitate post-epic retrospectives to extract lessons and generate actionable items.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-retrospective-imaginerlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-retrospective
Source: https://github.com/ImaginerLabs/skill-manager/tree/main/.trae/skills/bmad-retrospective
Command: npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-retrospective-imaginerlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill structures and facilitates post-epic retrospectives so teams can reliably extract lessons learned, identify root causes, and produce clear, assigned action items instead of ad-hoc, forgotten notes.

Core Features & Use Cases

  • Epic discovery and validation: Detect the most recently completed epic from sprint-status and confirm with the user before proceeding.
  • Story-level synthesis: Aggregate developer notes, reviews, testing insights, and technical-debt items across all stories to surface recurring patterns and breakthroughs.
  • Continuity and planning: Cross-reference previous retrospectives and preview the next epic to translate lessons into concrete preparation steps and ownership.
  • Use Case: Run a retrospective after finishing an epic to produce a concise retro report with prioritized action items and next-epic preparation notes.

Quick Start

Ask the agent to "run a retrospective for epic 5" and provide the project root so it can load sprint-status.yaml and related artifacts.

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 post-epic retrospective for my software development project?

To run a post-epic retrospective, point the agent to your project root so it can load sprint-status.yaml and story markdown files. It identifies the completed epic, synthesizes story-level insights, and generates a structured retrospective report with assigned action items.

What project artifacts are needed to facilitate an epic retrospective?

Facilitating an epic retrospective requires project artifacts like sprint-status.yaml, epic and story markdown files, implementation and planning artifacts, and an agent manifest. These files provide the data needed to compute metrics and produce structured retrospective outputs.

Can I use sprint-status.yaml to automatically discover which epic needs a retrospective?

Yes, retrospective facilitation uses sprint-status.yaml to automatically detect the most recently completed epic. It validates the epic completion status and confirms the selection with you before proceeding with story-level synthesis.

How does a retrospective process developer notes and testing insights from stories?

Retrospective story-level synthesis aggregates developer notes, review comments, testing insights, and technical-debt items across all stories. This process surfaces recurring patterns and breakthroughs to identify root causes from completed work.

What is the best way to translate lessons learned into preparation steps for the next epic?

The best way to translate lessons learned into preparation steps is by cross-referencing previous retrospectives and previewing the next epic. This continuity planning generates concrete preparation steps and clear ownership for upcoming work.

Why do I need an agent manifest to compute retrospective metrics?

An agent manifest is needed to compute retrospective metrics because it provides context on the AI agents involved in the project. Combined with planning artifacts, it enables the system to accurately synthesize story-level insights and produce structured retrospective outputs.