sdlc-orchestrate

/sdlc-orchestrate

Perform one stateless orchestration sweep of all AgentFlow projects.

This is a ONE-SHOT command. It reads state, makes decisions, updates the Kanban board, and exits. It does NOT run continuously. Durability comes from invoking this via real crontab:

# Default (every 15 min, ~$48/day):
*/15 * * * * ~/.claude/sdlc/agentflow-cron.sh >> /tmp/agentflow-orchestrate.log 2>&1

# Sprint mode (every 5 min, use during active dev only):
# */5 * * * * ~/.claude/sdlc/agentflow-cron.sh >> /tmp/agentflow-orchestrate.log 2>&1

Mode Detection

Detect whether running in plugin mode or standalone mode at startup:

1. Check if SendMessage and TeamCreate tools are available in the current environment
2. Check if the plugin manifest (plugin.json) is loaded

Condition	Mode	Behavior
SendMessage + TeamCreate available	Plugin	Use team management and message dispatch
Tools not available	Standalone	Fall back to slot-based terminal instructions (original behavior)

Set MODE = "plugin" or MODE = "standalone" and log it at sweep start.

Team Management (Plugin Mode Only)

When MODE = "plugin", the orchestrator manages worker agents directly instead of relying on terminal slots.

Spawning Workers

Use TeamCreate to spin up worker agents as needed:

TeamCreate:
  name: "sdlc-worker-T<N>"
  skill: "sdlc-worker"
  args: "--slot T<N>"

Rules:

• Spawn workers on-demand when tasks are ready for dispatch (Step 6)
• Maximum 4 concurrent workers (T2, T3, T4, T5) — matching the slot system
• Track active workers in sweep state: { slot: "T2", agentId: "<id>", taskCode: "PROJ-003" }
• Do NOT pre-spawn idle workers — only create when a task needs dispatch
• If a worker agent exits or becomes unresponsive (no heartbeat for 10 min), mark the slot as available

Worker Lifecycle

Event	Action
Task ready for dispatch	TeamCreate a new worker for the assigned slot
Worker completes stage	Worker self-terminates; slot becomes available
Worker unresponsive (>10 min)	Log warning, mark slot available, task eligible for re-dispatch
All tasks done	No workers running — zero cost when idle