<!-- AUTOGENERATED by scripts/regenerate_verb_tables.py. -->
<!-- Source: services/gateway/role_config.py + api/schemas/v2/. -->

# Per-role verb shapes (autogenerated)

Run `uv run python scripts/regenerate_verb_tables.py` after changing
any role config or schema. Role prompts reference this file's sections
as the source of truth for verb signatures.

## developer

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `give_me_work` | `give_me_work()` |
| `i_will_work_on` | `i_will_work_on(task_id: UUID, plan: str | None = None)` |
| `open_pr` | `open_pr(task_id: UUID)` |
| `i_am_done` | `i_am_done(task_id: UUID, notes: str = '')` |
| `i_am_blocked` | `i_am_blocked(task_id: UUID, reason: str)` |
| `unclaim` | `unclaim(task_id: UUID)` |
| `resume` | `resume(task_id: UUID)` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `commit` | `commit(message: str, files: list[str] | None = None)` |
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

## qa

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `give_me_work` | `give_me_work()` |
| `claim_review` | `claim_review(task_id: UUID)` |
| `pass` | `pass(task_id: UUID, notes: str)` |
| `fail` | `fail(task_id: UUID, issues: list[str])` |
| `unclaim` | `unclaim(task_id: UUID)` |
| `resume` | `resume(task_id: UUID)` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

## documenter

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `give_me_work` | `give_me_work()` |
| `claim_doc_task` | `claim_doc_task(task_id: UUID)` |
| `i_documented` | `i_documented(task_id: UUID, notes: str, files: list[str])` |
| `unclaim` | `unclaim(task_id: UUID)` |
| `resume` | `resume(task_id: UUID)` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `commit` | `commit(message: str, files: list[str] | None = None)` |
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

## cell_pm

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `give_me_work` | `give_me_work()` |
| `i_will_plan` | `i_will_plan(task_id: UUID, plan: str)` |
| `delegate` | `delegate(parent_task_id: UUID, title: str, description: str, assigned_to: str, team: str, task_type: str = 'code', acceptance_criteria: list[str] | None = None, estimated_complexity: str = 'medium')` |
| `submit_up` | `submit_up(task_id: UUID, notes: str)` |
| `triage` | `triage()` |
| `unblock` | `unblock(task_id: UUID, restore: bool = True)` |
| `complete` | `complete(task_id: UUID, notes: str)` |
| `escalate_up` | `escalate_up(task_id: UUID, reason: str)` |
| `unclaim` | `unclaim(task_id: UUID)` |
| `resume` | `resume(task_id: UUID)` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

## main_pm

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `give_me_work` | `give_me_work()` |
| `i_will_plan` | `i_will_plan(task_id: UUID, plan: str)` |
| `delegate` | `delegate(parent_task_id: UUID, title: str, description: str, assigned_to: str, team: str, task_type: str = 'code', acceptance_criteria: list[str] | None = None, estimated_complexity: str = 'medium')` |
| `triage_all` | `triage_all()` |
| `unblock` | `unblock(task_id: UUID, restore: bool = True)` |
| `complete` | `complete(task_id: UUID, notes: str)` |
| `escalate_up` | `escalate_up(task_id: UUID, reason: str)` |
| `escalate_to_ceo` | `escalate_to_ceo(task_id: UUID, reason: str)` |
| `unclaim` | `unclaim(task_id: UUID)` |
| `resume` | `resume(task_id: UUID)` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

## product_owner

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `triage` | `triage()` |
| `escalate_to_ceo` | `escalate_to_ceo(task_id: UUID, reason: str)` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

## head_marketing

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `triage` | `triage()` |
| `escalate_to_ceo` | `escalate_to_ceo(task_id: UUID, reason: str)` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `say` | `say(channel: str, text: str, task_id: UUID | None = None)` |
| `dm` | `dm(recipient: str, text: str, task_id: UUID | None = None, skill: str | None = None)` |
| `notify` | `notify(target: str, text: str, priority: str = 'normal', task_id: UUID | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

## auditor

### Flow verbs

| Verb | Body schema |
|------|-------------|
| `triage` | `triage()` |
| `i_am_idle` | `i_am_idle()` |

### Content (do) tools

| Tool | Body schema |
|------|-------------|
| `note` | `note(text: str, scope: str = 'note', task_id: UUID | None = None)` |
| `evidence` | `evidence(task_id: UUID)` |

