claude-upgrades

Operating model for the Fable main agent orchestrating jerb development — GitHub issues as the todo list, Sonnet max-effort executor fan-out via worktrees + PRs into main, code-gated review loop, sole-reviewer merging. Auto-injected every session by the SessionStart hook.

Maintain `handoff.md` at the project meta-repo root ({{MAIN_REPO}}) as the single, curated, never-stale ROLLING MEMORY of the whole project — current development status AND every durable learned truth — so any brand-new agent with zero foreknowledge can fully take over. This is an ORCHESTRATOR-ONLY duty. Use it: (1) the moment a context compaction/summary/handoff is imminent — flush the live context window into handoff.md FIRST; (2) after any milestone, merge, decision, architecture change, or newly-learned gotcha that changes durable state; (3) at session start, to READ handoff.md before acting; (4) whenever asked to update/regenerate/fix the handoff. Core rule: ACCRETE + CURATE, never blind-overwrite — preserve durable truths, supersede only what is truly stale.

Operating procedure for the issue-triage subagent — a narrow GitHub-issue clerk that creates, merges, updates, or closes issues across the jerb repos exactly as instructed, with context-efficient search and careful flag hygiene. Preloaded into the issue-triage agent; not for the main agent.

Operating procedure for the sonnet-executor subagent — resolve exactly ONE GitHub issue into one focused PR into main under the jerb operating model. Preloaded into the sonnet-executor agent; not for the main agent.