speckit-retro-run

Generate a structured retrospective report from spec, task, and plan files with git metrics.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-retro-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-retro-run
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-retro-run
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-retro-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you systematically learn from a completed spec-driven development cycle so you can improve accuracy, planning, and implementation quality in the next iteration.

Core Features & Use Cases

  • Structured retrospective with measurable evidence: Reads spec.md, tasks.md, and plan.md (plus optional reviews/QA/releases/critiques/previous retros) and compiles metrics from git history to identify what worked and what didn’t.
  • Process improvement suggestions ranked by impact: Produces actionable, categorized improvement items (HIGH/MEDIUM/LOW) grouped by Specification, Planning, Implementation, Quality, and Process.
  • Continuous learning across cycles: Compares current metrics to previous retros when available and optionally proposes updates to constitution.md after explicit approval.

Quick Start

Run speckit-retro-run to generate a new retro report from your feature artifacts and git metrics in the .specify-backed flow.

Frequently Asked Questions about speckit-retro-run

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

FAQPage Schema
How do I run a retrospective for a spec-driven development cycle?

To run a spec-driven development retrospective, this Skill analyzes your spec.md, tasks.md, and plan.md alongside git history metrics to identify planning and implementation gaps. It compiles measurable evidence to evaluate what worked and what failed during the delivery cycle.

What is the best way to generate process improvement suggestions from git analysis?

Generating process improvement suggestions from git analysis involves comparing current cycle metrics against previous retros. This Skill ranks actionable improvements by impact, categorizing them into Specification, Planning, Implementation, Quality, and Process areas.

Does spec-kit retrospective generation work without optional review and QA artifacts?

Yes, spec-kit retrospective generation works without optional review and QA artifacts. The Skill performs pre-checks for mandatory and optional extension hooks, using available files like release notes and critiques while applying fallbacks for missing git-derived metrics.

Can I update my project constitution automatically after a retrospective?

You cannot update your constitution automatically, but you can request a constitution.md update after the retrospective. This Skill proposes continuous learning updates gated explicitly by your approval to ensure safe process evolution.

How are retrospective improvement items ranked and categorized?

Retrospective improvement items are ranked as HIGH, MEDIUM, or LOW based on measurable evidence from git analysis. They are grouped into Specification, Planning, Implementation, Quality, and Process categories to guide future iteration accuracy.