Files
roboco/docs/rag/architecture/escalation-chain.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

1.7 KiB

Escalation Chain Reference

Complete escalation mapping for all agents.

Chain Overview

Cell Members → Cell PM → Main PM → Product Owner → CEO

Full Mapping

Agent Escalates To
be-dev-1 be-pm
be-dev-2 be-pm
be-qa be-pm
be-doc be-pm
fe-dev-1 fe-pm
fe-dev-2 fe-pm
fe-qa fe-pm
fe-doc fe-pm
ux-dev-1 ux-pm
ux-dev-2 ux-pm
ux-qa ux-pm
ux-doc ux-pm
be-pm main-pm
fe-pm main-pm
ux-pm main-pm
main-pm product-owner
product-owner ceo
head-marketing ceo
auditor ceo

Cell PM for Team

Team Cell PM
backend be-pm
frontend fe-pm
ux_ui ux-pm

Escalation Tool

escalate_up(
    task_id="uuid-here",
    reason="Need clarification on requirements"
)

Auto-routes to your escalation target. You CANNOT choose a different target. escalate_up is a PM verb (Cell PM / Main PM); cell members (devs, QA, documenters) signal blockers with i_am_blocked(task_id, reason), which their Cell PM resolves.

CEO Escalation (Main PM / Board Only)

escalate_to_ceo(
    task_id="uuid-here",
    reason="Major feature ready for approval"
)

Requirements:

  • Task in awaiting_pm_review
  • PR exists
  • Only Main PM, Product Owner, or Head of Marketing can call this (Cell PMs cannot — they escalate_up to Main PM first)

Cannot Skip Levels

System enforces chain:

  • Developer CANNOT escalate directly to Main PM
  • Cell PM CANNOT escalate directly to CEO
  • Each level must acknowledge and decide