Skip to content
M31A

8 Canonical Agent Roles

Specialized role state machines: planner, researcher, implementer, verifier, etc.


M31A partitions autonomous engineering tasks across 8 specialized agent roles, each with dedicated prompt contracts, capability boundaries, and step budgets.

Canonical Agent Roles

planner

Analyzes objectives, decomposes requirements, and generates acyclic candidate task DAGs.

researcher

Explores codebase structure, index symbols, reads docs, and surveys dependencies.

architect

Defines cross-module interfaces, contract types, API boundaries, and architectural patterns.

implementer

Authors source code modifications, writes tests, and applies targeted patches.

reviewer

Performs semantic code reviews, auditing proposed diffs for security and regressions.

verifier

Executes automated test suites, type checking, formatting, and produces cryptographic evidence.

diagnostician

Analyzes failed verification runs, compiler diagnostics, and classifies failure modes.

integrator

Consolidates verified worktrees, stages changes, generates RFC-compliant commit trailers.

Anti-Fake-Diff Enforcement

The reviewer and verifier roles actively scan proposed code modifications for placeholder shortcuts such as todo!(), unimplemented!(), or truncated comments. Any patch containing fake progress is rejected before task completion.