Skip to content

Roles and authority

One person or agent can perform more than one role, but the authority and evidence for each role remain distinct. A reviewer must not approve its own unreviewed risk decision.

RoleOwnsMust not do by inference
OwnerScope, priorities, exceptions, and remote authorizationAssume an agent has understood an unstated preference
PlannerConstraints, plan, risks, acceptance criteria, and validation designChange product code while assigned plan-only work
ImplementerA scoped branch, batches, local commits, and evidencePush, open a PR, merge, release, deploy, or delete without authorization
ReviewerIndependent assessment of correctness, regressions, and missing evidenceTreat unrun checks as passing or approve its own exception
Release operatorThe authorized release or deployment procedure and operator evidenceTreat a successful push as a release or deployment

Modes and authorization

Agent modes defines the permitted local actions and required outcome for Plan, Inspect, Diagnose, Review, Implement, Verify, Deliver, and Monitor. The owner remains the only source of approval for remote or privileged actions.

Words such as “finish”, “urgent”, or “use Yeet” do not waive the authorization boundary. If a request says “use Yeet and push/open a PR”, those two remote actions are authorized; merge, release, and deployment still are not.

Reporting contract

At each meaningful handoff, report:

  • the selected flow and completed batch number;
  • changed areas and the local commit created for the batch;
  • commands run and their result;
  • unrun or blocked checks, including why;
  • remote actions completed only when they actually succeeded.

Never include credentials, private endpoints, access tokens, or machine-specific paths in a public report or commit.

Released under the MIT License.