REI HARNESS / PRODUCT DOSSIER

SHEET 03 / 06

v0.3.0 · EN

Product · Roles

Agents

The five REI Harness roles, their responsibility, their limit and when they step in.

Five roles · explicit contracts

P.01Roles

Featured sheet

Five roles, five limits

REI separates coordinating, planning, implementing, reviewing and customizing. Each role has its own contract with a responsibility, a limit and a moment of intervention; none steps into another's work.

  1. 01

    Leader

    On every request and while coordinating the workflow.

    Understands the request, picks the workflow and coordinates the other roles.

    Limit · Does not implement, except in the authorized direct mode.

  2. 02

    Spec Author

    When the Work Item is in pending and it is time to plan it.

    Turns a pending Work Item into a technical plan that can be reviewed.

    Limit · Never implements.

  3. Planning approval

    Pending

    A human sign-off releases the sheet. Silence is not approval.

  4. 03

    Implementer

    When the Work Item is in in_progress with an approved plan.

    Implements only the approved plan and leaves verification evidence.

    Limit · Does not change the scope or the plan.

  5. 04

    Reviewer

    When the Work Item is in review.

    Validates the work against the plan and the project checkpoints.

    Limit · Does not implement: approves or requests changes.

Outside the cycle

Initializer

Guides the customization of the project documentation after rei init.

After rei init, while customization placeholders remain.

Does not implement code or write outside the customization documents.

Prepares the repository; does not approve or implement Work Items.

Initializer · /personalize

The CLIs with a native adapter, OpenCode and Claude Code, recognize /personalize as a project command: it starts the Initializer interview, which guides the customization of the documentation. The Initializer does not implement code or approve Work Items. The capture shows Claude Code as an example, and the command runs in the agent's runtime, not on this site.

claude code · /personalize

Claude Code v2.1.312 terminal with the project command list open: `/init` and `/personalize`, the latter described as the project customization interview (initializer role).
Capture from a sample project · the command does not run on this siteView full capture
The capture shows Claude Code; native adapters expose the same command. The site only shows the evidence. · captured 2026-10-28

P.02Cycle

The four roles in the cycle

Leader, Spec Author, Implementer and Reviewer take the Work Item from start to finish. The Initializer stays outside the cycle: it guides the customization of the project documentation after rei init, when placeholders remain.

P.03Contracts

Contracts and adapters

The canonical contract lives in .rei/agents/. If the runtime has a native adapter, rei init opencode or rei init claude generate one subagent per role from the ## Contrato section. Cursor and Codex work through a fallback: the Leader passes only that contract, with no extra configuration.

Generated files carry the GENERATED marker and installation is idempotent: if they are already up to date they are not modified, and a file they did not generate is never overwritten. rei init opencode --check or rei init claude --check detect drift without writing anything.

P.04Limits

What does not change with the runtime

  • The contract is the source; the adapter is an optional layer.
  • Invoking a subagent directly does not remove the workflow: the Work Item still needs a plan and approval.
  • The Leader passes the subagent only the role contract, never the whole file.
  • Adapter installation is idempotent and does not overwrite files that are not its own.