Skill: subagent-setup — Multi-Harness Subagent Configuration

Manages and synchronizes autonomous subagent roles across all four supported execution harnesses:

1. Claude Code (.claude/agents/*.md)
2. Google Antigravity (~/.gemini/config/agents/*.json)
3. OpenCode (.opencode/agents/*.md)
4. ChatGPT Codex CLI (.codex/agents/*.toml & .codex/agents/*.md)

Single Source of Truth: .aos/pipeline.json (compatible with AO Orchestrator Pipeline Wizard).

---

1. Models

AOS pins no model. Agents inherit the session model on every harness. A model is written only when .aos/pipeline.json sets one for that role and harness, as a free-form string passed through verbatim. Shape, per-harness examples and the aos-doctor format check: docs/agent-models.md.

---

2. CLI Usage

View Current Pipeline Status

node skills/global_config/subagent-setup/scripts/setup-subagents.mjs --show

Initialize Default Pipeline Configuration

node skills/global_config/subagent-setup/scripts/setup-subagents.mjs --init-default

Update a Specific Role

# Example: Set Reviewer to an external CLI harness with a lightweight model
node skills/global_config/subagent-setup/scripts/setup-subagents.mjs \
  --set-role reviewer --harness codex --model <model-id>

# Example: Set Shipping to OpenCode with Free Tier
node skills/global_config/subagent-setup/scripts/setup-subagents.mjs \
  --set-role godmode_shipping --harness opencode --model <model-id>

# Example: Enable or Disable a Role
node skills/global_config/subagent-setup/scripts/setup-subagents.mjs --set-role godmode_media_eventtech --enable
# Role keys are the agent slugs with "-" as "_"; the old short keys (shipping, ui_ux, ...) are still accepted and rewritten.

Synchronize to All Harnesses

node skills/global_config/subagent-setup/scripts/setup-subagents.mjs --sync

---

3. Integration with aos-project-init & AO Orchestrator

• AO Orchestrator (Port 3101): The Pipeline Wizard (Schritt 3 von 4: Agenten & Rollen) directly reads and writes .aos/pipeline.json.
• aos-project-init: Offers subagent configuration during project interview, with no model pinned by default.

---

4. Running an installed copy

The script imports the AOS installer.js module. In a repo checkout it finds it by relative path. An installed copy (~/.agents/skills/subagent-setup/scripts/) has no repo around it: set AOS_HOME to the AOS package folder (the one that contains installer.js), or install @hybridlabor-api/aos globally. Without either it exits with code 2 and lists the paths it tried.