RoboCo implements a structured organizational hierarchy with formal communication protocols, task management, and quality controls. The system enables a single human (CEO) to orchestrate complex multi-project development at scale.

CEO (Renzo - Human)
    │
    └── Board (3 agents)
         ├── Product Owner
         ├── Head of Marketing
         └── Auditor (silent observer, reports to CEO)
              │
              └── Main PM (coordinates all cells)
                   │
                   ├── Backend Cell (5 agents: 2 Devs, 1 QA, 1 PM, 1 Documenter)
                   ├── Frontend Cell (5 agents: 2 Devs, 1 QA, 1 PM, 1 Documenter)
                   └── UX/UI Cell (4 agents: 1 Dev, 1 QA, 1 PM, 1 Documenter)

Project Structure

roboco/
├── roboco/              # Main Python package
│   ├── models/              # Pydantic data models
│   ├── db/                  # SQLAlchemy ORM & database
│   ├── api/                 # FastAPI routes (coming soon)
│   └── config.py            # Application configuration
├── agents/blueprints/       # Agent system prompts (16 agents)
├── .tasks/                  # Task management system
│   ├── templates/           # Task templates by type
│   ├── active/              # In-progress tasks
│   ├── completed/           # Archived tasks
│   └── initiatives/         # Multi-task initiatives
├── CLAUDE.md                # Claude Code guidance
└── HOMELAB_TEAM_V0.md       # System blueprint

Quick Start

# Install dependencies
uv sync

# Start PostgreSQL and Redis (Docker)
docker compose up -d

# Run database migrations
uv run alembic upgrade head

# Start the API server
uv run uvicorn roboco.api:app --reload

Development

# Install dev dependencies
uv sync --all-extras

# Run tests
uv run pytest

# Format and lint
uv run ruff format .
uv run ruff check .
uv run mypy src/

Core Principles

Everything is a task - All work is tracked and documented
No work without a task - Create task record first
No task without acceptance criteria - How do we know it's done?
No closure without documentation - Future agents need context
Communication is constant - Stream reasoning, log everything
The Auditor sees all - Quality monitored silently

Technology Stack

Layer	Technology
API Framework	FastAPI
Database	PostgreSQL + SQLAlchemy
Cache/Queue	Redis
Vector DB	Qdrant
LLM	Claude API
Package Manager	uv

Status

Phase 1: Core Services (In Progress)

Data models (Pydantic)
Database ORM (SQLAlchemy)
Configuration management
Agent blueprints (16 agents)
Task templates
Messaging API
Task API
Agent orchestration

License

MIT