# rennf93/roboco architecture

> Architecture diagram of the GitHub repository rennf93/roboco, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rennf93/roboco
- Repository: https://github.com/rennf93/roboco

## Overview

RoboCo is a virtual AI software-development company, operated by a human CEO through a control panel. Its main loop is task intake and Board review, CEO approval, Main PM decomposition and cell delegation, implementation and QA, then PR review and a final CEO merge decision. The repository also exposes operational and business capabilities such as agent monitoring, knowledge search, A2A communication, auditing, and video/social workflows. The README documents the workflow; the source index and excerpts provide only partial backend wiring, so unsampled panel/API links are shown as unverified where appropriate.

Main entry points: [`panel/src/app/(dashboard)/layout.tsx`](https://github.com/rennf93/roboco/blob/master/panel/src/app/(dashboard)/layout.tsx) (Control Panel), [`roboco/runtime/orchestrator.py`](https://github.com/rennf93/roboco/blob/master/roboco/runtime/orchestrator.py) (Agent Orchestrator), [`roboco/api/app.py`](https://github.com/rennf93/roboco/blob/master/roboco/api/app.py) (HTTP API), [`roboco/api/routes/tasks.py`](https://github.com/rennf93/roboco/blob/master/roboco/api/routes/tasks.py) (Task API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control Panel"]
  node_panel["Control Panel<br/>[layout.tsx]"]
  node_tasks_ui["Task Workspace<br/>[task-table.tsx]"]
  node_approvals_ui["Approval Queue"]
  node_agents_ui["Agent Monitor"]
  node_knowledge_ui["Knowledge Browser"]
end

subgraph group_api["API and Domain"]
  node_api_app["HTTP API<br/>[app.py]"]
  node_task_routes["Task API<br/>[tasks.py]"]
  node_task_domain["Task Lifecycle<br/>[task_lifecycle.py]"]
  node_project_service["Project and Git<br/>[project.py]"]
  node_database[("Domain Database<br/>[tables.py]")]
end

subgraph group_execution["Agent Execution"]
  node_identity["Agent Identity<br/>[identity.py]"]
  node_orchestrator["Agent Orchestrator<br/>[orchestrator.py]"]
  node_agent_sdk["Agent Runtime<br/>[server.py]"]
  node_llm["Model Providers<br/>[openrouter.py]"]
end

subgraph group_operations["Operations and Content"]
  node_notifications["Notifications"]
  node_a2a["Agent Messaging<br/>[a2a.py]"]
  node_knowledge["Knowledge Search<br/>[search_server.py]"]
  node_auditor["Quality Audit<br/>[flow_auditor.py]"]
  node_content_engines["Video and Social<br/>[video_engine.py]"]
end

node_ceo(("Human CEO"))

node_ceo -->|"operates"| node_panel
node_panel -->|"opens tasks"| node_tasks_ui
node_panel -->|"reviews work"| node_approvals_ui
node_panel -.->|"monitors fleet"| node_agents_ui
node_panel -.->|"searches knowledge"| node_knowledge_ui
node_tasks_ui -.->|"requests API"| node_api_app
node_approvals_ui -.->|"requests API"| node_api_app
node_api_app -->|"mounts routes"| node_task_routes
node_task_routes -->|"enforces lifecycle"| node_task_domain
node_task_routes -->|"reads and writes"| node_database
node_task_routes -.->|"uses projects"| node_project_service
node_project_service -->|"reads and writes"| node_database
node_task_domain -->|"starts approved work"| node_orchestrator
node_orchestrator -->|"resolves roles"| node_identity
node_orchestrator -.->|"spawns agents"| node_agent_sdk
node_orchestrator -.->|"selects provider"| node_llm
node_orchestrator -.->|"notifies CEO"| node_notifications
node_api_app -->|"mounts routes"| node_a2a
node_api_app -->|"mounts routes"| node_auditor
node_panel -.->|"uses messaging"| node_a2a
node_panel -.->|"queries search"| node_knowledge
node_panel -.->|"views content work"| node_content_engines

click node_panel "https://github.com/rennf93/roboco/blob/master/panel/src/app/(dashboard)/layout.tsx"
click node_tasks_ui "https://github.com/rennf93/roboco/blob/master/panel/src/components/tasks/task-table.tsx"
click node_approvals_ui "https://github.com/rennf93/roboco/blob/master/panel/src/components/dashboard/ceo-approval-queue.tsx"
click node_agents_ui "https://github.com/rennf93/roboco/blob/master/panel/src/components/agents/agents-fleet-view.tsx"
click node_knowledge_ui "https://github.com/rennf93/roboco/blob/master/panel/src/components/knowledge-base/knowledge-base-browser.tsx"
click node_api_app "https://github.com/rennf93/roboco/blob/master/roboco/api/app.py"
click node_task_routes "https://github.com/rennf93/roboco/blob/master/roboco/api/routes/tasks.py"
click node_task_domain "https://github.com/rennf93/roboco/blob/master/roboco/enforcement/task_lifecycle.py"
click node_project_service "https://github.com/rennf93/roboco/blob/master/roboco/services/project.py"
click node_database "https://github.com/rennf93/roboco/blob/master/roboco/db/tables.py"
click node_identity "https://github.com/rennf93/roboco/blob/master/roboco/foundation/identity.py"
click node_orchestrator "https://github.com/rennf93/roboco/blob/master/roboco/runtime/orchestrator.py"
click node_agent_sdk "https://github.com/rennf93/roboco/blob/master/roboco/agent_sdk/server.py"
click node_llm "https://github.com/rennf93/roboco/blob/master/roboco/llm/providers/openrouter.py"
click node_notifications "https://github.com/rennf93/roboco/blob/master/roboco/services/notification_delivery.py"
click node_a2a "https://github.com/rennf93/roboco/blob/master/roboco/api/routes/a2a.py"
click node_knowledge "https://github.com/rennf93/roboco/blob/master/roboco/mcp/search_server.py"
click node_auditor "https://github.com/rennf93/roboco/blob/master/roboco/api/routes/v1/flow_auditor.py"
click node_content_engines "https://github.com/rennf93/roboco/blob/master/roboco/services/video_engine.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_panel,node_tasks_ui,node_approvals_ui,node_agents_ui,node_knowledge_ui toneBlue
class node_api_app,node_task_routes,node_task_domain,node_project_service,node_database toneAmber
class node_identity,node_orchestrator,node_agent_sdk,node_llm toneMint
class node_notifications,node_a2a,node_knowledge,node_auditor,node_content_engines toneRose
class node_ceo toneIndigo
```

## Components

### Control Panel

- [Control Panel](https://github.com/rennf93/roboco/blob/master/panel/src/app/(dashboard)/layout.tsx): `panel/src/app/(dashboard)/layout.tsx`
- [Task Workspace](https://github.com/rennf93/roboco/blob/master/panel/src/components/tasks/task-table.tsx): `panel/src/components/tasks/task-table.tsx`
- [Approval Queue](https://github.com/rennf93/roboco/blob/master/panel/src/components/dashboard/ceo-approval-queue.tsx): `panel/src/components/dashboard/ceo-approval-queue.tsx`
- [Agent Monitor](https://github.com/rennf93/roboco/blob/master/panel/src/components/agents/agents-fleet-view.tsx): `panel/src/components/agents/agents-fleet-view.tsx`
- [Knowledge Browser](https://github.com/rennf93/roboco/blob/master/panel/src/components/knowledge-base/knowledge-base-browser.tsx): `panel/src/components/knowledge-base/knowledge-base-browser.tsx`

### API and Domain

- [HTTP API](https://github.com/rennf93/roboco/blob/master/roboco/api/app.py): `roboco/api/app.py`
- [Task API](https://github.com/rennf93/roboco/blob/master/roboco/api/routes/tasks.py): `roboco/api/routes/tasks.py`
- [Task Lifecycle](https://github.com/rennf93/roboco/blob/master/roboco/enforcement/task_lifecycle.py): `roboco/enforcement/task_lifecycle.py`
- [Project and Git](https://github.com/rennf93/roboco/blob/master/roboco/services/project.py): `roboco/services/project.py`
- [Domain Database](https://github.com/rennf93/roboco/blob/master/roboco/db/tables.py): `roboco/db/tables.py`

### Agent Execution

- [Agent Identity](https://github.com/rennf93/roboco/blob/master/roboco/foundation/identity.py): `roboco/foundation/identity.py`
- [Agent Orchestrator](https://github.com/rennf93/roboco/blob/master/roboco/runtime/orchestrator.py): `roboco/runtime/orchestrator.py`
- [Agent Runtime](https://github.com/rennf93/roboco/blob/master/roboco/agent_sdk/server.py): `roboco/agent_sdk/server.py`
- [Model Providers](https://github.com/rennf93/roboco/blob/master/roboco/llm/providers/openrouter.py): `roboco/llm/providers/openrouter.py`

### Operations and Content

- [Notifications](https://github.com/rennf93/roboco/blob/master/roboco/services/notification_delivery.py): `roboco/services/notification_delivery.py`
- [Agent Messaging](https://github.com/rennf93/roboco/blob/master/roboco/api/routes/a2a.py): `roboco/api/routes/a2a.py`
- [Knowledge Search](https://github.com/rennf93/roboco/blob/master/roboco/mcp/search_server.py): `roboco/mcp/search_server.py`
- [Quality Audit](https://github.com/rennf93/roboco/blob/master/roboco/api/routes/v1/flow_auditor.py): `roboco/api/routes/v1/flow_auditor.py`
- [Video and Social](https://github.com/rennf93/roboco/blob/master/roboco/services/video_engine.py): `roboco/services/video_engine.py`

### Other components

- **Human CEO**

## Connections

- Human CEO → Control Panel: operates (evidence: `README.md`)
- Control Panel → Task Workspace: opens tasks (evidence: `README.md`)
- Control Panel → Approval Queue: reviews work (evidence: `README.md`)
- Control Panel → Agent Monitor: monitors fleet
- Control Panel → Knowledge Browser: searches knowledge
- Task Workspace → HTTP API: requests API
- Approval Queue → HTTP API: requests API
- HTTP API → Task API: mounts routes (evidence: `roboco/api/app.py`)
- Task API → Task Lifecycle: enforces lifecycle (evidence: `roboco/api/routes/tasks.py`)
- Task API → Domain Database: reads and writes (evidence: `roboco/api/routes/tasks.py`)
- Task API → Project and Git: uses projects
- Project and Git → Domain Database: reads and writes (evidence: `roboco/services/project.py`)
- Task Lifecycle → Agent Orchestrator: starts approved work (evidence: `README.md`)
- Agent Orchestrator → Agent Identity: resolves roles (evidence: `roboco/runtime/orchestrator.py`)
- Agent Orchestrator → Agent Runtime: spawns agents
- Agent Orchestrator → Model Providers: selects provider
- Agent Orchestrator → Notifications: notifies CEO
- HTTP API → Agent Messaging: mounts routes (evidence: `roboco/api/app.py`)
- HTTP API → Quality Audit: mounts routes (evidence: `roboco/api/app.py`)
- Control Panel → Agent Messaging: uses messaging
- Control Panel → Knowledge Search: queries search
- Control Panel → Video and Social: views content work