mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
109 lines
3.0 KiB
Markdown
109 lines
3.0 KiB
Markdown
# RoboCo
|
|
|
|
AI Agents Company - A virtual organization of 18 AI agents + 1 human CEO, designed to operate as a complete software development workforce.
|
|
|
|
## Overview
|
|
|
|
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/
|
|
├── src/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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
1. **Everything is a task** - All work is tracked and documented
|
|
2. **No work without a task** - Create task record first
|
|
3. **No task without acceptance criteria** - How do we know it's done?
|
|
4. **No closure without documentation** - Future agents need context
|
|
5. **Communication is constant** - Stream reasoning, log everything
|
|
6. **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)
|
|
- [x] Data models (Pydantic)
|
|
- [x] Database ORM (SQLAlchemy)
|
|
- [x] Configuration management
|
|
- [x] Agent blueprints (16 agents)
|
|
- [x] Task templates
|
|
- [ ] Messaging API
|
|
- [ ] Task API
|
|
- [ ] Agent orchestration
|
|
|
|
## License
|
|
|
|
MIT
|