mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
Renn F
e3def6b3a2
submit_up bubbled the cell task to Main PM (_handoff_to_main_pm), but
main_pm_complete rejects any task with a parent_task_id ("only operates
on root tasks"), so the cell->root PR had no one to merge it and the
cell task wedged at awaiting_pm_review. _maybe_advance_parent_to_pm_review
already intends the CELL PM to complete it.
Cell PM now owns cell completion:
- submit_up no longer hands off to Main PM; the cell task stays assigned
to the cell PM, which is respawned to complete() it. Removed the
now-unused _handoff_to_main_pm.
- cell_pm_complete resolves the merge target from the parent task's real
branch_name (shared merge_chain.resolve_parent_branch, also used by the
PR side-effects) so the cell->root PR merges into feature/main_pm/...,
not the team-mis-derived feature/<cellteam>/... (same root cause as the
prior PR-base fix).
- submit_up description + next_hint updated; lifecycle artifacts regen.
Main PM still only completes the ROOT (root->master + escalate-to-CEO).
First run to reach cell-PM bubble-up exposed this.
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 opens the cell→root PR and moves the cell task to awaiting_pm_review. The same Cell PM then completes it.
|
|
|
|
**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)
|
|
|