mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
Renn F
c78395f9fc
submit_up composed submit_pm_review (atomic) then create_pr (side
effect), but VerbRunner.run_intent runs all composes before any side
effect. submit_pm_review rejects without a PR (returns None), then
create_pr deref'd the None task -> 'NoneType has no attribute
branch_name', wedging cell-PM bubble-up in a respawn loop.
Add IntentSpec.pre_side_effects, run before composes. submit_up now
opens the cell->root PR first (persisting pr_number), so submit_pm_review
re-fetches and passes its pr_created gate. Mirrors the dev open_pr ->
i_am_done split. Latent since the lifecycle spec (207aaec); first run to
reach cell-PM bubble-up exposed it.
214 lines
4.0 KiB
Markdown
214 lines
4.0 KiB
Markdown
# 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
|
|
|
|
**Pre 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)
|
|
|