Files
roboco/docs/rag/architecture/agent-uuids.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

Agent UUIDs Reference

ALWAYS use SLUGS when assigning tasks. The system resolves slugs to UUIDs automatically.

# CORRECT - Use slug (PMs delegate work)
delegate(assigned_to="be-dev-1", ...)

# WRONG - Don't construct UUIDs manually
delegate(assigned_to="00000000-0000-0000-0001-000000000001", ...)

UUID Scheme (Reference Only)

00000000-0000-0000-{CELL}-00000000000{N}
Cell Code Team
0000 CEO
0001 Backend
0002 Frontend
0003 UX/UI
0004 Board/Management

NO OTHER CELL CODES EXIST. Do not construct UUIDs with codes like 0005, 0006, etc.

Backend Cell (0001)

Slug UUID
be-dev-1 00000000-0000-0000-0001-000000000001
be-dev-2 00000000-0000-0000-0001-000000000002
be-qa 00000000-0000-0000-0001-000000000003
be-pm 00000000-0000-0000-0001-000000000004
be-doc 00000000-0000-0000-0001-000000000005

Frontend Cell (0002)

Slug UUID
fe-dev-1 00000000-0000-0000-0002-000000000001
fe-dev-2 00000000-0000-0000-0002-000000000002
fe-qa 00000000-0000-0000-0002-000000000003
fe-pm 00000000-0000-0000-0002-000000000004
fe-doc 00000000-0000-0000-0002-000000000005

UX/UI Cell (0003)

Slug UUID
ux-dev-1 00000000-0000-0000-0003-000000000001
ux-dev-2 00000000-0000-0000-0003-000000000002
ux-qa 00000000-0000-0000-0003-000000000003
ux-pm 00000000-0000-0000-0003-000000000004
ux-doc 00000000-0000-0000-0003-000000000005

Board/Management (0004)

Slug UUID
main-pm 00000000-0000-0000-0004-000000000001
product-owner 00000000-0000-0000-0004-000000000002
head-marketing 00000000-0000-0000-0004-000000000003
auditor 00000000-0000-0000-0004-000000000004

CEO (0000)

Slug UUID
ceo 00000000-0000-0000-0000-000000000001

Usage

Verbs take the task_id UUID directly (returned by give_me_work() / triage()); recipient/assignee arguments accept either a slug or a UUID:

i_will_work_on(task_id)               # task_id is a UUID
dm(recipient="be-qa", text="...", task_id="...")   # slug recipient
delegate(assigned_to="be-dev-1", ...)              # slug assignee
delegate(assigned_to="00000000-0000-0000-0001-000000000001", ...)  # UUID also works