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.
4.0 KiB
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)