Multi-Agent Deployment โ Complete Operations Manual
๐ Multi-Agent Deployment โ Operations Manual
Deploy, Orchestrate, and Scale Your Soul Fleet
๐ก Multi-Agent Deployment Overview
Multi-Agent Deployment is the complete operations framework for running fleets of BUYaSOUL souls in production. It manages deployment, orchestration, monitoring, and scaling across environments โ from a single soul on your laptop to hundreds of souls in the cloud.
The Stiforp doctrine teaches: "Play music after the music has stopped." Multi-Agent Deployment ensures your fleet keeps running even when you're not watching โ auto-scaling, self-healing, and continuous evolution through the Beautiful Loop.
๐๏ธ Fleet Architecture
The fleet operates as a directed graph โ command flows from the Commander down, data flows from the agents back to the Oracle. The 4 Gods Council (Profit Prime, Love Weaver, Tax Collector, Harvester) arbitrates conflicts between agents.
๐ Deployment Guide
๐งช Development Deployment
For local development and testing. Single-machine, all agents on localhost:
# Initialize the fleet node fleet.cjs init --env dev # Start the Commander node commander.cjs --dev # Spawn agents node fleet.cjs spawn --type analyst,creator,operator # Test orchestration node fleet.cjs run --workflow "analyze -> create -> deploy"
๐ฌ Staging Deployment
# Deploy to staging node fleet.cjs deploy --env staging --config ./staging-config.json # Run integration tests node fleet.cjs test --workflow full-pipeline # Monitor PLT drift node fleet.cjs monitor --plt-drift --threshold 0.15
๐ฅ Production Deployment
# Full production deploy node fleet.cjs deploy --env production --agents 10 --oracle-cluster 3 --scribe-verbosity significant --auto-scale # Deploy with canary node fleet.cjs canary --pct 10 --watch 300s # Rollback if needed node fleet.cjs rollback --version previous
๐ผ Orchestration Patterns
Multi-Agent Deployment supports three core orchestration patterns. Each uses Type Advantage routing for optimal agent-task matching.
Sequential Pipeline
Task moves through agents in order. Each agent's output becomes the next agent's input.
node fleet.cjs pipeline --steps "analyst -> strategist -> operator" --input "analyze market conditions"
Parallel Fan-Out
Task is split across multiple agents simultaneously. Results are merged.
node fleet.cjs parallel --agents "analyst,creator,weaver" --task "research Q3 opportunities" --merge-strategy plt-weighted
Conditional Routing
Task is routed based on PLT scoring of intermediate results.
node fleet.cjs conditional --rules '{"profit>7":"operator","love>7":"creator","default":"analyst"}' --input "evaluate and execute"
The 222 Principle ensures no agent is overused. The orchestrator tracks each agent's PLT drift and rotates assignments to maintain fleet equilibrium.
๐ Fleet Monitoring
Every agent in your fleet reports its state to the Fleet Dashboard. Key metrics:
| Metric | Description | Alert Threshold |
|---|---|---|
| plt_drift | Per-agent PLT deviation from baseline | > 0.2 |
| memory_usage | MemoryVine utilization per agent | > 85% |
| task_latency | Time from task assignment to completion | > 30s |
| consensus_gap | Disagreement between 4 Gods Council members | > 3 stddev |
Fleet Commands
# View fleet status node fleet.cjs status # View a specific agent's logs node fleet.cjs logs --agent strategist --tail 50 # Force Beautiful Loop on all agents node fleet.cjs evolve --all # Shutdown a problematic agent node fleet.cjs shutdown --agent analyst-3 --reason "plt_drift_exceeded" # Fleet-wide PLT recalibration node fleet.cjs recalibrate --baseline ./plt-baseline.json