REI HARNESS / DOSSIER DE PRODUCTO

HOJA 04 / 06

v0.3.0 · ES

Producto · Work Items

Work Items

Feature frente a Task, ciclo de vida, aprobación previa y evidencia versionada con revisión por diff.

Feature frente a Task · evidencia versionada

P.01Tipos

Hoja destacada

Feature o Task

Todo trabajo nace como Work Item con un identificador y un tipo. El tipo decide qué planificación se genera y si la integración con GitHub Issues abre issue y rama.

Feature

03 documentos

Planificación

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

Criterio

El trabajo necesita especificación, hay varias decisiones de diseño o cambia el comportamiento o la arquitectura.

Task

01 documento

Planificación

  • plan.md

Criterio

Documentación, contratos o un cambio pequeño y localizado, sin cambio de comportamiento ni de arquitectura.

P.02Ciclo

Ciclo de vida y aprobación previa

Features y Tasks comparten los mismos estados. Ningún Work Item puede implementarse sin una planificación aprobada, y ninguno finaliza sin pasar por el Reviewer.

  1. 01pendingWork Item creado, pendiente de planificación.
  2. 02readyPlanificación terminada, esperando aprobación humana.
  3. Aprobación de la planificaciónfirma humanaLa firma humana libera la hoja. El silencio no aprueba.
  4. 03in_progressImplementación en curso. Solo puede haber uno a la vez.
  5. 04reviewImplementación finalizada, pendiente de revisión.
  6. 05doneterminalCompletado y aprobado; estado terminal.

Ramas · fuera del ciclo

  • blockedEl trabajo no puede continuar.
  • changes_requestedLa revisión rechazó la implementación y pide cambios.

Ramas, no atajos: describen trabajo detenido o una revisión que exige correcciones.

La aprobación previa es un punto de control, no un trámite: la persona revisa requisitos, diseño y tareas antes de que se escriba código. Si el Reviewer rechaza la implementación, el Work Item vuelve a in_progress con cambios solicitados.

P.03Evidencia

Evidencia versionada

El repositorio guarda la evidencia del trabajo; el chat no es el registro. Cada documento tiene un responsable y un momento.

rei

rei item show 2026-10-27_22-04__home-demostrativa-playwright2026-10-2824 líneas
  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

La salida se desplaza en vertical y en horizontal dentro de la ventana; el texto está completo.

rei validate 2026-10-27_22-04__home-demostrativa-playwright2026-10-283 líneas
  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

Salida completa.

rei doctor2026-10-2843 líneas
  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.

La salida se desplaza en vertical y en horizontal dentro de la ventana; el texto está completo.

Instantánea del 2026-10-28: el estado de los Work Items cambia con el tiempo.La primera salida está abierta; el resto se despliega con Enter o un toque.

árbol · .rei/

.rei/specs/<id>/

Planificación

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

    Tipo, estado, base_commit y last_review_commit.

    estado

    Leader al crear y aprobar; Reviewer al rechazar

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

    Qué debe hacer la Feature y cómo se verifica.

    Feature

    Spec Author

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

    Cómo se implementa: decisiones, archivos y verificación.

    Feature

    Spec Author

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

    Tareas ordenadas con su R-id.

    Feature

    Spec Author

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

    Plan breve de una Task, paso a paso.

    Task

    Spec Author

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

    Issue, rama y base cuando la integración GitHub está activa.

    opcional

    Leader · integración GitHub

.rei/progress/

Sesión

  • .rei/progress/current.md

    Sesión viva: estado, bitácora y próximo paso.

    sesión

    Spec Author lo inicia; Implementer lo mantiene

  • .rei/progress/history.md

    Resumen append-only de cada Work Item cerrado.

    sesión

    Reviewer al archivar la sesión

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

Registro del Work Item

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

    Resumen, archivos, cambios y verificación de la implementación.

    Feature y Task

    Implementer

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

    Veredicto, verificaciones, observaciones y acciones requeridas.

    Feature y Task

    Reviewer

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

    Motivo del bloqueo, información faltante y decisiones que requieren intervención humana.

    solo bloqueo

    Spec Author

11 documentos. Cada documento aparece una vez y conserva su ruta real. La derecha dice quién lo escribe.

P.04Revisión

Revisión por diff

Con git, la revisión se acota a los cambios reales del Work Item. base_commit marca el inicio de la implementación y last_review_commit el punto ya revisado; rei review-diff genera el paquete de revisión. Sin git, el flujo sigue funcionando en modo lectura.