Amcos Agent Spawning

Pre-Flight: Validate OAuth Scopes

gh auth status 2>&1 | grep -q "project" || echo "ERROR: Missing project scope"

Required: repo, project, read:project. If missing, request human to run gh auth refresh -h github.com -s project,read:project. Do NOT proceed if scopes are missing.

Spawn Procedure (PROCEDURE 1)

1. Request GovernanceRequest approval - Submit spawn request to sourceManager via amcos-permission-management skill. BLOCK until approved.
2. Select agent type from roles (Orchestrator, Architect, Integrator, Programmer)
3. Choose session name - Format: <role-prefix>-<project>-<descriptive> (must be unique)
4. Setup plugin - Copy from $HOME/.claude/plugins/cache/ai-maestro/<plugin>/<latest>/ to $HOME/agents/<session>/.claude/plugins/<plugin>/
5. Create instance via ai-maestro-agents-management skill with args: --dangerously-skip-permissions --chrome --add-dir /tmp --plugin-dir <path> --agent <agent-name>
6. Verify agent appears online in agent list
7. Register via uv run python scripts/amcos_team_registry.py add-agent
8. Send welcome message via agent-messaging skill

The --agent Flag

Output

Error Handling

Examples

Spawn a Programmer Agent

# 1. Verify scopes
gh auth status 2>&1 | grep -q "project" && echo "OK"

# 2. Copy plugin
cp -r ~/.claude/plugins/cache/ai-maestro/ai-maestro-programmer-agent/latest/* \
      ~/agents/ampa-svgbbox-impl/.claude/plugins/ai-maestro-programmer-agent/

# 3. Create via ai-maestro-agents-management skill:
#    Name: ampa-svgbbox-impl, Dir: ~/agents/ampa-svgbbox-impl/
#    Args: --agent ai-maestro-programmer-main-agent

# 4. Register + send welcome message

Checklist

Copy this checklist and track your progress:

• Validate OAuth scopes (repo, project, read:project)
• Request GovernanceRequest approval
• Create agent via ai-maestro-agents-management skill
• Register in team registry and send welcome message

Resources