review-sessionslisted
Install: claude install-skill phmatray/ai-migration-kit
# Review the sessions — the kit's own failures, out of the transcripts
## What this does
Every session Claude Code runs leaves a transcript under `~/.claude/projects/<encoded-cwd>/`, and
the kit's failures are written into it in fixed shapes: a `tool_result` flagged `is_error` on a
kit script, a hook's deny reason, a worker's final `STATUS: BLOCKED` line, an assistant turn that
ends on *"I'll pause here and wait for"*, the harness's *no visible output* nudge. Until this skill,
a human read those by hand — every defect the kit fixed in 2026-08 was found that way, days after
the evidence had been on disk.
This skill reads them mechanically and judges them deliberately:
1. **Harvest** — [`scripts/harvest.py`](scripts/harvest.py) walks the transcripts (top-level
sessions and every sub-agent layout) and emits one record per signal, attributed to the kit
skill active at that point. Deterministic, read-only, pinned by `tests/review-sessions/test.sh`.
2. **Cluster** — records become clusters by root cause, each tagged with a category from
[`../auto-dev/references/retro-taxonomy.md`](../auto-dev/references/retro-taxonomy.md).
3. **Verify against the tree** — a cluster whose cause `main` already fixed is *already fixed*:
recorded in the recap, never filed.
4. **Apply the bar** — [`../_shared/filing-bar.md`](../_shared/filing-bar.md) and the
prior-rejection lookup in [`../_shared/prior-rejections.md`](../_shared/prior-rejections.md).
5. **File** — through `create-issu