Files
roboco/docs/rag/architecture/org-structure.md
T
Renn F f48106cbb6 docs: reflow hard-wrapped prose to one line per paragraph
Markdown and editors soft-wrap on their own, so the manual ~75-char line
breaks across the docs added nothing but noise. Join wrapped prose, list
items, and paragraphs into single lines across 67 docs — README, CLAUDE.md,
deployment, usage, the RAG knowledge base, and the agent role prompts.
Whitespace-only: code fences, tables, and blockquote alerts are byte-identical
and the change is token-verified (no content altered). Applied with a
deterministic reflow tool (committed separately).

Also lands two doc edits that were awaiting commit: the measured under-load
resource numbers in usage.md and the pr_reviewer additions to the
org-structure RAG doc.
2026-06-16 23:18:55 +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 Prompter and Secretary.

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