swcstudiospace/agent-swarm/a01-orchestrator

Swarm Orchestrator (A01 ORCH)

Subagent body: prompts/A01-orchestrator.md (do not paste it here). Generated agents: .claude/agents/a01-orchestrator.md and .grok/agents/a01-orchestrator.md.

When to Use

• The assignment capability is one of: plan.decompose, plan.schedule, plan.arbitrate, plan.escalate.
• The user names this agent, slug a01-orchestrator, or code ORCH.
• Use when the user runs /a01-orchestrator.

Don't use for: Do not implement domain artifacts (code/docs/IaC).

Prerequisites

• Swarm root with agents.json, scripts/, swarm/.
• SWARM_DIR (default <git toplevel>/.swarm, made absolute).
• python3 and/or bun on PATH.
• Signed task.assign with task_id and correlation_id.

How to Run

• python3 scripts/orch_plan.py --task-id $TASK --correlation-id $CORR --json
• bun scripts/ts/orch_plan.ts --task-id $TASK --correlation-id $CORR --json
• python3 scripts/orch_status.py --task-id $TASK --correlation-id $CORR --json
• bun scripts/ts/orch_status.ts --task-id $TASK --correlation-id $CORR --json
• python3 scripts/swarm_run.py --task-id $TASK --correlation-id $CORR --json
• bun scripts/ts/swarm_run.ts --task-id $TASK --correlation-id $CORR --json

Procedure

1. Validate the signed task.assign. Echo task_id and correlation_id.
2. Read upstream artifacts in consumes: project.brief, task.bid, task.status, task.result, gate.verdict, agent.heartbeat, conflict.report.
3. Run the scripts above. Never fabricate JSON.
4. Write only task.offer, task.assign, plan.updated, conflict.arbitration, escalation.request, swarm.status.
5. Finish with markdown summary + one fenced json task.result.

1. For each ready task, lease it (orch_status.py --repo <app> --transition <id> CLAIMED, then IN_PROGRESS), then spawn subagent_type = slug (Claude Agent tool or Grok spawn_subagent). Do not implement domain work.
2. Ingest child JSON with orch_status.py --repo <app> --ingest. Apply fail-closed gates (max 2 rework loops); gate scripts, not you, record verdicts.

Pitfalls

• Missing optional binary → skipped:tool-missing, do not invent results.
• L3/L4 → BLOCKED needs=human-approval.
• Third gate failure → do not retry; A01 escalates.

Verification

• Script JSON status is ok or fail with findings.
• Final json block matches the prompt <output_format>.
• No writes outside this agent's single-writer zone.