speckit-retro

Automate post-implementation retrospectives to update living documents and triage TODOs.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/ranvirsingh/speckit --skill speckit-retro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-retro
Source: https://github.com/ranvirsingh/speckit/tree/main/skills/speckit-retro
Command: npx skills add https://github.com/ranvirsingh/speckit --skill speckit-retro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Post-implementation work often leaves living documents, API contracts, and TODOs out of date. speckit-retro automates the retrospective process to update living docs, verify consistency, close the loop, and triage discovered TODOs into the parking lot without requiring user input.

Core Features & Use Cases

  • Automated living-doc updates: appends a new retrospective entry to docs/retro.md and updates related living documents (data-model, contracts, ADRs) as needed.
  • Parking-lot triage: extracts TODO markers from the codebase and adds them to docs/PARKING_LOT.md for future speckit-specify planning.
  • Context-aware workflow: uses the implementation session context and living documents to generate a comprehensive retrospective aligned with the latest changes.

Quick Start

Invoke speckit-retro after speckit-implement to automatically generate the retrospective and update living docs.

Frequently Asked Questions about speckit-retro

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

FAQPage Schema
How do I automate post-implementation retrospectives to update living docs?

Automating post-implementation retrospectives appends comprehensive entries to docs/retro.md and updates related living documents using the implementation session context. It verifies consistency and triages discovered TODOs automatically, requiring no user input during the retrospective process.

What is the best way to triage TODO markers into a parking lot document?

Triage TODO markers into a parking lot by extracting them from the codebase during the retrospective phase and appending them to docs/PARKING_LOT.md. This uses the PARKING_LOT.md template to prepare discovered tasks for future planning cycles.

Can I update living documents automatically after completing a feature or bug fix?

Yes, you can update living documents automatically after completing feature, bug, or chore work types. The retrospective process uses implementation session context to append entries to docs/retro.md and update data models, API contracts, and ADRs as needed.

Do I need to run implementation sessions before generating automated retrospectives?

Yes, you need a completed implementation session first because the retrospective uses that session context to produce a comprehensive review. It applies after implementation across feature, bug, or chore work types to update living docs and triage TODOs.

Why are my living documents and API contracts out of date after implementation?

Living documents and API contracts become out of date when post-implementation work skips retrospective updates. Automating the retrospective process closes the loop by verifying consistency and appending updates to docs, data models, and contracts based on the latest session context.