roboco/docs/rag/lifecycle/intent-verbs.md

# Intent Verbs (gateway-facing surface)

## claim_doc_task

Claim awaiting_documentation. Returns evidence inline.

**Allowed roles:** documenter

**Composes:** (no atomic actions)


## claim_review

Claim a task in awaiting_qa for review. Returns evidence inline.

**Allowed roles:** qa

**Composes:** (no atomic actions)


## complete

Cell PM merges leaf PR + transitions to completed; Main PM merges root PR + escalates to CEO.

**Allowed roles:** cell_pm, main_pm

**Composes:** complete

**Side effects:** pr_merge


## delegate

Create a subtask under the current task. Validates the delegation chain (main_pm->cell_pm; cell_pm->its team's devs) and the assignee-vs-task_type rule (Cell PMs get planning-typed tasks; devs get code/documentation).

**Allowed roles:** cell_pm, main_pm

**Composes:** create_subtask


## escalate_to_ceo

Escalate to CEO with reason. Transitions to awaiting_ceo_approval.

**Allowed roles:** head_marketing, main_pm, product_owner

**Composes:** escalate_to_ceo


## escalate_up

Escalate to your role's escalation_target.

**Allowed roles:** cell_pm, main_pm

**Composes:** (no atomic actions)


## fail_review

Fail QA with concrete issues. Transitions to needs_revision.

**Allowed roles:** qa

**Composes:** qa_fail


## give_me_work

Return your most-actionable task or signal idle.

**Allowed roles:** cell_pm, developer, documenter, main_pm, qa

**Composes:** (no atomic actions)


## i_am_blocked

Escalate to PM. Logs a struggle journal entry.

**Allowed roles:** developer, documenter, qa

**Composes:** block


## i_am_done

Submit work for QA. Auto-runs in_progress->verifying then verifying->awaiting_qa. Strict - PR must be open (call open_pr first) and >=1 commit.

**Allowed roles:** developer

**Composes:** submit_verification → submit_qa

**Preconditions:** commits>=1, owns_task


## i_am_idle

Signal you have no active work. PMs auto-pause owned in_progress tasks.

**Allowed roles:** auditor, cell_pm, developer, documenter, head_marketing, main_pm, product_owner, qa

**Composes:** (no atomic actions)


## i_documented

Signal docs complete. Transitions to awaiting_pm_review.

**Allowed roles:** documenter

**Composes:** docs_complete


## i_will_plan

PM mirror of i_will_work_on for parent tasks. Claim, plan, transition to in_progress; from there delegate subtasks.

**Allowed roles:** cell_pm, main_pm

**Composes:** claim → set_plan → start

**Preconditions:** plan


## i_will_work_on

Claim a task, set the plan, and transition to in_progress. Atomic - preconditions checked before any state mutation.

**Allowed roles:** developer

**Composes:** claim → set_plan → start

**Preconditions:** plan


## open_pr

Push the branch and open a PR. Atomic - preconditions (assignee, >=1 commit, no prior PR) checked BEFORE any git operation. After success, call i_am_done.

**Allowed roles:** developer

**Composes:** (no atomic actions)

**Side effects:** push_branch, create_pr

**Preconditions:** commits>=1, no_prior_pr, owns_task


## pass_review

Pass QA. Transitions awaiting_qa -> awaiting_documentation.

**Allowed roles:** qa

**Composes:** qa_pass


## resume

Resume a paused task you own. paused -> in_progress.

**Allowed roles:** cell_pm, developer, documenter, main_pm, qa

**Composes:** resume


## submit_up

Cell PM bubbles a finished cell-scope task up to Main PM.

**Allowed roles:** cell_pm

**Composes:** submit_pm_review

**Side effects:** create_pr


## triage

List actionable tasks in your scope.

**Allowed roles:** auditor, cell_pm, head_marketing, main_pm, product_owner

**Composes:** (no atomic actions)


## triage_all

List actionable tasks across all teams (Main PM only).

**Allowed roles:** main_pm

**Composes:** (no atomic actions)


## unblock

PM unblocks a blocked task; restores pre-block state.

**Allowed roles:** cell_pm, main_pm

**Composes:** unblock


## unclaim

Voluntarily release a claim back to pending. The work-in-progress branch is preserved.

**Allowed roles:** cell_pm, developer, documenter, main_pm, qa

**Composes:** (no atomic actions)