Skip to content

Roles and Ownership

Each role is responsible for particular decisions and files. Finding a problem does not give it permission to change another role’s work.

Role Responsibility
Scoper Requirements and what counts as done.
Architect Technical design and important decisions across components.
Developer The implementation, its plan, and implementation self-checks.
Auditor Verified facts about the existing project, called its baseline.
Tester Tests and independent verification results.
Reviewer Independent assessments, review findings, and review conclusions.
Documenter Project documentation, comments, docstrings, and its work record.
Synchronizer Checking that current files, assessments, and workflow records agree.

Project instructions outside managed framework sections are part of Documenter’s work. Executable code, tooling directives, and managed framework files retain their own owners.

Reviewer owns its findings, but the role responsible for a defect makes the fix. Only Reviewer can resolve or withdraw its finding. Likewise, Synchronizer can correct its own assessment but cannot supply another role’s missing evidence.

See the role pages for each role’s inputs, outputs, and completion rules.

Architect decides how the important parts of the system should work together. Developer turns that design into detailed implementation steps and makes local, easily reversible coding choices. Approving Developer’s plan does not authorize it to change Scoper’s requirements or Architect’s design.

Auditor records what already exists. A proposed design remains a proposal, even if it is mentioned in the context document.

The agent identifies the responsible role, records the correction in the workflow state, and gives you a handoff to invoke that role. You do not need to classify the problem or edit the workflow records yourself.

Suppose Tester needs to check retries, but the design never decided when a request should be retried. Architect must resolve that decision. Tester cannot decide the behavior by writing a test.

If the design already specifies the behavior and the test expects something else, Tester fixes the test. If the code violates the design, Developer fixes the implementation.

Recovery records the correction and the route back to the interrupted work.

When a role creates a workflow document for one cycle, it runs node .standards/bin/artifact.mjs init, which adds a marker identifying the document’s type and cycle. The protocol calls this artifact provenance. You do not need to add the marker yourself. For example, a new scope document begins with a block like this:

<!-- STANDARDS
Artifact: SCOPE
Cycle: add-user-search-20260924T150000Z-a7f3c2e9
-->

The marker protects the file even if it is moved or renamed. Another cycle may read it as permitted prior evidence, but cannot overwrite it or claim it as its own.

There are two important distinctions:

  • An existing, unmarked project scope or design document can be updated as the project’s shared document. Referencing it in workflow state does not turn it into a cycle-owned file.
  • Tests, guides, and docstrings remain reusable project files. The reports describing their verification or documentation work belong to a cycle.

Development plans always belong to one cycle and include its ID in the filename. Verification, review, documentation, and synchronization records have fixed paths derived from that ID, and new scope and design documents are named after it. If a required path contains an unrelated or incorrectly marked file, dependent work stops until the conflict is resolved. A file with a broken marker is treated the same way wherever it is. The role cannot overwrite the file or quietly choose another path.

See output paths and the exact marker and preservation rules.

Workflow roles can update the installed state and mode records when the protocol requires it, such as when saving a handoff or unanswered question. standards reset also rewrites them. Roles cannot rewrite the installed protocol to change the rules.

Compatible guidance can be applied together, such as a project formatter and general coding style. If instructions materially conflict, the responsible role must resolve the problem, or ask you when no role has authority to settle it. A priority list does not authorize silently ignoring the conflict. See instruction conflicts.

Section titled “Navigator explains without changing anything”

Navigator has no workflow state or saved report. It can explain a problem and its likely owner, but cannot fix it, change workflow records, run another role, or approve work. Quiz feedback is about your understanding of the chosen topic. It is not a test result or review verdict.

See Navigator for its modes and boundaries.