cornerman-retro

/cornerman retro

Read-only telemetry aggregation. Produces one markdown report from the local .claude/loop-events.jsonl + .claude/runs/*/manifest.json + .claude/incidents/*/. Doesn't mutate anything.

Args

Flag	Default	What it does
--since	7d	7d, 24h, 30d, all
--issue <N>	none	Filter to a single issue
--agent <name>	none	Filter to a single agent (implementer, pr-reviewer, …)

How

The skill invokes:

python3 .claude/plugins/cornerman/scripts/retro/aggregate.py \
  --since "${SINCE:-7d}" \
  ${ISSUE:+--issue "$ISSUE"} \
  ${AGENT:+--agent "$AGENT"}

Output is markdown to stdout. Sections:

• Runs — totals (completed vs incomplete) + outcomes breakdown
• Contract pass rates — per-transition pass/fail counts + average ms
• Stuck issues — issues with >= 3 runs and no state_transition event (heuristic; tunable in the aggregator)
• ci-fixer effectiveness — fixed vs retried vs other
• Token outliers — top 5 runs by total tokens (in + out)
• Recent incidents — watchdog timeouts (last 10)
• Verification drift — agents that claimed mutations the verifier couldn't confirm

Empty-stream behavior

When .claude/loop-events.jsonl doesn't exist (or filters exclude everything), the report says so explicitly — does NOT print empty sections. Same shape as research-platform-scan surfacing missing platform_capabilities (#2): visible gap beats silent nothing.

What the retro is NOT

• A live dashboard — point-in-time snapshot; re-run to refresh
• A mutator — read-only; never updates issues, PRs, manifests
• A linter — surfaces patterns, doesn't judge them. "ci-fixer retried 60% of the time" is a fact; whether that's bad is a human call

Pairs with

• /cornerman where-am-i (#14) for per-issue / per-branch resumability
• /cornerman resume (#22) for full session restoration with what-changed-since
• Watchdog (#6) — incidents section consumes its output
• Contracts (#4), telemetry (#5), verification (#9), run-manifests (#11) — the substrate

Example invocations

/cornerman retro
/cornerman retro --since 24h
/cornerman retro --issue 211
/cornerman retro --agent implementer --since 30d
/cornerman retro --since all   # since beginning

Aggregator location

scripts/retro/aggregate.py ships with the plugin. Pure Python (no jq dependency); reads YAML/JSON only. ~5KB. Stand-alone — runnable outside the skill for ad-hoc reports.