Referencia · meta.json

meta.json

Campos, identificador, tipo, estado y commits del registro duradero de cada Work Item.

ocho campos · registro duradero · commits

Ubicación

Cada Work Item vive en .rei/specs/<work-item-id>/ y contiene un único meta.json. El nombre de la carpeta es el id inmutable del Work Item y debe coincidir con .rei/progress/work-items/<work-item-id>/.

Estructura
.rei/specs/
└── <work-item-id>/
    ├── meta.json
    └── ...

Campos

CampoContenido
idIdentificador inmutable. Coincide con la carpeta de .rei/specs/ y de .rei/progress/work-items/.
titleNombre corto y descriptivo del Work Item.
descriptionDescripción técnica del acuerdo alcanzado con el usuario; no copia la conversación.
typefeature o task.
statusEtapa actual del workflow. Los valores válidos y sus transiciones están en la referencia de estados.
created_atFecha y hora de creación en ISO 8601, con zona horaria. Coincide con el prefijo del id.
base_commitSHA del commit que marca el inicio de la implementación. Vacío si el proyecto no usa git.
last_review_commitSHA del punto ya revisado. Vacío si no aplica.

El identificador

El id se construye con la fecha y hora de creación y un slug en kebab-case. No cambia aunque el trabajo se reanude o cambie el título.

Formato
YYYY-MM-DD_HH-mm__slug-en-kebab-case

Si ya existe un identificador igual, se añade un sufijo numérico al slug (-2, -3, ...) sin modificar la fecha y hora originales. El id se genera al crear el Work Item; no se reescribe después.

type y status

type decide la planificación que se genera y si la integración con GitHub Issues abre issue y rama. Una feature produce requirements.md, design.md y tasks.md; una task produce plan.md y no genera issue ni rama.

status registra la etapa del workflow y admite los siete estados del arnés. Su significado y sus transiciones se documentan en la referencia de estados, que es la fuente única; no se repiten aquí.

base_commit y last_review_commit

Ambos campos los escribe el CLI con el commit actual de git. base_commit lo registra el Leader al aprobar el Work Item; last_review_commit lo registra el Reviewer al rechazar la implementación.

Registrar un commit
rei commit set <work-item-id> base_commit
rei commit set <work-item-id> last_review_commit
  • rei review-diff usa base_commit como punto base del paquete de revisión.
  • Si last_review_commit está presente, review-diff calcula el diff desde ese punto y la revisión ve solo los cambios pedidos.
  • Para que el diff quede acotado, la implementación debe estar commiteada antes de solicitar la revisión; si no lo está, el diff cubre todo lo pendiente desde base_commit.
  • En un proyecto sin git ambos campos quedan vacíos.

meta.json y current.md

meta.json es el registro duradero de cada Work Item y la referencia para diagnosticar el conjunto con rei items status. current.md es el contexto vivo de la sesión activa: sirve para retomarla exactamente donde quedó si la conversación se interrumpe.

ArchivoQué registraAlcance
meta.jsonTipo, estado, fechas y commits.Duradero; sobrevive al cierre de la sesión.
current.mdEstado, plan, bitácora y próximo paso.Sesión activa; se archiva al cerrar el Work Item.

Los dos archivos se mantienen y son complementarios. El estado de meta.json no se deduce de la conversación ni de la memoria del agente.

Aprobación de la planificación

Pendiente

La firma humana libera la hoja. El silencio no aprueba.

La aprobación se registra desde el CLI; el visor no la sustituye.