← ClaudeAtlas

gotcha-harvestlisted

Harvest discovery-driven lessons from autonomous loops. Scans a session (or --days N of history) for 'CI/check failed → fix → passed' arcs and recurring tool-errors, then proposes entries for .claude/rules/gotchas.md (repo-specific) or your frontmatter-per-fact memory (cross-repo). Use after /implement-queue or /ship-loop runs, or invoke /gotcha-harvest. Complements /reflect, which is correction-driven and misses these.
mattbutlerengineering/mattbutlerengineering · ★ 1 · API & Backend · score 70
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