skills/golem-powers/catchup/SKILL.md
Use when returning to work after any break — auto-detects depth. Short break (hours): reads only uncommitted changes. Long break (48h+) or context overflow: reads all branch changes vs main. Covers catchup, context recovery, refresh, rebuild understanding. NOT for: mid-task exploration (use Read/Grep directly).
npx skillsauth add etanhey/golems catchupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Auto-detects break length and adjusts depth. Short break = uncommitted changes only. Long break = full branch diff vs main.
Check both signals to pick the right mode:
# 1. Check uncommitted changes
git status --short
# 2. Check branch commit count
git log --oneline main...HEAD 2>/dev/null | wc -l
| Uncommitted changes? | Branch commits? | Mode | |---------------------|-----------------|------| | Yes | Few (0-3) | Quick — read uncommitted only | | No | Many (4+) | Full — read all branch changes | | Yes | Many (4+) | Full — read everything | | No | None | Nothing to catch up on |
User can override: /catchup quick or /catchup full
git status --short
Status codes:
M — Modified (staged) M — Modified (unstaged)MM — Modified (both)A — Added (staged)?? — UntrackedRead only files with M status. Skip untracked (??) unless relevant.
git diff --name-only main...HEAD
Read in dependency order:
schema.ts, convex/, prisma/)package.json, tsconfig.json, .env.example)actions/, api/, server/)components/, app/)tests/, *.test.ts)git log main...HEAD --oneline for commit history contextgit diff to see actual line changestools
The human-eval UX contract for Phoenix views: turn-by-turn scrollable replay (not a scorecard), hide-but-copyable IDs, collapsed thinking, identity chips, tool filters, tiny frozen starter datasets, mark-wrong-in-thread, mobile-first. Use when: building or reviewing ANY Phoenix/eval view, annotation UI, session replay, or human-grading surface. Triggers: phoenix view, eval UI, annotation view, session replay, human eval UX, grading interface. NOT for: Phoenix data pipelines/ingest (capture scripts have their own specs).
tools
macOS systems specialist — AppKit NSPanel architecture, launchd services, socket activation, MCP bridge resilience, syspolicyd, and high-frequency SwiftUI dashboards. Use when building menu-bar apps, LaunchAgents, debugging syspolicyd/Gatekeeper/TCC, resilient UDS/MCP bridges, or SwiftUI dashboards at 10Hz+.
development
Bulk LLM-judging protocol for fleet-dispatched verdict runs (KG cluster, eval harness). Use when: dispatching or running judge workers (J1/J2/RT), planning bulk-apply from verdict JSONL, or triaging evidence_degraded outputs. Triggers: judge fleet, bulk judge, R3 verdicts, kg-judge, RT gate, evidence_degraded. NOT for: single-item code review, Phoenix view UX (use phoenix-human-view), or non-judge eval pipelines.
development
Quiet-down protocol for sprint close: when the fleet wraps, delete ALL polling crons and monitors, send ONE final dashboard + ONE message, then go SILENT. Use when: fleet wraps, all workers done, overnight queue exhausted, sprint close, Etan asleep/away with nothing approved left. Triggers: fleet wrap, wrap the fleet, stand down, going quiet, sprint close. NOT for: mid-sprint monitoring (keep your loops), spawning a successor (use /session-handoff first).