orchestra
Claude Code · multi-session workflow

Agent Orchestration Stack

How a feature travels from request to production: which skill enters at each stage, which agent does the work, on which model, and in which ponytail mode. Click a skill to see where it shows up in the flow.

Who does what

Main session (orchestrator)

Opens workstreams, sets order and the schema queue, watches machine load and context size, merges PRs, talks to the owner. Writes no code, not even through subagents.

Workstream session

Owns one feature end to end: spec, plan, subagents, reviews, PR. Answers the owner directly on checkpoints and mockups, and reports cross-workstream decisions to the orchestrator in one line.

Subagents

Do one task each (implementer, reviewers, planner, explorer) and never spawn other agents. They get their mode and skills from the briefing.

The life of a workstream

ponytail off lite: does what was asked, flags the simpler option full: smallest change that fully works ultra: cuts what the spec does not ask for
No skill selected.

What each skill does

Grouped by source plugin. Everything here is a public plugin or skill; this stack only decides where each one enters.

How they complement each other

Explore, then execute

frontend-design and taste open up directions in mockups; implementation loads only impeccable, which holds the finish in production code.

Detector before, reviewer after

The impeccable detector cleans a mockup before the owner sees it; impeccable-finish-reviewer compares the shipped screen, from real screenshots, against the approved mockup.

Write the test, prove the result

test-driven-development makes the test fail first; verification-before-completion only allows "done" with the command run and its output in hand.

One failure or many

systematic-debugging works one failure methodically; dispatching-parallel-agents opens one agent per unrelated failure, and checks that parallel tasks touch no shared files.

Think the risk, scan the code

security-audit enters early on sensitive specs and before the PR; claude-security (optional) deep-scans finished code before release.

Lean plan, lean task

The planner uses writing-plans in ponytail ultra to cut what the spec does not ask for, so each implementer gets a task already the right size.

Session rhythm

250k

Tokens. When a wave of tasks closes above this, the workstream writes its handoff note and the orchestrator clears its context, then sends a short briefing back.

600k

Auto-compact safety net (autoCompactWindow), for when nobody checked in time.

2

Tasks at once per workstream, because every workstream shares one machine.

docs/workstreams/

Where each workstream keeps its handoff note, on its own branch, with a fixed template and a clean-session checklist.

Off

Auto-archive on PR close. Archiving a session kills its background agents; keep it off while sessions open spec PRs and keep working.

0

Lines of code leaving the main session. It only orchestrates, merges and talks.