REI HARNESS / PRODUCT DOSSIER

SHEET 04 / 06

v0.3.0 · EN

Product · Work Items

Work Items

Feature vs Task, lifecycle, prior approval and versioned evidence with review by diff.

Feature vs Task · versioned evidence

P.01Types

Featured sheet

Feature or Task

All work starts as a Work Item with an identifier and a type. The type decides which plan is generated and whether the GitHub Issues integration opens an issue and a branch.

Feature

03 documents

Planning

  • requirements.md
  • design.md
  • tasks.md

Criterion

The work needs a specification, involves several design decisions, or changes behavior or architecture.

Task

01 document

Planning

  • plan.md

Criterion

Documentation, contracts or a small, localized change, with no change in behavior or architecture.

P.02Cycle

Lifecycle and prior approval

Features and Tasks share the same states. No Work Item can be implemented without an approved plan, and none finishes without going through the Reviewer.

  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.

Prior approval is a checkpoint, not a formality: the person reviews requirements, design and tasks before any code is written. If the Reviewer rejects the implementation, the Work Item returns to in_progress with the requested changes.

P.03Evidence

Versioned evidence

The repository keeps the evidence of the work; the chat is not the record. Each document has an owner and a moment.

rei

rei item show 2026-10-27_22-04__home-demostrativa-playwright2026-10-2824 lines
  1. rei item show 2026-10-27_22-04__home-demostrativa-playwright
  2. Work Item: 2026-10-27_22-04__home-demostrativa-playwright
  3. title: Home demostrativa con demos y capturas reales
  4. type: feature
  5. status: done
  6. created_at: 2026-10-27T22:04:00-05:00
  7. base_commit: 8df53a9599b424ee1b3f62bf48562068de70b082
  8. last_review_commit: (vacío)
  9. Enlaces: (sin links.json)
  10. Documentos:
  11. plan.md no
  12. requirements.md sí
  13. design.md sí
  14. tasks.md sí
  15. impl.md sí
  16. review.md sí
  17. spec.md no
  18. Sesión: no es la sesión activa
  19. Validación:
  20. (sin hallazgos)
  21. Resultado: OK

The output scrolls vertically and horizontally inside the window; the text is complete.

rei validate 2026-10-27_22-04__home-demostrativa-playwright2026-10-283 lines
  1. rei validate 2026-10-27_22-04__home-demostrativa-playwright
  2. == Validando Work Item: 2026-10-27_22-04__home-demostrativa-playwright ==
  3. Resultado: OK

Complete output.

rei doctor2026-10-2843 lines
  1. rei doctor
  2. [OK] AGENTS.md
  3. [OK] .rei/docs/harness/workflow.md
  4. [OK] .rei/docs/harness/specs.md
  5. [OK] .rei/docs/harness/task.md
  6. [OK] .rei/docs/harness/meta.md
  7. [OK] .rei/docs/harness/progress.md
  8. [OK] .rei/docs/harness/integrations/github.md
  9. [OK] .rei/docs/harness/integrations/github/core.md
  10. [OK] .rei/docs/harness/integrations/github/backlog.md
  11. [OK] .rei/docs/harness/integrations/github/templates.md
  12. [OK] .rei/docs/harness/integrations/github/errors.md
  13. [OK] .rei/docs/project/architecture.md
  14. [OK] .rei/docs/project/conventions.md
  15. [OK] .rei/docs/project/verification.md
  16. [OK] .rei/agents/leader.md
  17. [OK] .rei/agents/spec_author.md
  18. [OK] .rei/agents/implementer.md
  19. [OK] .rei/agents/initializer.md
  20. [OK] .rei/agents/reviewer.md
  21. [OK] .rei/templates/current.md
  22. [OK] .rei/templates/history.md
  23. [OK] .rei/templates/meta.json
  24. [OK] .rei/specs/
  25. [OK] .rei/progress/work-items/
  26. [OK] .rei/progress/current.md
  27. [OK] .rei/progress/history.md
  28. [OK] Documentación del proyecto personalizada.
  29. [OK] 2026-10-27_00-31__estrategia-producto-web
  30. [OK] 2026-10-27_01-54__fundaciones-visuales-shell-docs
  31. [OK] 2026-10-27_02-59__tests-logica-jest
  32. [OK] 2026-10-27_03-17__contenido-producto-flujo
  33. [OK] 2026-10-27_11-04__pulido-home-copy-aprobacion
  34. [OK] 2026-10-27_11-36__conceptos-guias-docs
  35. [OK] 2026-10-27_12-08__referencia-operacion-docs
  36. [OK] 2026-10-27_20-34__pulido-hero-inline-github-issues
  37. [OK] 2026-10-27_22-04__home-demostrativa-playwright
  38. [OK] 2026-10-28_01-06__pulido-tipografia-movil-a11y
  39. [OK] 2026-10-28_02-49__producto-secciones-full-bleed
  40. [OK] 2026-10-28_23-07__producto-ciclo-terminal-interactivos
  41. [OK] Sesión activa: 2026-10-28_23-07__producto-ciclo-terminal-interactivos (estado: in_progress, agente: _—_)
  42. [OK] Repositorio git detectado. HEAD=e7c9a600ae6a67e782e3b281a45f72e10c876db6
  43. [INFO] 2 checks configurados en .rei/config.json (no ejecutados).
  44. [OK] Sin fallos. Harness íntegro.

The output scrolls vertically and horizontally inside the window; the text is complete.

Snapshot from 2026-10-28: the state of Work Items changes over time.The first output is open; the rest expand with Enter or a tap.Outputs are transcribed from the CLI as captured, so some words are in Spanish.

tree · .rei/

.rei/specs/<id>/

Planning

  • .rei/specs/<id>/meta.json

    Type, status, base_commit and last_review_commit.

    state

    Leader on create and approve; Reviewer on reject

  • .rei/specs/<id>/requirements.md

    What the Feature must do and how it is verified.

    Feature

    Spec Author

  • .rei/specs/<id>/design.md

    How it is implemented: decisions, files and verification.

    Feature

    Spec Author

  • .rei/specs/<id>/tasks.md

    Ordered tasks with their R-id.

    Feature

    Spec Author

  • .rei/specs/<id>/plan.md

    Short step-by-step plan for a Task.

    Task

    Spec Author

  • .rei/specs/<id>/links.json

    Issue, branch and base when the GitHub integration is active.

    optional

    Leader · GitHub integration

.rei/progress/

Session

  • .rei/progress/current.md

    Live session: state, log and next step.

    session

    Spec Author starts it; Implementer maintains it

  • .rei/progress/history.md

    Append-only summary of each closed Work Item.

    session

    Reviewer when archiving the session

.rei/progress/work-items/<id>/

Work Item record

  • .rei/progress/work-items/<id>/impl.md

    Summary, files, changes and verification of the implementation.

    Feature and Task

    Implementer

  • .rei/progress/work-items/<id>/review.md

    Verdict, verifications, observations and required actions.

    Feature and Task

    Reviewer

  • .rei/progress/work-items/<id>/spec.md

    Reason for the block, missing information and decisions that need human intervention.

    block only

    Spec Author

11 documents. Each document appears once and keeps its real path. The right column says who writes it.

P.04Review

Review by diff

With git, review is limited to the actual changes of the Work Item. base_commit marks the start of the implementation and last_review_commit the point already reviewed; rei review-diff produces the review package. Without git, the flow still works in read mode.