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

92 lines
2.4 KiB
Markdown

# 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 |