Files
roboco/docs/rag/architecture/org-structure.md
T
Renn F df5e579916 docs: add the full build-session video, count 22 agents, ground resource usage
Add the 2.5-hour 'Working with RoboCo' build session (a conversation to a
shipped feature) as a second hero thumbnail beside the 26-min intro.

Update the agent count from 20 to 22 across the README, CLAUDE.md, usage,
the base agent prompt, the how-to guide, and the org-structure RAG doc:
the standing org gains the PR Reviewer (board-level, read-only), and the
on-demand Intake and Secretary are now counted. The org-structure doc
gains the PR Reviewer in the hierarchy, count table, board team, and
communication matrix. The historical 0.1.0 changelog entry is left as-is.

Rewrite the resource-usage section: drop the unmeasured per-agent RAM
ceiling (RAM is low and agents run few-at-a-time) and lead with storage —
the image set's shared base layer — which is what docker prune reclaims.
2026-06-16 18:12:39 +02:00

2.4 KiB

Organizational Structure

Hierarchy

CEO (Renzo - Human)
    |
    +-- Board (4 agents)
    |    +-- Product Owner
    |    +-- Head of Marketing
    |    +-- Auditor (silent observer)
    |    +-- PR Reviewer (read-only safety check on PRs)
    |
    +-- Main PM
         |
         +-- Backend Cell
         +-- Frontend Cell
         +-- UX/UI Cell

Agent Count

Role Count
CEO 1 (human — not counted in the 22)
Product Owner 1
Head of Marketing 1
Auditor 1
PR Reviewer 1
Main PM 1
Cell PMs 3
Developers 6 (2 per cell)
QAs 3 (1 per cell)
Documenters 3 (1 per cell)
Prompter (Intake) 1 (on-demand)
Secretary 1 (on-demand)
Total AI agents 22

On-Demand Roles (Human-Facing)

Two of the 22 — the Prompter (Intake) and the Secretary — sit outside the standing delivery org above. They are human-only and spawned on demand as live chat sessions; they are counted among the 22, but unlike the standing org they have no lifecycle verbs and no outward agent comms:

Role Purpose
Prompter (Intake) Interviews the CEO and drafts a board-ready task
Secretary The CEO's chief-of-staff; reads company state and runs gated CEO directives

Neither has lifecycle verbs or outward agent comms. See docs/rag/roles/prompter.md and docs/rag/roles/secretary.md.

Cells

Cell PM Developers QA Documenter
Backend be-pm be-dev-1, be-dev-2 be-qa be-doc
Frontend fe-pm fe-dev-1, fe-dev-2 fe-qa fe-doc
UX/UI ux-pm ux-dev-1, ux-dev-2 ux-qa ux-doc

Teams

Team Members
executive ceo
board product-owner, head-marketing, auditor, pr-reviewer-1
management main-pm, be-pm, fe-pm, ux-pm
developers all devs
qa all QAs
documentation all documenters

Escalation Chain

Developer/QA/Documenter → Cell PM → Main PM → Product Owner → CEO

Communication

Each role can communicate with:

Role Can Communicate With
CEO Everyone
Board CEO, other board, Main PM
Auditor Everyone (silent read all)
PR Reviewer Read-only; posts one change-request on the PR itself, no agent comms
Main PM CEO, Board, Cell PMs
Cell PM Main PM, cell members
Cell Members Cell PM, other cell members