How vivek5200/ouroboros-v7 works
Ouroboros v7.1 coordinates constraint-checked code changes across three specialist agents and their sibling repositories, while a supervised GPU worker runs alongside the orchestrator. The main workflow is intent validation, specialist dispatch, and repository changes; crash detection adds persistent learning and worker recovery. README documentation supplies several relationships and capabilities not visible in the sampled bridge source, so those links reflect documentation rather than inspected call sites. The optional Agent Virtual Office integration is shown separately.
Main entry points: ecc ECC Orchestrator · supervisord.conf Process Supervisor · post_tool_use.py Crash Detection Hook · office_bridge.py Office Bridge
Components 21
Orchestration
- Runtime Launcher
launch.sh - Process Supervisor
docker/supervisord.conf - ECC Orchestrator
bin/ecc - Agent Configuration
.ecc/config.yaml - TDD Specialist
.ecc/config.yaml - Systems Specialist
.ecc/config.yaml - Rust Specialist
.ecc/config.yaml - Agent Reports
.ecc/reports
Constraint Validation
- Codegraph MCP
.mcp/servers/codegraph_server.py - Architectural Laws
memory_seeds/laws.json - Context7 MCP
Execution and Recovery
- Core Repository
- Triton Repository
- DFG Repository
- Triton Worker
bin/ouroboros-worker - Crash Detection Hook
.ecc/hooks/post_tool_use.py - Crash Instincts
Optional Visualization
- Office Bridge
bin/office_bridge.py
Other components
- Engineer
- Ox Alpha API
- Agent Virtual Office
Connections 21
- Engineer → Runtime Launcher: starts runtime
- Runtime Launcher → Process Supervisor: starts processes
- Process Supervisor → ECC Orchestrator: starts orchestrator
- Process Supervisor → Triton Worker: starts and restarts
- ECC Orchestrator → Ox Alpha API: requests model
- ECC Orchestrator → Agent Configuration: loads agents
- ECC Orchestrator → Codegraph MCP: validates constraints
- Codegraph MCP → Architectural Laws: checks laws
- ECC Orchestrator → Context7 MCP: looks up documentation
- ECC Orchestrator → TDD Specialist: dispatches work
- ECC Orchestrator → Systems Specialist: dispatches work
- ECC Orchestrator → Rust Specialist: dispatches work
- TDD Specialist → Core Repository: changes code
- Systems Specialist → Triton Repository: changes code
- Rust Specialist → DFG Repository: changes code
- ECC Orchestrator → Agent Reports: records reports
- Crash Detection Hook → Crash Instincts: records crashes
- Crash Detection Hook → Process Supervisor: triggers restart
- ECC Orchestrator → Office Bridge: pushes status
- Crash Detection Hook → Office Bridge: pushes incidents
- Office Bridge → Agent Virtual Office: posts updates