gotcha-harvestlisted
Install: claude install-skill mattbutlerengineering/mattbutlerengineering
# Gotcha Harvest
`/reflect` captures **corrections** — places where a human told the agent "no, do X." Autonomous loops (`/implement-queue`, `/ship-loop`) rarely produce those; their lessons are **discovery-driven**: a CI check fails, the agent diagnoses and fixes it, the check passes. That arc is the richest source of reusable gotchas and `/reflect` structurally never sees it. This skill harvests it.
**Output is a proposal, never a silent write.** Always show findings and get a human decision before editing any file.
## Arguments
- (none) — scan the **current session** transcript only.
- `--days N` — scan the last N days (default 7 when the flag is bare).
- `--source transcript|github|auto` — where to mine from (default `auto`).
- `--dry-run` — show proposals, write nothing.
## Source modes
The failure→fix→pass arc lives in two places; pick by where you're running:
- **`transcript`** — local session `.jsonl` files. Richest signal (the agent's own reasoning + the exact commands), but only exists on the machine that ran the loop, and Claude Code prunes sessions after 30 days. Use locally.
- **`github`** — the repo's merged-PR + CI-run history via `gh`. Durable and available **in a cloud/CI checkout with no local files** — this is the mode a scheduled cloud routine must use. Lower fidelity (you see the failed check and the fixing commit, not the deliberation), but the arc is still recoverable.
- **`auto`** (default) — `transcript` if local session files for this project