Sincronizar documentación viva
Resumen
Tras una fase, actualiza solo lo que ha cambiado. El helper crea esqueletos y comprueba la gate. Tú escribes el contenido.
Proceso
-
Esqueleto e índice:
bashpython3 .claude/alfred-continuity.py sync-project-docs "$PWD" -
Lee
docs/project/README.mdy el protocolocommands/_docs_vivas.md. -
Actualiza únicamente los ficheros de la fase. Si no hubo API nueva, no toques una guía de API. Si no hubo decisión, no inventes un ADR.
-
Cuando un esqueleto tenga contenido real, deja
<!-- alfred-doc:filled -->y quita<!-- alfred-doc:scaffold -->. -
Comprueba la gate:
bashpython3 .claude/alfred-continuity.py check-project-docs "$PWD" --command <comando> --phase <fase> -
Si el helper falla, no declares la fase cerrada.
En quick y fix
Sync mínimo: índice + docs/project/current.md. ADR solo si el cambio mueve
un límite (auth, persistencia, integración).
Criterios de éxito
- El índice refleja el estado real (
scaffoldofilled). - No hay prosa inventada sobre código que no se ha tocado.
check-project-docssale 0 antes de cerrar la gate.
Qué NO hacer
- No reescribas todo
docs/en cada fase. - No copies el chat al Markdown.
- No marques
filledsi siguen los_(pendiente)_.

