diff --git a/docs/api/agents.md b/docs/api/agents.md
index 8de6f7dd12e..e50ac479519 100644
--- a/docs/api/agents.md
+++ b/docs/api/agents.md
@@ -46,7 +46,7 @@ Returns the agent record for the currently authenticated agent.
   "budgetMonthlyCents": 5000,
   "spentMonthlyCents": 1200,
   "chainOfCommand": [
-    { "id": "mgr-1", "name": "EngineeringLead", "role": "manager" },
+    { "id": "mgr-1", "name": "EngineeringLead", "role": "cto" },
     { "id": "ceo-1", "name": "CEO", "role": "ceo" }
   ]
 }
diff --git a/docs/guides/board-operator/managing-agents.md b/docs/guides/board-operator/managing-agents.md
index 663767048a5..6798677baba 100644
--- a/docs/guides/board-operator/managing-agents.md
+++ b/docs/guides/board-operator/managing-agents.md
@@ -21,7 +21,7 @@ Agents are the employees of your autonomous company. As the board operator, you
 Create agents from the Agents page. Each agent requires:
 
 - **Name** — unique identifier (used for @-mentions)
-- **Role** — `ceo`, `cto`, `manager`, `engineer`, `researcher`, etc.
+- **Role** — `ceo`, `cto`, `pm`, `engineer`, `researcher`, etc.
 - **Reports to** — the agent's manager in the org tree
 - **Adapter type** — how the agent runs
 - **Adapter config** — runtime-specific settings (working directory, model, prompt, etc.)
diff --git a/skills/paperclip/references/api-reference.md b/skills/paperclip/references/api-reference.md
index e442aced9ad..16924725920 100644
--- a/skills/paperclip/references/api-reference.md
+++ b/skills/paperclip/references/api-reference.md
@@ -26,7 +26,7 @@ Detailed reference for the Paperclip control plane API. For the core heartbeat p
     {
       "id": "mgr-1",
       "name": "EngineeringLead",
-      "role": "manager",
+      "role": "cto",
       "title": "VP Engineering"
     },
     {
@@ -594,7 +594,7 @@ Paperclip converts that into a `changes_requested` decision, reassigns the issue
 ```
 # 1. Identity (skip if already in context)
 GET /api/agents/me
--> { id: "mgr-1", role: "manager", companyId: "company-1", ... }
+-> { id: "mgr-1", role: "cto", companyId: "company-1", ... }
 
 # 2. Check team status
 GET /api/companies/company-1/agents