mcpField
R
retro

retro

github.com/huytieuAgent workflows1.3k115 installsUpdated 1w ago
Repository

About retro

retro is a skill for reviewing completed or escalated runs in a project harness. It audits checkpoints and evidence, then records lessons and follow-up actions to improve future runs.

Key features

  1. 01Collects run specifications and evidence
  2. 02Audits required checkpoints against results
  3. 03Checks evidence quality and traceability
  4. 04Writes a structured retro report
  5. 05Feeds actions into backlog and status records

Use cases

  1. 01Reviewing a shipped run
  2. 02Capturing why a run was escalated
  3. 03Closing an ultragoal phase
  4. 04Turning audit findings into harness work

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/huytieu/cog-second-brain --skill retro

After installing, type/retroin Claude Code to confirm it loaded.

Bundled filesreferences/retro-template.md

Details

From the project README

/retro — CP-7 close the V

Every non-tiny shipped or escalated run gets a retro. Retro is advisory but strongly expected: it is how the harness improves.

When to run

  • After CP-6 ship (approved publish, merged PR, vault deliverable done)
  • After escalate (capture why verifier failed)
  • End of an /ultragoal phase (one retro per phase)
  • Manual: /retro <run-dir or spec path>

Phase 1 — Gather evidence bundle

Read:

  1. Spec or card description + acceptance criteria
  2. 04-projects/harness/runs/<id>/evidence/ (ledger, checkpoints.tsv, CP-* files)
  3. .claude/logs/loop-ledger.tsv (last rows for this run)
  4. 04-projects/<goal>/STATUS.md if an ultragoal phase

Phase 2 — Checkpoint audit

For each CP the lane required, mark Expected vs Actual vs Gap:

CPtinynormalfull
CP-1 specskiprequiredrequired
CP-3v componentskiprequiredrequired
CP-4 integrationskipskiprequired if multi-task
CP-5 acceptanceif mutaterequiredrequired
CP-6 shipif externalif externalrequired

Phase 3 — Evidence quality pass

Ask:

  • Any AC-n shipped without a PASS evidence row? (traceability violation)
  • Any PASS row where observation is tool-return not artifact? (confident-but-unchecked)
  • Any criterion that wasn't falsifiable? (fix in next spec)

Phase 4 — Write retro

Copy references/retro-template.md to:

04-projects/harness/retro/YYYY-MM-DD-<slug>.md

Fill all sections. Action items get IDs (AI-01…).

Phase 5 — Feed forward

  1. Harvest: append action items + lessons to today's harvest staging
  2. Backlog: add AI-n rows to 04-projects/harness/BACKLOG.md if harness work
  3. STATUS.md: if an ultragoal phase, advance the phase state + log open AC-n
  4. Spec checkpoint log: update spec ## Checkpoint log CP-7 row
  5. Record: bash .claude/lib/checkpoint.sh record <run-dir> CP-7 PASS "retro: <path>"

Output to the user

TL;DR: outcome, top lesson, top action item, retro path.

Comments

Markdown supported