mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
73c05cfa5e
* feat(a2a): CEO can DM the Auditor and PR reviewers
A mid-flight PR reviewer or Auditor that's stuck was unreachable — the CEO
had no way to DM them. Both roles now carry dm/read_a2a, so the CEO can open
a 1:1 and they can reply in-thread through the existing CEO-reply path.
Scoped deliberately: the Auditor stays a silent observer to its peers — it
gains no peer-initiation surface (can_a2a_direct routes it through
_check_auditor_a2a, which refuses every initiation target; it can only reply
inside a CEO-opened DM). PR reviewers keep their owning-PM scope. Intake and
Secretary stay excluded — they have their own dedicated chat pages.
NO_COMMS_ROLES drops to {prompter, secretary}; the panel's EXCLUDE_NON_DM_ROLES
matches. KB/docs updated so the 'auditor/pr_reviewer have no dm' claim isn't
left stale.
* test(a2a): smoke guard checks _NO_COMMS_ROLES, not a hardcoded 'auditor'
The dm() runtime guard no longer names the auditor (it now carries dm to
reply to the CEO); it refuses the canonical _NO_COMMS_ROLES set. Assert on
that set so the smoke test tracks the guard, not a stale role name.
* chore(foundation): regenerate verb tables for auditor/pr_reviewer dm+read_a2a
---------
Co-authored-by: Renn F <rennf93@users.noreply.github.com>
18 KiB
18 KiB
Per-role verb shapes (autogenerated)
Run make foundation-check after changing
any role config or schema. Role prompts reference this file's sections
as the source of truth for verb signatures.
Driver-based roles (prompter, secretary) are intentionally omitted — their real tools live in their agent_sdk drivers, not role_config.
developer
Flow verbs
| Verb | Body schema |
|---|---|
give_me_work |
give_me_work() |
i_am_blocked |
`i_am_blocked(task_id: UUID, reason: str, blocker_type: str |
i_am_done |
i_am_done(task_id: UUID, notes: str = '', resolved_findings: list[ResolvedFindingInput] = PydanticUndefined) |
i_am_idle |
i_am_idle() |
i_will_work_on |
`i_will_work_on(task_id: UUID, plan: str |
open_pr |
open_pr(task_id: UUID) |
resume |
resume(task_id: UUID) |
sync_branch |
sync_branch(task_id: UUID, stash: bool = False) |
unclaim |
unclaim(task_id: UUID) |
Content (do) tools
| Tool | Body schema |
|---|---|
commit |
`commit(message: str, files: list[str] |
note |
`note(text: str, scope: str = 'note', task_id: UUID |
dm |
`dm(recipient: str, text: str, task_id: UUID |
evidence |
evidence(task_id: UUID) |
progress |
`progress(task_id: UUID, message: str, plan_step: str |
pr_update |
pr_update(see do_server) |
draft_playbook |
`draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID |
propose_video |
`propose_video(composition_id: str, x_caption: str, tiktok_caption: str, platforms: list[str], input_props: str |
request_sandbox |
`request_sandbox(services: list[str] |
request_render |
`request_render(composition_id: str |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
notify_ack |
notify_ack(notification_id: UUID) |
read_messages |
read_messages() |
read_a2a |
read_a2a(see do_server) |
qa
Flow verbs
| Verb | Body schema |
|---|---|
claim_review |
claim_review(task_id: UUID) |
fail_review |
`fail_review(task_id: UUID, issues: list[str] = PydanticUndefined, findings: list[str |
give_me_work |
give_me_work() |
i_am_blocked |
`i_am_blocked(task_id: UUID, reason: str, blocker_type: str |
i_am_idle |
i_am_idle() |
pass_review |
`pass_review(task_id: UUID, notes: str, ac_verdicts: list[str] |
resume |
resume(task_id: UUID) |
unclaim |
unclaim(task_id: UUID) |
Content (do) tools
| Tool | Body schema |
|---|---|
note |
`note(text: str, scope: str = 'note', task_id: UUID |
dm |
`dm(recipient: str, text: str, task_id: UUID |
evidence |
evidence(task_id: UUID) |
draft_playbook |
`draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID |
request_sandbox |
`request_sandbox(services: list[str] |
request_render |
`request_render(composition_id: str |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
notify_ack |
notify_ack(notification_id: UUID) |
read_messages |
read_messages() |
read_a2a |
read_a2a(see do_server) |
documenter
Flow verbs
| Verb | Body schema |
|---|---|
claim_doc_task |
claim_doc_task(task_id: UUID) |
give_me_work |
give_me_work() |
i_am_blocked |
`i_am_blocked(task_id: UUID, reason: str, blocker_type: str |
i_am_idle |
i_am_idle() |
i_documented |
i_documented(task_id: UUID, notes: str, files: list[str]) |
resume |
resume(task_id: UUID) |
unclaim |
unclaim(task_id: UUID) |
Content (do) tools
| Tool | Body schema |
|---|---|
commit |
`commit(message: str, files: list[str] |
note |
`note(text: str, scope: str = 'note', task_id: UUID |
dm |
`dm(recipient: str, text: str, task_id: UUID |
evidence |
evidence(task_id: UUID) |
progress |
`progress(task_id: UUID, message: str, plan_step: str |
pr_update |
pr_update(see do_server) |
draft_playbook |
`draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
notify_ack |
notify_ack(notification_id: UUID) |
read_messages |
read_messages() |
read_a2a |
read_a2a(see do_server) |
cell_pm
Flow verbs
| Verb | Body schema |
|---|---|
complete |
complete(task_id: UUID, notes: str) |
declare_coverage |
declare_coverage(task_id: UUID, criteria: list[str]) |
delegate |
`delegate(parent_task_id: UUID, title: str, description: str, assigned_to: str, team: str, task_type: str, nature: str, estimated_complexity: Complexity, acceptance_criteria: list[str], project_id: UUID |
escalate_up |
escalate_up(task_id: UUID, reason: str) |
give_me_work |
give_me_work() |
i_am_idle |
i_am_idle() |
i_will_plan |
i_will_plan(task_id: UUID, plan: str, approach: str, sub_tasks: list[SubTaskCreate] = PydanticUndefined, technical_considerations: list[str] = PydanticUndefined, risks: list[RiskCreate] = PydanticUndefined, open_questions: list[OpenQuestionCreate] = PydanticUndefined) |
reassign |
reassign(task_id: UUID, new_assignee: str) |
request_changes |
`request_changes(task_id: UUID, issues: list[str] = PydanticUndefined, findings: list[str |
resume |
resume(task_id: UUID) |
submit_up |
submit_up(task_id: UUID, notes: str, resolved_findings: list[ResolvedFindingInput] = PydanticUndefined) |
triage |
triage() |
unblock |
unblock(task_id: UUID, reason: str, restore: bool = True) |
unclaim |
unclaim(task_id: UUID) |
Content (do) tools
| Tool | Body schema |
|---|---|
note |
`note(text: str, scope: str = 'note', task_id: UUID |
dm |
`dm(recipient: str, text: str, task_id: UUID |
notify |
`notify(target: str, text: str, priority: str = 'normal', task_id: UUID |
evidence |
evidence(task_id: UUID) |
pr_update |
pr_update(see do_server) |
draft_playbook |
`draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
notify_ack |
notify_ack(notification_id: UUID) |
read_messages |
read_messages() |
read_a2a |
read_a2a(see do_server) |
main_pm
Flow verbs
| Verb | Body schema |
|---|---|
complete |
complete(task_id: UUID, notes: str) |
declare_coverage |
declare_coverage(task_id: UUID, criteria: list[str]) |
delegate |
`delegate(parent_task_id: UUID, title: str, description: str, assigned_to: str, team: str, task_type: str, nature: str, estimated_complexity: Complexity, acceptance_criteria: list[str], project_id: UUID |
escalate_to_ceo |
escalate_to_ceo(task_id: UUID, reason: str) |
escalate_up |
escalate_up(task_id: UUID, reason: str) |
give_me_work |
give_me_work() |
i_am_idle |
i_am_idle() |
i_will_plan |
i_will_plan(task_id: UUID, plan: str, approach: str, sub_tasks: list[SubTaskCreate] = PydanticUndefined, technical_considerations: list[str] = PydanticUndefined, risks: list[RiskCreate] = PydanticUndefined, open_questions: list[OpenQuestionCreate] = PydanticUndefined) |
request_changes |
`request_changes(task_id: UUID, issues: list[str] = PydanticUndefined, findings: list[str |
resume |
resume(task_id: UUID) |
submit_root |
submit_root(task_id: UUID, notes: str, resolved_findings: list[ResolvedFindingInput] = PydanticUndefined) |
triage |
triage() |
triage_all |
triage_all() |
unblock |
unblock(task_id: UUID, reason: str, restore: bool = True) |
unclaim |
unclaim(task_id: UUID) |
Content (do) tools
| Tool | Body schema |
|---|---|
note |
`note(text: str, scope: str = 'note', task_id: UUID |
dm |
`dm(recipient: str, text: str, task_id: UUID |
notify |
`notify(target: str, text: str, priority: str = 'normal', task_id: UUID |
evidence |
evidence(task_id: UUID) |
pr_update |
pr_update(see do_server) |
draft_playbook |
`draft_playbook(title: str, problem: str, procedure: str, tags: list[str] = PydanticUndefined, source_task_id: UUID |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
notify_ack |
notify_ack(notification_id: UUID) |
read_messages |
read_messages() |
read_a2a |
read_a2a(see do_server) |
product_owner
Flow verbs
| Verb | Body schema |
|---|---|
escalate_to_ceo |
escalate_to_ceo(task_id: UUID, reason: str) |
i_am_idle |
i_am_idle() |
triage |
triage() |
Content (do) tools
| Tool | Body schema |
|---|---|
note |
`note(text: str, scope: str = 'note', task_id: UUID |
pitch |
pitch(title: str, slug: str, problem: str, proposed_solution: str, target_cells: list[str]) |
dm |
`dm(recipient: str, text: str, task_id: UUID |
notify |
`notify(target: str, text: str, priority: str = 'normal', task_id: UUID |
evidence |
evidence(task_id: UUID) |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
notify_ack |
notify_ack(notification_id: UUID) |
read_messages |
read_messages() |
read_a2a |
read_a2a(see do_server) |
propose_roadmap |
propose_roadmap(cycle_goal: str, items: list[RoadmapItemInput]) |
head_marketing
Flow verbs
| Verb | Body schema |
|---|---|
escalate_to_ceo |
escalate_to_ceo(task_id: UUID, reason: str) |
i_am_idle |
i_am_idle() |
triage |
triage() |
Content (do) tools
| Tool | Body schema |
|---|---|
note |
`note(text: str, scope: str = 'note', task_id: UUID |
pitch |
pitch(title: str, slug: str, problem: str, proposed_solution: str, target_cells: list[str]) |
dm |
`dm(recipient: str, text: str, task_id: UUID |
notify |
`notify(target: str, text: str, priority: str = 'normal', task_id: UUID |
evidence |
evidence(task_id: UUID) |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
notify_ack |
notify_ack(notification_id: UUID) |
read_messages |
read_messages() |
read_a2a |
read_a2a(see do_server) |
propose_feature_spotlight |
propose_feature_spotlight(feature_slug: str = '', feature_title: str = '', body: str = '', wants_video: bool = False, video_script: str = '', skip: bool = False, skip_reason: str = '') |
auditor
Flow verbs
| Verb | Body schema |
|---|---|
i_am_idle |
i_am_idle() |
triage |
triage() |
waive_finding |
waive_finding(finding_id: UUID, note: str) |
Content (do) tools
| Tool | Body schema |
|---|---|
note |
`note(text: str, scope: str = 'note', task_id: UUID |
evidence |
evidence(task_id: UUID) |
dm |
`dm(recipient: str, text: str, task_id: UUID |
read_a2a |
read_a2a(see do_server) |
approve_playbook |
approve_playbook(playbook_id: UUID) |
reject_playbook |
reject_playbook(playbook_id: UUID, reason: str) |
archive_playbook |
archive_playbook(playbook_id: UUID) |
curate_vault |
curate_vault(task_id: UUID, narrative: str) |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |
pr_reviewer
Flow verbs
| Verb | Body schema |
|---|---|
claim_gate_review |
claim_gate_review(task_id: UUID) |
claim_pr_review |
claim_pr_review(task_id: UUID) |
give_me_work |
give_me_work() |
i_am_idle |
i_am_idle() |
post_pr_review |
`post_pr_review(task_id: UUID, body: str, event: str = 'REQUEST_CHANGES', findings: list[str |
pr_fail |
`pr_fail(task_id: UUID, issues: list[str] = PydanticUndefined, findings: list[str |
pr_pass |
pr_pass(task_id: UUID, notes: str) |
unclaim |
unclaim(task_id: UUID) |
Content (do) tools
| Tool | Body schema |
|---|---|
note |
`note(text: str, scope: str = 'note', task_id: UUID |
evidence |
evidence(task_id: UUID) |
dm |
`dm(recipient: str, text: str, task_id: UUID |
read_a2a |
read_a2a(see do_server) |
notify_list |
notify_list(unread_only: bool = True, pending_ack_only: bool = False, limit: int = 20) |
notify_get |
notify_get(notification_id: UUID) |