Use when creating new agents. Trigger with agent spawn requests, pre-flight validation, or new agent creation. Loaded by ai-maestro-chief-of-staff-main-agent
Creates new agent instances with OAuth validation, plugin setup, and registry registration.
ai-maestro-agents-management and agent-messaging skills availableGET /api/teams)Copy this checklist and track your progress:
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.
amcos-permission-management skill. BLOCK until approved.<role-prefix>-<project>-<descriptive> (must be unique)$HOME/.claude/plugins/cache/ai-maestro/<plugin>/<latest>/ to $HOME/agents/<session>/.claude/plugins/<plugin>/ai-maestro-agents-management skill with args: --dangerously-skip-permissions --chrome --add-dir /tmp --plugin-dir <path> --agent <agent-name>uv run python scripts/amcos_team_registry.py add-agentagent-messaging skill| Role | --agent Flag Value |
|---|---|
| Orchestrator | ai-maestro-orchestrator-main-agent |
| Architect | ai-maestro-architect-main-agent |
| Integrator | ai-maestro-integrator-main-agent |
| Programmer | ai-maestro-programmer-main-agent |
| Step | Expected Output |
|---|---|
| Pre-flight | OAuth scopes confirmed |
| Spawn | tmux session created, agent running |
| Registry | Agent registered as "running" |
| Issue | Resolution |
|---|---|
| OAuth scopes missing | Block spawn, request human gh auth refresh |
| Plugin validation failed | Verify cache exists at source path |
| Session name collision | Choose different unique name |
| Resource limit exceeded | Queue request, hibernate oldest idle |
# 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
Copy this checklist and track your progress: