docs(prompts): teach all roles the structured verb shapes (pre-gateway parity)

Counterpart to bcc748c. The verb signatures now expose structured
fields (approach/options/rationale/what_done/etc), but the role
prompts still showed old flat-string examples — the LLM pattern-
matches prompts before schemas, so it would have kept writing one-
line decisions even after deploy.

Each role's Journaling Cadence table now shows the full call shape
for every scope, with decision and reflect explicitly named as
structured (context/options/chosen/rationale/consequences and
what_done/what_learned/what_struggled/next_steps respectively).

PM prompts also gained:
- `i_will_plan` widened to show approach / technical_considerations /
  risks / open_questions, with an explicit "empty values produce an
  empty Plan tab — a regression" line
- `delegate` shows `nature` (technical/non_technical) and notes the
  sibling-dedup guard
- Cell PM gets the dev-only task_type rule (code/documentation/research)
- Main PM gets the planning-only rule for Cell PM delegations
- `say`/`dm` lists every valid channel slug verbatim so the LLM stops
  inventing ("backend-dev", "backend")

Prompts are read at agent spawn, so this takes effect on the next
container restart — no Python rebuild required. Combined with bcc748c
this is the full pre-gateway-parity restoration.

agents/prompts/roles/main_pm.md

@@ -20,8 +20,8 @@ You merge what your Cell PMs submit (cell PRs into your root branch via `complet
 | Verb | What it does | Preconditions |
 |---|---|---|
 | `give_me_work()` | Returns your highest-priority task (your root in `pending`, or a cell-PM task in `awaiting_pm_review` for you to merge). | None. |
-| `i_will_plan(task_id, plan)` | Claim YOUR root task, record your cell-distribution plan, transition `pending` -> `in_progress`. Always call this before `delegate`. | Task assigned to you; task in `pending`/`needs_revision`. |
-| `delegate(parent_task_id, title, description, assigned_to, team, task_type, acceptance_criteria, estimated_complexity)` | Create a subtask under your root and assign it to a Cell PM (`be-pm`, `fe-pm`, `ux-pm`). One subtask per cell that needs work. | Parent claimed by you and `in_progress`; assignee is a Cell PM slug. |
+| `i_will_plan(task_id, plan, approach?, technical_considerations?, risks?, open_questions?)` | Claim YOUR root task, record your cell-distribution plan, transition `pending` -> `in_progress`. Always call this before `delegate`. **Fill `approach` (2-4 sentences describing your cell distribution), `technical_considerations` (list of strings), `risks` (list of `{risk, mitigation}` dicts), `open_questions` (list of `{question, answered}` dicts).** Empty values produce an empty Plan tab — a regression. | Task assigned to you; task in `pending`/`needs_revision`. |
+| `delegate(parent_task_id, title, description, assigned_to, team, task_type, nature, acceptance_criteria, estimated_complexity)` | Create a subtask under your root and assign it to a Cell PM (`be-pm`, `fe-pm`, `ux-pm`). One subtask per cell that needs work. **`task_type` must be `planning`** (Cell PMs decompose; they don't execute). `nature` ∈ `technical`/`non_technical`. Gateway blocks duplicate sibling delegations (same Cell PM + same task_type under same parent). | Parent claimed by you and `in_progress`; assignee is a Cell PM slug. |
 | `triage_all()` | List blockers and reviews across all cells. | None. |
 | `unblock(task_id, restore=True)` | Resolve a cell-PM task's blocker and return it to its pre-block state. | None. |
 | `complete(task_id, notes)` | For a cell-PM task in `awaiting_pm_review`: merges the cell PR into your root branch. For YOUR root once all cell-PM subtasks are terminal: opens master PR + transitions root to `awaiting_ceo_approval`. | All descendants terminal; journal `decision` recorded. |
@@ -30,7 +30,7 @@ You merge what your Cell PMs submit (cell PRs into your root branch via `complet
 | `unclaim(task_id)` | Release this claim back to pending. Use sparingly — your work-in-progress branch survives but the task is unassigned. | Task assigned to you and in claimed/in_progress. |
 | `resume(task_id)` | Resume a paused task. Transitions paused → in_progress. | Task assigned to you and in paused state. |
 | `note(text, scope?, task_id?)` | Journal. Required: `scope='decision'` before `i_will_plan` / `delegate` / `complete` / `escalate_*`. | None. |
-| `say(channel, text)` / `dm(recipient, text)` | Channel post / DM. Channel slug without `#` (e.g. `"main-pm-board"`). | None. |
+| `say(channel, text)` / `dm(recipient, text)` | Channel post / DM. **Channel slug without `#`. Valid slugs:** cell channels (`backend-cell`, `frontend-cell`, `uxui-cell`), cross-cell (`dev-all`, `qa-all`, `pm-all`, `doc-all`), management (`main-pm-board`, `board-private`), broadcast (`announcements`, `all-hands`). Inventing a slug returns `Channel not found`. | None. |
 | `notify(target, text, priority?)` | Send a formal ack-required notification to an agent (`be-dev-1`, `ceo`, etc.). `priority` is one of `normal`/`high`/`urgent` (default `normal`). | None. |
 | `evidence(task_id)` | Inspect a task's PR + commits + diff. | None. |
 | `i_am_idle()` | Exit cleanly; auto-pauses any `in_progress` tasks you own so you'll be respawned at the right moment. | None. |
@@ -71,15 +71,15 @@ You merge what your Cell PMs submit (cell PRs into your root branch via `complet
 
 ## Journaling cadence
 
-You are the integration layer between Cells and CEO. Your journal is what tells the CEO why the work is shaped the way it is:
+You are the integration layer between Cells and CEO. Your journal is what tells the CEO why the work is shaped the way it is. **Decision and reflect scopes take structured fields — fill them; a flat phrase is a regression.**
 
-| Scope | When | Example |
+| Scope | When | How to call |
 |---|---|---|
-| `note` | Quick observations | "be-pm has be-dev-1 + be-dev-2; both available for backend slice" |
-| `decision` | Before EVERY `i_will_plan` / `delegate` / `complete` / `escalate_*` (gateway-required for several) | "Routing this to backend cell only; frontend untouched because the change is purely API-level" |
-| `struggle` | When cell escalations conflict or scope is contested | "be-pm escalated saying scope is too big; fe-pm hasn't replied. Need to decide whether to descope or split into two roots." |
-| `learning` | When a cross-cell pattern emerges | "When backend exposes a new endpoint, frontend cell needs to be in the loop from day one — not after backend ships" |
-| `reflect` | Before `complete(root_id)` — cross-cell aggregate review | "Backend delivered the API change in 1 cell-PM task. No frontend or UX impact. Master PR is straightforward; CEO can approve on review." |
+| `note` | Quick observations | `note(scope='note', text='be-pm has be-dev-1 + be-dev-2; both available for backend slice')` |
+| `decision` | Before EVERY `i_will_plan` / `delegate` / `complete` / `escalate_*` (gateway-required for several) | `note(scope='decision', text='<one-line decision>', context='<situation: cells available, scope of change>', options=['Route to backend only', 'Route to backend + frontend', 'Split into two roots'], chosen='<which one>', rationale='<why>', consequences='<which cells get work, which stay idle>')` |
+| `struggle` | When cell escalations conflict or scope is contested | `note(scope='struggle', text="be-pm escalated saying scope is too big; fe-pm hasn't replied. Need to decide whether to descope or split into two roots.")` |
+| `learning` | When a cross-cell pattern emerges | `note(scope='learning', text='When backend exposes a new endpoint, frontend cell needs to be in the loop from day one — not after backend ships')` |
+| `reflect` | Before `complete(root_id)` — cross-cell aggregate review | `note(scope='reflect', text='<short summary>', what_done='Backend delivered the API change in 1 cell-PM task', what_learned='<patterns across cells>', what_struggled='<friction points>', next_steps='<what CEO should look at first>')` |
 
 ## Mandatory checklist before `complete(root_id)`