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
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
- requirements.md
- design.md
- tasks.md
El trabajo necesita especificación, hay varias decisiones de diseño o cambia el comportamiento o la arquitectura.
Task
- plan.md
Documentación, contratos o un cambio pequeño y localizado, sin cambio de comportamiento ni de arquitectura.
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.
- pendingWork Item creado, pendiente de planificación.
- readyPlanificación terminada, esperando aprobación humana.
- Aprobación de la planificaciónLa firma humana libera la hoja. El silencio no aprueba.
- in_progressImplementación en curso. Solo puede haber uno a la vez.
- reviewImplementación finalizada, pendiente de revisión.
- doneCompletado y aprobado; estado terminal.
- 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.
Evidencia versionada
El repositorio guarda la evidencia del trabajo; el chat no es el registro. Cada documento tiene un responsable y un momento.
rei item show 2026-10-27_22-04__home-demostrativa-playwright2026-10-2824 líneas
- rei item show 2026-10-27_22-04__home-demostrativa-playwright
- Work Item: 2026-10-27_22-04__home-demostrativa-playwright
- title: Home demostrativa con demos y capturas reales
- type: feature
- status: done
- created_at: 2026-10-27T22:04:00-05:00
- base_commit: 8df53a9599b424ee1b3f62bf48562068de70b082
- last_review_commit: (vacío)
- Enlaces: (sin links.json)
- Documentos:
- plan.md no
- requirements.md sí
- design.md sí
- tasks.md sí
- impl.md sí
- review.md sí
- spec.md no
- Sesión: no es la sesión activa
- Validación:
- (sin hallazgos)
- 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
- rei validate 2026-10-27_22-04__home-demostrativa-playwright
- == Validando Work Item: 2026-10-27_22-04__home-demostrativa-playwright ==
- Resultado: OK
Salida completa.
rei doctor2026-10-2843 líneas
- rei doctor
- [OK] AGENTS.md
- [OK] .rei/docs/harness/workflow.md
- [OK] .rei/docs/harness/specs.md
- [OK] .rei/docs/harness/task.md
- [OK] .rei/docs/harness/meta.md
- [OK] .rei/docs/harness/progress.md
- [OK] .rei/docs/harness/integrations/github.md
- [OK] .rei/docs/harness/integrations/github/core.md
- [OK] .rei/docs/harness/integrations/github/backlog.md
- [OK] .rei/docs/harness/integrations/github/templates.md
- [OK] .rei/docs/harness/integrations/github/errors.md
- [OK] .rei/docs/project/architecture.md
- [OK] .rei/docs/project/conventions.md
- [OK] .rei/docs/project/verification.md
- [OK] .rei/agents/leader.md
- [OK] .rei/agents/spec_author.md
- [OK] .rei/agents/implementer.md
- [OK] .rei/agents/initializer.md
- [OK] .rei/agents/reviewer.md
- [OK] .rei/templates/current.md
- [OK] .rei/templates/history.md
- [OK] .rei/templates/meta.json
- [OK] .rei/specs/
- [OK] .rei/progress/work-items/
- [OK] .rei/progress/current.md
- [OK] .rei/progress/history.md
- [OK] Documentación del proyecto personalizada.
- [OK] 2026-10-27_00-31__estrategia-producto-web
- [OK] 2026-10-27_01-54__fundaciones-visuales-shell-docs
- [OK] 2026-10-27_02-59__tests-logica-jest
- [OK] 2026-10-27_03-17__contenido-producto-flujo
- [OK] 2026-10-27_11-04__pulido-home-copy-aprobacion
- [OK] 2026-10-27_11-36__conceptos-guias-docs
- [OK] 2026-10-27_12-08__referencia-operacion-docs
- [OK] 2026-10-27_20-34__pulido-hero-inline-github-issues
- [OK] 2026-10-27_22-04__home-demostrativa-playwright
- [OK] 2026-10-28_01-06__pulido-tipografia-movil-a11y
- [OK] 2026-10-28_02-49__producto-secciones-full-bleed
- [OK] 2026-10-28_23-07__producto-ciclo-terminal-interactivos
- [OK] Sesión activa: 2026-10-28_23-07__producto-ciclo-terminal-interactivos (estado: in_progress, agente: _—_)
- [OK] Repositorio git detectado. HEAD=e7c9a600ae6a67e782e3b281a45f72e10c876db6
- [INFO] 2 checks configurados en .rei/config.json (no ejecutados).
- [OK] Sin fallos. Harness íntegro.
La salida se desplaza en vertical y en horizontal dentro de la ventana; el texto está completo.
.rei/specs/<id>/
.rei/
specs/ <id>/ meta.json Tipo, estado, base_commit y last_review_commit.
Leader al crear y aprobar; Reviewer al rechazar
.rei/
specs/ <id>/ requirements.md Qué debe hacer la Feature y cómo se verifica.
Spec Author
.rei/
specs/ <id>/ design.md Cómo se implementa: decisiones, archivos y verificación.
Spec Author
.rei/
specs/ <id>/ tasks.md Tareas ordenadas con su R-id.
Spec Author
.rei/
specs/ <id>/ plan.md Plan breve de una Task, paso a paso.
Spec Author
.rei/
specs/ <id>/ links.json Issue, rama y base cuando la integración GitHub está activa.
Leader · integración GitHub
.rei/progress/
.rei/
progress/ current.md Sesión viva: estado, bitácora y próximo paso.
Spec Author lo inicia; Implementer lo mantiene
.rei/
progress/ history.md Resumen append-only de cada Work Item cerrado.
Reviewer al archivar la sesión
.rei/progress/work-items/<id>/
.rei/
progress/ work-items/ <id>/ impl.md Resumen, archivos, cambios y verificación de la implementación.
Implementer
.rei/
progress/ work-items/ <id>/ review.md Veredicto, verificaciones, observaciones y acciones requeridas.
Reviewer
.rei/
progress/ work-items/ <id>/ spec.md Motivo del bloqueo, información faltante y decisiones que requieren intervención humana.
Spec Author
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.