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.

docs/rag/architecture/tool-permissions.md

@@ -10,37 +10,25 @@ Agents call gateway verbs through three MCP servers, scoped per role:
 | `roboco-do` | Content/write verbs (commit, note, say, dm, notify, evidence) |
 | `roboco-git-readonly` | Read-only git inspection (status, log, diff, branch_list) |
 
-Native shell git is blocked by the bash-guard hook for everyone. There is
-**no** `roboco_git_commit / _push / _create_pr / _merge_pr / _checkout`
-tool — write operations happen through the lifecycle verbs and the
-choreographer handles git as a side-effect.
+Native shell git is blocked by the bash-guard hook for everyone. There is **no** `roboco_git_commit / _push / _create_pr / _merge_pr / _checkout` tool — write operations happen through the lifecycle verbs and the choreographer handles git as a side-effect.
 
-The canonical source of role → verb mapping is
-`roboco/services/gateway/role_config.py`. The tables below summarise it.
+The canonical source of role → verb mapping is `roboco/services/gateway/role_config.py`. The tables below summarise it.
 
 ## Developer
 
-**Flow verbs (roboco-flow):**
-`give_me_work`, `i_will_work_on`, `open_pr`, `i_am_done`,
-`i_am_blocked`, `unclaim`, `resume`, `i_am_idle`
+**Flow verbs (roboco-flow):** `give_me_work`, `i_will_work_on`, `open_pr`, `i_am_done`, `i_am_blocked`, `unclaim`, `resume`, `i_am_idle`
 
-**Content verbs (roboco-do):**
-`commit`, `note`, `say`, `dm`, `evidence`
+**Content verbs (roboco-do):** `commit`, `note`, `say`, `dm`, `evidence`
 
-**Read-only git (roboco-git-readonly):** all 4 (`status`, `log`, `diff`,
-`branch_list`)
+**Read-only git (roboco-git-readonly):** all 4 (`status`, `log`, `diff`, `branch_list`)
 
-**Workspace writes:** `Write` / `Edit` in
-`/data/workspaces/{project}/{team}/{agent-id}/` only.
+**Workspace writes:** `Write` / `Edit` in `/data/workspaces/{project}/{team}/{agent-id}/` only.
 
 ## QA
 
-**Flow verbs:**
-`give_me_work`, `claim_review`, `pass`, `fail`, `unclaim`, `resume`,
-`i_am_idle`
+**Flow verbs:** `give_me_work`, `claim_review`, `pass`, `fail`, `unclaim`, `resume`, `i_am_idle`
 
-**Content verbs:**
-`note`, `say`, `dm`, `evidence` (no `commit` — QA does not write code)
+**Content verbs:** `note`, `say`, `dm`, `evidence` (no `commit` — QA does not write code)
 
 **Read-only git:** all 4
 
@@ -48,27 +36,19 @@ The canonical source of role → verb mapping is
 
 ## Documenter
 
-**Flow verbs:**
-`give_me_work`, `claim_doc_task`, `i_documented`, `unclaim`, `resume`,
-`i_am_idle`
+**Flow verbs:** `give_me_work`, `claim_doc_task`, `i_documented`, `unclaim`, `resume`, `i_am_idle`
 
-**Content verbs:**
-`commit`, `note`, `say`, `dm`, `evidence`
+**Content verbs:** `commit`, `note`, `say`, `dm`, `evidence`
 
 **Read-only git:** all 4
 
-**Workspace writes:** docs files inside the agent's own workspace
-(`/data/workspaces/{project}/{team}/{agent-id}/`).
+**Workspace writes:** docs files inside the agent's own workspace (`/data/workspaces/{project}/{team}/{agent-id}/`).
 
 ## Cell PM
 
-**Flow verbs:**
-`give_me_work`, `i_will_plan`, `delegate`, `submit_up`, `triage`,
-`unblock`, `complete`, `escalate_up`, `unclaim`, `resume`, `i_am_idle`
+**Flow verbs:** `give_me_work`, `i_will_plan`, `delegate`, `submit_up`, `triage`, `unblock`, `complete`, `escalate_up`, `unclaim`, `resume`, `i_am_idle`
 
-**Content verbs:**
-`note`, `say`, `dm`, `notify`, `evidence` (no `commit` — PMs delegate
-code; merging the leaf PR happens automatically inside `complete`)
+**Content verbs:** `note`, `say`, `dm`, `notify`, `evidence` (no `commit` — PMs delegate code; merging the leaf PR happens automatically inside `complete`)
 
 **Read-only git:** all 4
 
@@ -76,18 +56,13 @@ code; merging the leaf PR happens automatically inside `complete`)
 
 ## Main PM
 
-**Flow verbs:**
-`give_me_work`, `i_will_plan`, `delegate`, `triage_all`, `unblock`,
-`complete`, `escalate_up`, `escalate_to_ceo`, `unclaim`, `resume`,
-`i_am_idle`
+**Flow verbs:** `give_me_work`, `i_will_plan`, `delegate`, `triage_all`, `unblock`, `complete`, `escalate_up`, `escalate_to_ceo`, `unclaim`, `resume`, `i_am_idle`
 
-**Content verbs:**
-`note`, `say`, `dm`, `notify`, `evidence`
+**Content verbs:** `note`, `say`, `dm`, `notify`, `evidence`
 
 **Read-only git:** all 4
 
-**Workspace writes:** none. `complete` on a root parent task opens the
-master PR via the choreographer and escalates to CEO.
+**Workspace writes:** none. `complete` on a root parent task opens the master PR via the choreographer and escalates to CEO.
 
 ## Board (Product Owner, Head of Marketing)
 
@@ -101,8 +76,7 @@ master PR via the choreographer and escalates to CEO.
 
 **Flow verbs:** `triage`, `i_am_idle`  (read-only)
 
-**Content verbs:** `note` (scope=reflect), `evidence`  (no `say` / `dm`
-— Auditor observes silently)
+**Content verbs:** `note` (scope=reflect), `evidence`  (no `say` / `dm` — Auditor observes silently)
 
 **Read-only git:** none.
 
@@ -123,5 +97,4 @@ master PR via the choreographer and escalates to CEO.
 | `roboco_git_*` (read-only) | ✓ | ✓ | ✓ | ✓ | ✓ | — | — |
 | `Write` / `Edit` (own workspace) | ✓ | ✓ | — | — | — | — | — |
 
-**CEO** is human and never inside an agent container; the panel runs as
-the CEO via `X-Agent-Role: ceo` against the orchestrator API directly.
+**CEO** is human and never inside an agent container; the panel runs as the CEO via `X-Agent-Role: ceo` against the orchestrator API directly.