orc

Autonomous optimization loop — iteratively improve a measurable codebase metric (coverage, latency, accuracy, test pass rate)

Lightweight backlog for the orc system — capture, list, triage, pick, or promote ideas

Persist and resume orc orchestration state to disk — checkpoint or hand off to a fresh session

Multi-agent orchestration — break complex work into parallel sub-tasks dispatched to Cursor, Codex, or Claude subagents

Session-start briefing from disk state — what happened last session, what's in the backlog, what to work on next

Shape a backlog item or freeform idea into a scoped plan file before executing

Single-pane view of all orc system activity — active orchestration, autoresearch loops, backlog count, last commit

Shape a backlog item or freeform idea into a scoped plan file before executing. Interactive: reads item context, explores relevant codebase, asks 1-2 clarifying questions, writes .orc/plans/<slug>.md that orc:orchestrate can consume directly. Use when: "orc scope", "orc:scope", "scope this", "shape this idea", "plan before executing", "break this down", or when the user wants to refine an idea before committing to orc:orchestrate. Part of the orc system: orc:orchestrate, orc:backlog, orc:autoresearch, orc:status, orc:recap, orc:scope, orc:handoff.

Single-pane view of all orc system activity: active orchestration, running autoresearch loops, backlog count, last commit. Use when: "orc status", "orc:status", "what's running", "what's the state", "show me orc", or at session start to orient. Part of the orc system: orc:orchestrate, orc:backlog, orc:autoresearch, orc:status, orc:recap, orc:scope, orc:handoff.

Autonomous optimization loop inspired by Karpathy's autoresearch pattern. Iteratively improve any measurable codebase metric (coverage, latency, accuracy, test pass rate) by observing misses, hypothesizing fixes, dispatching edits to Cursor/Codex, evaluating, and ratcheting gains via git. Use when: "orc:autoresearch", "autoresearch", "optimize X metric", "iterate until X improves", "hill-climb", "run the loop", "autoresearch on [target]", or when the user wants autonomous iterative improvement of a scalar metric. Part of the orc system: orc:orchestrate, orc:backlog, orc:autoresearch, orc:status, orc:recap, orc:scope, orc:handoff.

Lightweight backlog for the orc system. Capture ideas with rich context mid-session, triage later, promote to orc:orchestrate tasks. Lives at .orc/backlog/ in the repo. Use when: "add to backlog", "orc add", "orc:add", "backlog this", "save this idea", "park this for later", "orc list", "orc:list", "orc triage", "orc:triage", "orc pick", "orc:pick", "what's in the backlog", "show me the backlog", or when the user ideates something worth capturing for a future session. Part of the orc system: orc:orchestrate, orc:backlog, orc:autoresearch, orc:status, orc:recap, orc:scope, orc:handoff.

Persist and resume orc:orchestrate state to disk. ONLY invoke when: (1) the user explicitly says /orc:handoff, "checkpoint orchestration", "hand off", "resume orchestration", or "save orc state"; (2) CC displays an actual system usage-limit warning (not your guess that one is coming); (3) orc:orchestrate auto-calls checkpoint after a wave completes; (4) a fresh session needs to resume a prior orchestration via `resume`. Do NOT invoke because a session feels long, context feels large, or you think limits might be near. "Session is long" is never a trigger. Part of the orc system: orc:orchestrate, orc:backlog, orc:autoresearch, orc:status, orc:recap, orc:scope, orc:handoff.

Multi-agent orchestration — break complex work into parallel sub-tasks dispatched to Cursor, Codex, or Claude subagents. Use when a task has multiple independent sub-parts that benefit from parallel agent execution. Triggered by /orc:orchestrate, "orc orchestrate", /orchestrate, /orchestrate path/to/plan.md, "orchestrate this", "execute this plan with agents", "break this down and run it", "run these in parallel", "dispatch this work", or any request with 2+ independent sub-parts. Works with any markdown plan file, .orc/plans/ scoped plan, or freeform request. Part of the orc system: orc:orchestrate, orc:backlog, orc:autoresearch, orc:status, orc:recap, orc:scope, orc:handoff.

Session-start briefing from disk state. Synthesizes what happened last session, what's in the backlog, and suggests what to work on next. Designed for cold-start: paste /orc:recap as first message in a new session. Use when: "orc recap", "orc:recap", "what did I do last time", "where did I leave off", "catch me up", or at the start of any new session. Part of the orc system: orc:orchestrate, orc:backlog, orc:autoresearch, orc:status, orc:recap, orc:scope, orc:handoff.