REI HARNESS / PRODUCT DOSSIER

SHEET 02 / 06

v0.3.0 · EN

Product · Flow

How it works

The full flow of a Work Item, the human approval gate, the states and direct mode.

One Work Item · one gate · a single in_progress

P.01Flow

Featured sheet

From request to close

A Work Item goes through the same flow whether it is a Feature or a Task. What changes is the plan the Spec Author produces: requirements, design and tasks for a Feature; a short plan for a Task.

cycle · work item

SIMULATION
01 / 06

Step 01 / 06

Leader

pending

Work Item created, waiting to be planned.

Exits

  • pending → readyCycle

    The Spec Author finishes the plan.

  • pending → blockedBranch

    The work cannot continue.

Reduced motion: manual walkthrough.

Simulation: it does not run commands or approve Work Items.

The window is an automatic simulation: when it scrolls into view it runs through the six stops and pauses at the gate to stage the sign-off. The cursor, the "Approve" button and the check are fake; real approval is human and is recorded from the CLI. You can pause it or step through the stops by hand: the simulation does not run commands or approve Work Items. The state table below keeps the full record.

The state of the work does not live in the conversation: meta.json records the stage of each Work Item and current.md reflects the active session so it can be resumed.

P.02Gate

The approval gate

The gate is real: the Work Item stays in ready until the person reviews the plan and decides. Approval is given in the chat or the terminal, and the Leader records the step with rei status set <id> in_progress. The viewer does not replace it.

P.03States

States and branches

The cycle has five states and two branches. blocked and changes_requested are not shortcuts: they describe work that cannot continue or a review that demands corrections.

  1. 01pendingWork Item created, waiting to be planned.
  2. 02readyPlanning finished, waiting for human approval.
  3. Planning approvalhuman sign-offA human sign-off releases the sheet. Silence is not approval.
  4. 03in_progressImplementation under way. Only one can exist at a time.
  5. 04reviewImplementation finished, waiting for review.
  6. 05doneterminalCompleted and approved; terminal state.

Branches · outside the cycle

  • blockedThe work cannot continue.
  • changes_requestedThe review rejected the implementation and asks for changes.

Branches, not shortcuts: they describe stopped work or a review that demands corrections.

  • Only one Work Item can be in_progress at a time. The limit is enforced by rei status set, rei check, rei doctor and rei items status.
  • done is terminal: you do not leave it through a standard transition.
  • If the Reviewer rejects, the Work Item moves to changes_requested and returns to in_progress with the corrections.
  • If the work cannot continue at any point, it moves to blocked.

P.04Direct mode

Authorized direct mode

There is a path outside the workflow for trivial changes that are explicitly requested. It is not a Work Item type or a state: it works on the current branch and tree, and it creates no Work Item, plan, session, issue or branch.

  1. 01

    Eligible

    Documentation, typos, formatting, comments or trivial adjustments with no change in behavior.

  2. 02

    Refusal

    If it affects behavior, security, data, dependencies, public API, architecture, more than one file, or needs a specification or review, the Leader refuses and offers a Task or a Feature.

  3. 03

    Authorization

    The Leader asks for explicit confirmation and states that there will be no plan, branch or record.

  4. 04

    No record

    The only trace is the diff or commit and the conversation; current.md, meta.json and history.md are not written.

  5. 05

    Delivery

    Without an explicit order there is no commit, push, PR or merge.

P.05Context

How it fits with the home page and the documentation

The home page presents the product; this section explains the mechanism and the gate; the documentation teaches concrete tasks. None of the three duplicates the others.