| name | cmux-orchestrator |
| description | Оркестратор cmux v3 для Codex: macOS cmux orchestrator, multi-agent terminal workflow, видимый head terminal, typed task envelopes, report-authoritative completion. Используй для: cmux orchestrator, делегируй воркерам. EN triggers: cmux v3 head, visible-terminal orchestration. EN: cmux v3 head. |
cmux-orchestrator
Generated from root config/cmux-adapter-projections.json. Do not edit manually.
Use this skill only when Codex is the machine-identified visible head terminal for rldyour macOS cmux orchestrator mode.
Native Adapter Notes
- Codex may be a visible head or a visible worker when the root run manifest assigns that role.
- Repo-local source remains authority over installed plugin cache projections.
Current Implementation Status
typed-task-report-protocol: IMPLEMENTED.live-start-fail-closed: IMPLEMENTED.compact-template: IMPLEMENTED.workspace-group-topology: PLANNED.delegation-command: PLANNED.worktree-scheduler: PLANNED.adapter-native-projections: IMPLEMENTED.stop-finalization-receipt: PLANNED.
Treat PLANNED and NOT_PROVEN entries as unavailable in production.
Authority
- Root
config/cmux-orchestrator-policy.json owns the protocol and safety rules.
- Root
config/cmux-task.schema.json owns immutable task envelopes.
- Root
config/cmux-worker-report.schema.json owns worker reports.
- Root
config/cmux-implementation-status.json separates implemented behavior from planned target architecture.
- Runtime state belongs under
$(git rev-parse --git-common-dir)/rldyour/cmux/<run-id>/.
- Worker completion authority is
$(git rev-parse --git-common-dir)/rldyour/cmux/<run-id>/tasks/<task-id>/report.json with a valid digest; notifications are UI hints only.
Head Duties
- Verify exactly one visible head terminal is active for the run.
- Use
ry-cmux start only through the root implementation; live starts must fail closed when caller workspace, surface, socket, or doctor evidence is missing.
- Create immutable task envelopes and task-local instructions; never put task text into cmux terminal input.
- Wake workers with a bounded helper command containing only run/task identifiers.
- Collect schema-valid worker reports, verify task/attempt/worker/scope binding, then integrate changes as the head.
- Own final validation, commits, push, tracked Serena context sync, and owner-facing summary.
Forbidden Delegation Patterns
- Do not send arbitrary task prose through cmux input.
- Do not pass write scopes through shell environment snippets.
- Do not treat
read-screen, event streams, or notifications as completion authority.
- Do not let workers push, mutate project policy, run system install, delete branches, or run final sync.
- Do not claim Workspace Groups, isolated worktree scheduling, retry materialization, or durable Stop receipts unless the status registry marks them
IMPLEMENTED.
Worker Wake-Up Shape
The only terminal input sent to a worker is a helper wake-up command with safe identifiers. The task envelope and instructions file remain on disk and are validated by the worker helper before work starts.
