/sync-project-docs

name: sync-project-docs
description: "Usar para sincronizar la documentación viva del proyecto después de una fase. También: actualizar docs/project, índice, architecture.md, compliance.md, threat-model."

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

1. Esqueleto e índice:

   python3 .claude/alfred-continuity.py sync-project-docs "$PWD"

2. Lee `docs/project/README.md` y el protocolo `commands/_docs_vivas.md`.

3. 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.

4. Cuando un esqueleto tenga contenido real, deja `<!-- alfred-doc:filled -->` y quita `<!-- alfred-doc:scaffold -->`.

5. Comprueba la gate:

   python3 .claude/alfred-continuity.py check-project-docs "$PWD" --command <comando> --phase <fase>

6. 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 (`scaffold` o `filled`).
• No hay prosa inventada sobre código que no se ha tocado.
• `check-project-docs` sale 0 antes de cerrar la gate.

Qué NO hacer

• No reescribas todo `docs/` en cada fase.
• No copies el chat al Markdown.
• No marques `filled` si siguen los `_(pendiente)_`.