2026-05-11 02:15:47 +02:00
{
"claim_rules" : {
"auditor" : [],
"cell_pm" : [
2026-06-21 06:09:59 +02:00
"needs_revision" ,
2026-05-11 02:15:47 +02:00
"pending"
],
"ceo" : [],
"developer" : [
"needs_revision" ,
"pending"
],
"documenter" : [
"awaiting_documentation" ,
"pending"
],
"head_marketing" : [],
"main_pm" : [
2026-06-21 06:09:59 +02:00
"needs_revision" ,
2026-05-11 02:15:47 +02:00
"pending"
],
2026-06-16 10:37:06 +02:00
"pr_reviewer" : [
2026-06-20 09:27:29 +02:00
"awaiting_pr_review" ,
2026-06-16 10:37:06 +02:00
"pending"
],
2026-05-11 02:15:47 +02:00
"product_owner" : [],
"qa" : [
"awaiting_qa"
]
},
"intents" : [
{
"allowed_roles" : [
"documenter"
],
"composes" : [],
"description" : "Claim awaiting_documentation. Returns evidence inline." ,
"name" : "claim_doc_task" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
2026-06-20 09:27:29 +02:00
{
"allowed_roles" : [
"pr_reviewer"
],
"composes" : [],
"description" : "Claim an assembled-PR review task (awaiting_pr_review) WITHOUT transitioning it \u2014 mirrors QA's claim_review. The assembled diff and the parent task's acceptance criteria are returned inline." ,
"name" : "claim_gate_review" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-06-16 10:37:06 +02:00
{
"allowed_roles" : [
"pr_reviewer"
],
"composes" : [
"claim" ,
"start"
],
"description" : "Claim an inbound external-PR review task and start work. pending -> claimed -> in_progress." ,
"name" : "claim_pr_review" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-05-11 02:15:47 +02:00
{
"allowed_roles" : [
"qa"
],
"composes" : [],
"description" : "Claim a task in awaiting_qa for review. Returns evidence inline." ,
"name" : "claim_review" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"cell_pm" ,
"main_pm"
],
"composes" : [
"complete"
],
2026-07-01 01:11:34 +02:00
"description" : "Cell PM merges the PR (leaf into the cell branch, or the gated cell\u2192root PR into the root branch) + transitions to completed; Main PM escalates the root to the CEO (who merges root\u2192master). The merge runs BEFORE the complete transition: TaskService.complete asserts the PR is already merged, so the choreographer verb body (cell_pm_complete / main_pm_complete) owns the merge-first ordering \u2014 no trailing pr_merge side_effect is declared here." ,
2026-05-11 02:15:47 +02:00
"name" : "complete" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-07-01 01:11:34 +02:00
"side_effects" : []
2026-05-11 02:15:47 +02:00
},
2026-07-08 21:40:22 +02:00
{
"allowed_roles" : [
"cell_pm" ,
"main_pm"
],
"composes" : [],
"description" : "Stamp parent acceptance criteria onto an existing child's parent_ac_refs after the fact \u2014 for a replacement child whose delegate omitted covers_parent_criteria. No status change; the verb body owns ownership + criterion validation." ,
"name" : "declare_coverage" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-05-11 02:15:47 +02:00
{
"allowed_roles" : [
"cell_pm" ,
"main_pm"
],
"composes" : [
"create_subtask"
],
2026-06-03 06:35:03 +02:00
"description" : "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/research, UX devs also design). documentation is NOT delegatable \u2014 the lifecycle auto-creates the doc phase after the code subtask passes QA." ,
2026-05-11 02:15:47 +02:00
"name" : "delegate" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"head_marketing" ,
"main_pm" ,
"product_owner"
],
"composes" : [
"escalate_to_ceo"
],
"description" : "Escalate to CEO with reason. Transitions to awaiting_ceo_approval." ,
"name" : "escalate_to_ceo" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"cell_pm" ,
"main_pm"
],
"composes" : [],
"description" : "Escalate to your role's escalation_target." ,
"name" : "escalate_up" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"qa"
],
"composes" : [
"qa_fail"
],
"description" : "Fail QA with concrete issues. Transitions to needs_revision." ,
"name" : "fail_review" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"cell_pm" ,
"developer" ,
"documenter" ,
"main_pm" ,
2026-06-16 10:37:06 +02:00
"pr_reviewer" ,
2026-05-11 02:15:47 +02:00
"qa"
],
"composes" : [],
"description" : "Return your most-actionable task or signal idle." ,
"name" : "give_me_work" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"developer" ,
"documenter" ,
"qa"
],
"composes" : [
"block"
],
"description" : "Escalate to PM. Logs a struggle journal entry." ,
"name" : "i_am_blocked" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"developer"
],
"composes" : [
"submit_verification" ,
"submit_qa"
],
"description" : "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." ,
"name" : "i_am_done" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"auditor" ,
"cell_pm" ,
"developer" ,
"documenter" ,
"head_marketing" ,
"main_pm" ,
2026-06-16 10:37:06 +02:00
"pr_reviewer" ,
2026-05-11 02:15:47 +02:00
"product_owner" ,
2026-06-09 17:08:34 +02:00
"prompter" ,
2026-06-15 20:47:41 +02:00
"qa" ,
"secretary"
2026-05-11 02:15:47 +02:00
],
"composes" : [],
"description" : "Signal you have no active work. PMs auto-pause owned in_progress tasks." ,
"name" : "i_am_idle" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"documenter"
],
"composes" : [
"docs_complete"
],
"description" : "Signal docs complete. Transitions to awaiting_pm_review." ,
"name" : "i_documented" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"cell_pm" ,
"main_pm"
],
"composes" : [
"claim" ,
"set_plan" ,
"start"
],
"description" : "PM mirror of i_will_work_on for parent tasks. Claim, plan, transition to in_progress; from there delegate subtasks." ,
"name" : "i_will_plan" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"developer"
],
"composes" : [
"claim" ,
"set_plan" ,
"start"
],
"description" : "Claim a task, set the plan, and transition to in_progress. Atomic - preconditions checked before any state mutation." ,
"name" : "i_will_work_on" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"developer"
],
"composes" : [],
"description" : "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." ,
"name" : "open_pr" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : [
"push_branch" ,
"create_pr"
]
},
{
"allowed_roles" : [
"qa"
],
"composes" : [
"qa_pass"
],
"description" : "Pass QA. Transitions awaiting_qa -> awaiting_documentation." ,
"name" : "pass_review" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
2026-06-16 10:37:06 +02:00
{
"allowed_roles" : [
"pr_reviewer"
],
"composes" : [
"pr_review_done"
],
"description" : "Post one complete change-request to the external PR and finish the review task. in_progress -> completed." ,
"name" : "post_pr_review" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-06-20 09:27:29 +02:00
{
"allowed_roles" : [
"pr_reviewer"
],
"composes" : [
"pr_fail"
],
"description" : "Fail the assembled-PR review with concrete issues. Transitions awaiting_pr_review -> needs_revision, routed back like a QA fail." ,
"name" : "pr_fail" ,
"pre_side_effects" : [],
"side_effects" : []
},
{
"allowed_roles" : [
"pr_reviewer"
],
"composes" : [
"pr_pass"
],
"description" : "Pass the assembled-PR review. Transitions awaiting_pr_review -> awaiting_pm_review so the PM can merge." ,
"name" : "pr_pass" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-06-06 22:10:48 +02:00
{
"allowed_roles" : [
"cell_pm"
],
"composes" : [],
"description" : "Hand a claimed/in_progress task to another developer in your own cell. The branch is keyed to the task (not the agent), so it is preserved \u2014 the new developer continues the work-in-progress. No status change." ,
"name" : "reassign" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-07-02 05:46:01 +02:00
{
"allowed_roles" : [
"cell_pm" ,
"main_pm"
],
"composes" : [
"request_changes"
],
"description" : "Reject the merge review with concrete issues. Transitions awaiting_pm_review -> needs_revision, routed back like a QA fail (original developer for a leaf, revision PM for an assembled task). Use this for an AC/scope violation caught at merge review \u2014 never i_am_blocked/escalate, which have no revision routing." ,
"name" : "request_changes" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-05-11 02:15:47 +02:00
{
"allowed_roles" : [
"cell_pm" ,
"developer" ,
"documenter" ,
"main_pm" ,
"qa"
],
"composes" : [
"resume"
],
"description" : "Resume a paused task you own. paused -> in_progress." ,
"name" : "resume" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
2026-06-20 09:27:29 +02:00
{
"allowed_roles" : [
"main_pm"
],
"composes" : [
"submit_for_review"
],
2026-06-29 05:38:21 +02:00
"description" : "Main PM opens the root\u2192master PR and moves the root task to awaiting_pr_review for the main reviewer (the root analogue of the cell PM's submit_up). After pr_pass, call complete to escalate to the CEO. For branch-bearing roots (a Main-PM root-subtask assembles the cells' merged work); branchless coordination roots skip the gate and complete directly. The gate is branch-keyed, not task_type-keyed \u2014 a Main-PM root is planning-typed, never code." ,
2026-06-20 09:27:29 +02:00
"name" : "submit_root" ,
"pre_side_effects" : [
"create_root_pr"
],
"side_effects" : []
},
2026-05-11 02:15:47 +02:00
{
"allowed_roles" : [
"cell_pm"
],
"composes" : [
2026-06-20 09:27:29 +02:00
"submit_for_review"
2026-05-11 02:15:47 +02:00
],
2026-06-20 09:27:29 +02:00
"description" : "Cell PM opens the cell\u2192root PR and moves the cell task into the PR-review gate (awaiting_pr_review). The cell reviewer reviews the assembled diff; after pr_pass the same Cell PM completes it." ,
2026-05-11 02:15:47 +02:00
"name" : "submit_up" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [
2026-05-11 02:15:47 +02:00
"create_pr"
2026-05-23 02:32:41 +02:00
],
"side_effects" : []
2026-05-11 02:15:47 +02:00
},
2026-06-29 05:38:21 +02:00
{
"allowed_roles" : [
"developer"
],
"composes" : [],
2026-07-08 21:40:22 +02:00
"description" : "Rebase your task's branch onto its current base THROUGH the gate (raw git is denied). Use when your branch has fallen behind its base \u2014 e.g. a sibling task's PR merged into the parent branch while you worked. Fetches origin, rebases head onto base, and force-pushes (with-lease). No DB state change. On conflicts the rebase is aborted and the conflicted files are returned \u2014 resolve by hand, commit, then sync_branch again. Pass stash=True to auto-stash uncommitted changes instead of refusing DIRTY_WORKSPACE; they are restored after the rebase." ,
2026-06-29 05:38:21 +02:00
"name" : "sync_branch" ,
"pre_side_effects" : [],
"side_effects" : []
},
2026-05-11 02:15:47 +02:00
{
"allowed_roles" : [
"auditor" ,
"cell_pm" ,
"head_marketing" ,
"main_pm" ,
"product_owner"
],
"composes" : [],
"description" : "List actionable tasks in your scope." ,
"name" : "triage" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"main_pm"
],
"composes" : [],
"description" : "List actionable tasks across all teams (Main PM only)." ,
"name" : "triage_all" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"cell_pm" ,
"main_pm"
],
"composes" : [
"unblock"
],
"description" : "PM unblocks a blocked task; restores pre-block state." ,
"name" : "unblock" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
},
{
"allowed_roles" : [
"cell_pm" ,
"developer" ,
"documenter" ,
"main_pm" ,
2026-07-01 01:11:34 +02:00
"pr_reviewer" ,
2026-05-11 02:15:47 +02:00
"qa"
],
"composes" : [],
2026-07-01 01:11:34 +02:00
"description" : "Voluntarily release a claim back to pending. The work-in-progress branch is preserved. A PR reviewer who claimed an external review (in_progress) or a gate review (awaiting_pr_review) and cannot finish releases the claim here rather than wedging the lane until the stale-claim reaper." ,
2026-05-11 02:15:47 +02:00
"name" : "unclaim" ,
2026-05-23 02:32:41 +02:00
"pre_side_effects" : [],
2026-05-11 02:15:47 +02:00
"side_effects" : []
}
],
"transitions" : [
{
"action" : "cancel" ,
"roles" : [
2026-07-01 01:11:34 +02:00
"ceo"
2026-05-11 02:15:47 +02:00
],
"source" : "awaiting_ceo_approval" ,
"target" : "cancelled"
},
{
"action" : "ceo_approve" ,
"roles" : [
"ceo"
],
"source" : "awaiting_ceo_approval" ,
"target" : "completed"
},
{
"action" : "ceo_reject" ,
"roles" : [
"ceo"
],
"source" : "awaiting_ceo_approval" ,
"target" : "needs_revision"
},
2026-06-30 08:08:35 +02:00
{
"action" : "ceo_reject_to_pool" ,
"roles" : [
"ceo"
],
"source" : "awaiting_ceo_approval" ,
"target" : "pending"
},
2026-05-11 02:15:47 +02:00
{
"action" : "docs_complete" ,
"roles" : [
"documenter"
],
"source" : "awaiting_documentation" ,
"target" : "awaiting_pm_review"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "awaiting_documentation" ,
"target" : "cancelled"
},
{
"action" : "claim" ,
"roles" : [
"documenter"
],
"source" : "awaiting_documentation" ,
"target" : "claimed"
},
{
"action" : "escalate_to_ceo" ,
"roles" : [
"head_marketing" ,
"main_pm" ,
"product_owner"
],
"source" : "awaiting_pm_review" ,
"target" : "awaiting_ceo_approval"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "awaiting_pm_review" ,
"target" : "cancelled"
},
{
"action" : "complete" ,
"roles" : [
"cell_pm" ,
"main_pm"
],
"source" : "awaiting_pm_review" ,
"target" : "completed"
},
2026-07-02 05:46:01 +02:00
{
"action" : "request_changes" ,
"roles" : [
"cell_pm" ,
"main_pm"
],
"source" : "awaiting_pm_review" ,
"target" : "needs_revision"
},
2026-06-20 09:27:29 +02:00
{
"action" : "pr_pass" ,
"roles" : [
"pr_reviewer"
],
"source" : "awaiting_pr_review" ,
"target" : "awaiting_pm_review"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "awaiting_pr_review" ,
"target" : "cancelled"
},
{
"action" : "claim" ,
"roles" : [
"pr_reviewer"
],
"source" : "awaiting_pr_review" ,
"target" : "claimed"
},
{
"action" : "pr_fail" ,
"roles" : [
"pr_reviewer"
],
"source" : "awaiting_pr_review" ,
"target" : "needs_revision"
},
2026-05-11 02:15:47 +02:00
{
"action" : "qa_pass" ,
"roles" : [
"qa"
],
"source" : "awaiting_qa" ,
"target" : "awaiting_documentation"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "awaiting_qa" ,
"target" : "cancelled"
},
{
"action" : "claim" ,
"roles" : [
"qa"
],
"source" : "awaiting_qa" ,
"target" : "claimed"
},
{
"action" : "qa_fail" ,
"roles" : [
"qa"
],
"source" : "awaiting_qa" ,
"target" : "needs_revision"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "backlog" ,
"target" : "cancelled"
},
{
"action" : "activate" ,
"roles" : null ,
"source" : "backlog" ,
"target" : "pending"
},
2026-06-08 05:17:15 +02:00
{
"action" : "escalate_to_ceo" ,
"roles" : [
"head_marketing" ,
"main_pm" ,
"product_owner"
],
"source" : "blocked" ,
"target" : "awaiting_ceo_approval"
},
2026-05-11 02:15:47 +02:00
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "blocked" ,
"target" : "cancelled"
},
{
"action" : "unblock" ,
"roles" : null ,
"source" : "blocked" ,
"target" : "in_progress"
},
2026-06-04 02:01:09 +02:00
{
"action" : "unblock" ,
"roles" : null ,
"source" : "blocked" ,
"target" : "pending"
},
2026-05-11 02:15:47 +02:00
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "claimed" ,
"target" : "cancelled"
},
{
"action" : "start" ,
"roles" : null ,
"source" : "claimed" ,
"target" : "in_progress"
},
{
"action" : "submit_pm_review" ,
"roles" : null ,
"source" : "in_progress" ,
"target" : "awaiting_pm_review"
},
2026-06-20 09:27:29 +02:00
{
"action" : "submit_for_review" ,
"roles" : null ,
"source" : "in_progress" ,
"target" : "awaiting_pr_review"
},
2026-05-11 02:15:47 +02:00
{
"action" : "block" ,
"roles" : null ,
"source" : "in_progress" ,
"target" : "blocked"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "in_progress" ,
"target" : "cancelled"
},
2026-06-16 10:37:06 +02:00
{
"action" : "pr_review_done" ,
"roles" : [
"pr_reviewer"
],
"source" : "in_progress" ,
"target" : "completed"
},
2026-05-11 02:15:47 +02:00
{
"action" : "pause" ,
"roles" : null ,
"source" : "in_progress" ,
"target" : "paused"
},
{
"action" : "submit_verification" ,
"roles" : null ,
"source" : "in_progress" ,
"target" : "verifying"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "needs_revision" ,
"target" : "cancelled"
},
{
"action" : "claim" ,
"roles" : null ,
"source" : "needs_revision" ,
"target" : "claimed"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "paused" ,
"target" : "cancelled"
},
{
"action" : "resume" ,
"roles" : null ,
"source" : "paused" ,
"target" : "in_progress"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "pending" ,
"target" : "cancelled"
},
{
"action" : "claim" ,
"roles" : null ,
"source" : "pending" ,
"target" : "claimed"
},
{
"action" : "submit_qa" ,
"roles" : null ,
"source" : "verifying" ,
"target" : "awaiting_qa"
},
{
"action" : "cancel" ,
"roles" : [
"cell_pm" ,
"ceo" ,
"main_pm"
],
"source" : "verifying" ,
"target" : "cancelled"
}
]
}
