mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
Renn F
5902c0fe38
A global, read-only PR reviewer agent (pr-reviewer-1) that reviews inbound external/fork PRs and posts one change-request. Wired end-to-end: - identity: Role.PR_REVIEWER + agent + ROLE_LEVEL (QA-peer) + REVIEWER_ROLES - lifecycle: CLAIM_RULES + ROLE_TEAM_RULES + a dedicated claim_pr_review / post_pr_review verb pair (distinct from QA's) + the pr_review_done action and its in_progress->completed transition; give_me_work / i_am_idle gain the role - role_config: a read-only RoleConfig (allows_write=False) - journaling: ALL_CELLS read tier so it can read internal intent like QA - tracing: post_pr_review requires a learning entry; claim_pr_review is waived - seeds presentation + factory prompt layer + builtin tools + the agentrole enum migration (037) + regenerated verb/lifecycle artifacts Read-only at /app like QA/auditor; default-off — nothing dispatches review work until external_pr_enabled. Foundation + role-config + enum suites green; ruff + mypy clean; orchestrator boots.
241 lines
4.9 KiB
Markdown
241 lines
4.9 KiB
Markdown
# Intent Verbs (gateway-facing surface)
|
|
|
|
## claim_doc_task
|
|
|
|
Claim awaiting_documentation. Returns evidence inline.
|
|
|
|
**Allowed roles:** documenter
|
|
|
|
**Composes:** (no atomic actions)
|
|
|
|
|
|
## claim_pr_review
|
|
|
|
Claim an inbound external-PR review task and start work. pending -> claimed -> in_progress.
|
|
|
|
**Allowed roles:** pr_reviewer
|
|
|
|
**Composes:** claim → start
|
|
|
|
|
|
## 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/research, UX devs also design). documentation is NOT delegatable — the lifecycle auto-creates the doc phase after the code subtask passes QA.
|
|
|
|
**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, pr_reviewer, 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, pr_reviewer, product_owner, prompter, qa, secretary
|
|
|
|
**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
|
|
|
|
|
|
## post_pr_review
|
|
|
|
Post one complete change-request to the external PR and finish the review task. in_progress -> completed.
|
|
|
|
**Allowed roles:** pr_reviewer
|
|
|
|
**Composes:** pr_review_done
|
|
|
|
|
|
## reassign
|
|
|
|
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 — the new developer continues the work-in-progress. No status change.
|
|
|
|
**Allowed roles:** cell_pm
|
|
|
|
**Composes:** (no atomic actions)
|
|
|
|
|
|
## 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)
|
|
|