ucsahinn/agentchef / plugins/agentchef/skills/team-conductor
team-conductor
VerifiedOrchestrate AgentChef team runs ("takım koşusu", run with `beyin takim`) from Claude Code with Codex workers sized to live capacity, explicit user gates, isolated worktrees, and verified integration.
Team Conductor
Read the run protocol before operating a team run.
This skill is explicit-only. Team mode is available on every install from
AgentChef 1.6.0. Set AGENTCHEF_TEAM_MODE=off to switch team execution off for
a process; this skill never changes this variable for you.
Start and merge approvals are written only by the dual-agent-brain (Beyin) chat
hook, and only for Beyin's board. When Beyin is installed (~/.beyin/vault.txt
exists), run every engine command as beyin takim <command> ... instead of
node scripts/team-run.mjs; it supplies Beyin's board, creates it when missing,
and opens the run and worker panels. Without Beyin, doctor reports a failing
approval-writer check: say that team runs need dual-agent-brain and stop.
"Takım koşusu" (also "takım koştur", "işçi koştur", "team run") means this
skill and beyin takim. Do not substitute the Claude Code Workflow tool or a
fan-out of in-session subagents for it. Use the Workflow tool only when the
work cannot run as a team run (no Codex login, no Beyin, or the user names the
Workflow tool), and say which reason applies in one line before starting.
- Run
doctor. If theexecutioncheck fails, explain thatAGENTCHEF_TEAM_MODE=offswitches team execution off for this process and stop. Never change the variable for the user. - Split the request into as many independent tasks as the work needs. The
number of workers running at once follows the live capacity
recommendation (
beyin kapasite; without Beyin, free RAM at 1.5 GB per worker), with a hard ceiling of 8;planrecords it undercapacity. If the user asks for more, pass--max-workers <n>;planrefuses a number above the recommendation and quotes the measured reason. Show that reason and do not retry around it. A recommendation of 0 refuses the plan; pass--max-workers 1only when the user explicitly asks to run one worker at a time anyway (recorded ascapacity.ownerOverride).startmeasures again: the cap can only go down, and a recommendation of 0 without that override refuses the start without consuming the approval. Write oneagent-briefper worker and check each withnpm run coordination:board -- brief-check --brief-file <file> --json. Choose roles from the allowlist in the team-mode catalog and default to a read-only role. Fan-out rule: one worker per independent write scope; run two or more workers only when their write scopes are disjoint and no task needs another task's output; put dependent work in a later run. A change that touches one file stays with one worker. Tell an implementing role to change code, not only diagnose it. - Run
plan. If the repository has uncommitted changes, add--snapshot: workers start from a private snapshot commit (refs/agentchef/snapshots/<runId>) and the user's branch, index and files stay untouched. Never commit, stash or clean the user's work to make the tree clean. Show the plan and worker table, then ask the user to send the exact chat sentencebaslat <runId>. Never create or edit an approval file. Ifstartreturns 3, stop and ask again; do not retry around the gate. - Run
start, then pollstatusevery 60-120 seconds. Do not edit worker scopes while they run. Never use taskkill or Stop-Process; useabortonly when the user asks to stop the run. - Run
collect. On exit 4, show partial reports and ask how to proceed. A run whose workers are all read-only ends here with statuscompleted(completion.reason"read-only, reports collected";completion.partialis true when a worker did not finish or its verdict is partial, fail or blocked; runningcollectagain on a completed run recomputes it): show the reports and stop; there is nothing to integrate, verify or merge. Runintegrate; on exit 4, show conflicts and checks and ask how to proceed. - Have the Claude lead inspect the full integration diff against every brief,
then record its passing evidence with
lead-review --review-file <json>. The review must name the exact integration commit. Runverifyon the integration branch; selected routing profiles add their required verifiers to the default test_verifier. Show integration statistics, verification report, and verdict. Ask the user to send the exact chat sentencebirlestir <runId>before runningmerge. mergecreates a merge commit on the user's branch and needs a clean tree.merge --as-patchcreates no commit: it applies the verified diff to the working tree as unstaged changes, aftergit apply --check, and only when the branch is still at the planned commit. A--snapshotrun must use--as-patch, and so must any run where the user did not ask for a commit. Worktrees stay by default. Usecleanup --approvedormerge --cleanup-approvedonly after the user requests that exact cleanup. Push/PR andonayla TASK-xare separate actions and need their own request. If usage limits pause a worker, report it and stop; when the user says the limit has reset, runresume(same plan, same worktrees, each paused worker continues its saved Codex thread);resume --waitwaits for the reset time read from the limit message (or 30 minutes, at most 12 hours) and then resumes. If an integration check fails and you repair the integration branch yourself, commit the repair and runintegrate --recheck; never merge it by hand. If a worker finished without changes (for example it only diagnosed), finish its scope yourself in the integration branch, commit, and runintegrate --recheck --covers TASK-x. Tell implementing roles to change code, not only diagnose it. If the machine slept, crashed or restarted and the run showsrunningwith no supervisor heartbeat, the sameresumerecovers it: orphaned workers continue their saved thread in the same worktree. After abort, run cleanup only if the user asks.
Show the gate-specific command, exit code, affected tasks, and next action at each step. Do not claim a later gate passed when an earlier gate is partial or blocked.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |