mirror of https://github.com/rennf93/roboco.git synced 2026-08-03 07:23:24 +02:00

Files

T

Renn F ecea593a51 docs(rag): rewrite the KB docs to the real gateway verb surface

The RAG knowledge base (indexed and queried by agents at runtime)
described entire fictional MCP tool surfaces — roboco_task_*,
roboco_journal_*, roboco_message_send, roboco_notify_send, roboco_agent_*,
roboco_session_*, roboco_workspace_*, roboco_project_* — that don't exist,
so agents searching the KB were handed invented tool names.

Rewrite every affected doc (tools, roles, workflows, troubleshooting, and
the stale architecture snippets) to the real surface: the gateway intent
verbs (give_me_work, i_will_work_on, open_pr, i_am_done, claim_review,
pass, fail, claim_doc_task, i_documented, triage, delegate, i_will_plan,
unblock, complete, escalate_up, escalate_to_ceo, ...) and content tools
(commit, note(scope=...), say, dm, evidence, notify*, open_session,
channels). Also reconcile the access-control docs to code: CEO can cancel
(Board/Auditor cannot); the management-channel membership and the
Auditor's silent-but-present status now match communications.py.

2026-06-05 17:20:36 +02:00

2.4 KiB

Raw Blame History

Channel Reference

All available channels with their slugs and access rules.

Cell Channels

Slug	Name	Members
`backend-cell`	Backend Cell	be-dev-1, be-dev-2, be-qa, be-pm, be-doc
`frontend-cell`	Frontend Cell	fe-dev-1, fe-dev-2, fe-qa, fe-pm, fe-doc
`uxui-cell`	UX/UI Cell	ux-dev-1, ux-dev-2, ux-qa, ux-pm, ux-doc

Cross-Cell Channels

Slug	Name	Members
`dev-all`	All Developers	All 6 developers
`qa-all`	All QA	be-qa, fe-qa, ux-qa
`pm-all`	All PMs	be-pm, fe-pm, ux-pm, main-pm
`doc-all`	All Documenters	be-doc, fe-doc, ux-doc

Management Channels

Slug	Name	Members
`main-pm-board`	Main PM & Board	main-pm, product-owner, head-marketing, auditor (all read/write)
`board-private`	Board Private	product-owner, head-marketing, auditor, ceo (read/write) + main-pm (read-only)

Special Channels

Slug	Name	Read	Write
`announcements`	Announcements	Everyone	PM/Board only
`all-hands`	All Hands	Everyone	Everyone

Auditor Silent Access

Auditor has silent read access (in these channels' silent_roles) to:

backend-cell
frontend-cell
uxui-cell
dev-all
qa-all
pm-all
doc-all

Auditor does NOT appear in member lists but CAN read. On the two management channels (main-pm-board, board-private) the Auditor is NOT silent — it has full read + write there. (Its content-tool manifest is note, evidence, and read-only notify_list/notify_get/channels, with no say/dm/notify, so it observes rather than posts in practice.)

Privileged Access

These roles bypass normal membership checks:

CEO: Full access everywhere
Auditor: Silent read on cell + cross-cell channels; read/write on the management channels
Main PM: Read access to all cell channels

Using Channels

# List the channel slugs you can read / write (call this first if unsure of
# a slug — inventing slugs returns "Channel not found")
channels()   # -> {writable: [...], readable: [...]}

# Send a message to your cell
say(
    channel="backend-cell",
    text="Starting work on task",
    task_id=task_id,
)

# Direct agent-to-agent message (same-cell only)
dm(recipient="be-qa", text="Quick sanity check before QA", task_id=task_id)

2.4 KiB Raw Blame History