flow-retro

Runs post-merge retrospectives comparing OpenSpec change expectations against shipped outcomes.

Updated Nov 7, 2023
One-click install
npx skills add https://github.com/lstellway/nixfiles --skill flow-retro-lstellway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-retro
Source: https://github.com/lstellway/nixfiles/tree/main/modules/home-manager/claude/skills/flow-retro
Command: npx skills add https://github.com/lstellway/nixfiles --skill flow-retro-lstellway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After merging a change, teams often move on without capturing what they learned, losing the comparison between what was planned and what actually shipped. This Skill closes the loop by running a structured retrospective on merged OpenSpec changes and feeding the findings back into project strategy. ## Core Features & Use Cases - Expected-vs-happened comparison: Walks through flow.md's expected outcome and watch signals against what actually shipped, grounded in recent git history. - Candidate lifecycle management: Updates the parent candidate checklist, creates new candidate files for follow-ups, and archives completed candidates. - Archive handoff: Writes a retro.md file and delegates the final archive move to /opsx:archive. - Use Case: After merging a secrets-rotation change, run the retro to confirm the expected outcome held, log an unexpected effort overrun, create a follow-up candidate for leftover TODOs, and archive the change. ## Quick Start Run a retrospective on the merged change by asking to retro the change id, for example: run a retro on rotate-secrets-on-startup.

Frequently Asked Questions about flow-retro

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

FAQPage Schema
How do I run a retrospective on a merged OpenSpec change?

Invoke the retro with a change id, such as /flow-retro rotate-secrets-on-startup. If no id is given, it lists un-archived changes under openspec/changes/ and asks which one to retro.

What happens if flow.md is missing for a change?

The retro still works but loses the expected-vs-happened comparison spine. It offers to backfill flow.md best-effort from the proposal first, or proceed with a free-form retro if you prefer.

Can I retro multiple merged changes at once?

No, run the retro once per change. Each change has its own flow.md spine, so batching would blur the comparison. Stale retros are still useful but lose detail.

Does the retro archive the change itself?

No, it delegates the archive move to /opsx:archive, which owns that contract. The retro.md and flow.md files ride along because they live in the change directory.

What files does a retrospective create or update?

It always writes openspec/changes/<change-id>/retro.md. It often updates the parent candidate checklist and last-reviewed date, and may create new candidate files or edit conventions when the retro surfaces real signal.