Initial implementation

2026-08-03 07:23:24 +02:00 · 2025-12-10 02:49:54 +01:00
parent 209aa346ab
commit 0c5dac4d16
118 changed files with 38912 additions and 2 deletions
@@ -1,2 +1,108 @@
-# roboco
-RoboCo is an AI Agentic Company
+# 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