project-retro

Runs a whole-project retrospective after roadmap completion and files findings into docs/FUTURE.md.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/CMiller838/meal-planner --skill project-retro-cmiller838
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-retro
Source: https://github.com/CMiller838/meal-planner/tree/main/.claude/skills/project-retro
Command: npx skills add https://github.com/CMiller838/meal-planner --skill project-retro-cmiller838

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a project roadmap is fully shipped, teams often jump straight into the next version without capturing what worked, what drifted from the plan, and what new ideas emerged from real usage. This Skill structures that end-of-version retrospective so findings are filed consistently instead of being lost. ## Core Features & Use Cases - Roadmap completion check: Verifies every phase in docs/roadmap.md is marked done before starting, and asks how to proceed if not. - Outline drift analysis: Compares the shipped product against the original outline to surface must-haves that changed shape or were silently dropped. - Structured user interview: Asks in small batches about what works, what to change, what to add, and whether the tech stack caused real friction. - Findings filing: Routes each item to either the outline's feature list (adopted now) or docs/FUTURE.md (parked, with a concrete revisit trigger), grouped under a dated retro heading. - Use Case: After finishing v1 of your app, say "the roadmap's done, let's do a retro" and the Skill walks you through a review, updates the outline to match reality, and seeds docs/FUTURE.md for the next planning pass. ## Quick Start Tell the assistant "the roadmap is done, let's run a project retro" and it will verify completion, interview you about the shipped product, and file the results.

Frequently Asked Questions about project-retro

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

FAQPage Schema
How do I run a project retrospective after finishing a roadmap?

Say something like "the roadmap's done, let's review" and the Skill verifies all phases in docs/roadmap.md are complete, compares the shipped product to the original outline, interviews you in small batches, and files findings into the outline or docs/FUTURE.md.

What happens to retro findings in docs/FUTURE.md?

Parked items are appended to docs/FUTURE.md under a dated heading like "From v1 retro", each with a description, why it was deferred, and a concrete revisit trigger. Adopted items go into the outline's feature list instead, since FUTURE.md is only for unplanned work.

Can I run a retro before the roadmap is fully done?

The Skill checks docs/roadmap.md first and, if any phase is unfinished, asks whether you want to proceed anyway or finish the roadmap first. It only continues after you explicitly confirm.

Does the retro change the tech stack automatically?

No. If the interview surfaces a genuine stack friction point, the Skill tells you the concern and recommends running the architect agent as a separate deliberate step. It never triggers a stack revisit as a side effect of the retro.

When should I use project-retro instead of a phase review?

Use it once per completed roadmap, not per phase or per PR. It reviews the whole shipped project against the original outline; single-phase or single-PR reviews and planning the next version are handled by other skills.