Documentación Viva del Proyecto
Usa NOC Living Docs como memoria ejecutable del proyecto. Enruta a través de noc_docs/, lee solo los documentos afectados, actualiza la documentación viva cuando el código o la intención cambien, y luego verifica con la CLI.
Disparador
Usa este skill para:
- inicializar o migrar
noc_docs/ - discutir un requisito y luego cambiar código
- nuevas funcionalidades, correcciones de errores, refactorizaciones, cambios de API/datos/seguridad/despliegue
- comprobar si los cambios de código necesitan actualizaciones de documentación
- consultar o auditar la documentación viva del proyecto
No lo uses para preguntas generales que no involucren memoria del proyecto, comportamiento del código, requisitos, salvaguardas, pruebas o documentación NOC.
Ejecución
- Identifica la funcionalidad/dominio afectado a partir de la solicitud, las rutas modificadas y
noc_docs/.living-docs/feature-map.json. - Ejecuta un plan de trabajo cuando el código pueda cambiar:
python scripts/noc.py work /path/to/project --feature <feature> --intent "<requisito acordado>"
Usa --path <code/path> cuando las rutas sean más claras que los nombres de funcionalidades.
- Lee los documentos relevantes más pequeños:
agent-guide.md,requirements.md,status.md,guardrails.md,test-record.md, más las salvaguardas de dominio si están presentes. - Escribe la intención nueva/cambiada confirmada en
requirements.md; coloca discusiones inciertas ennotes.md. - Cambia el código.
- Actualiza
status.md,test-record.md,change-record.mdyguardrails.mdcuando el comportamiento, la verificación, los cambios importantes o las restricciones hayan cambiado. - Ejecuta
python scripts/noc.py index <project>después de cambios en documentos, funcionalidades o asignaciones. - Ejecuta
python scripts/noc.py check <project> --staged --warn-onlyantes del commit cuando Git esté disponible.
Para reglas detalladas del flujo de trabajo, lee references/workflow.md.
No Continuar
Detente y pregunta al usuario antes de editar código cuando:
- la solicitud entre en conflicto con
guardrails.mdo las salvaguardas de dominio - la intención del producto entre en conflicto con
requirements.mdy la dirección deseada no está clara - no se puede identificar la funcionalidad/dominio afectado y el cambio no es obviamente global
- faltan documentos requeridos y la tarea depende de requisitos o restricciones desconocidas
- el usuario pide reescribir silenciosamente los requisitos para que coincidan con el código actual
- el cambio afecta seguridad, permisos, facturación, pérdida de datos, migraciones o contratos de API pública y el comportamiento solicitado es ambiguo
Definición de Hecho
Una tarea que usa este skill se considera completa solo cuando:
- los documentos afectados fueron identificados a través del mapa de funcionalidades, rutas o nombre explícito de funcionalidad
- los documentos requeridos fueron leídos o se señaló la falta de documentos
- los cambios de código y de documentación coinciden
requirements.mdcambió solo por cambios de comportamiento intencionadosstatus.mdrefleja el comportamiento actual después de los cambios de códigotest-record.mdregistra la verificación o explica por qué no se ejecutó la verificaciónchange-record.mdregistra cambios importantes de implementación- los índices/verificaciones se ejecutaron cuando estaban disponibles, o se omitieron con justificación
Formato de Respuesta Final
Termina con:
NOC Living Docs:
- docs verificados:
- docs actualizados:
- docs intencionalmente sin cambios:
- comandos ejecutados:
- pruebas ejecutadas:
- riesgos restantes:
Mantén las listas cortas. Usa ninguno cuando una categoría no aplica.
Referencias
references/workflow.md: selección de modo, reglas de respaldo, manejo de conflictos, ciclo de trabajoreferences/feature-doc-template.md: qué debe contener cada documento de funcionalidadreferences/domain-mode-guide.md: cuándo y cómo usar el modo de dominioreferences/codex-prompts.md: indicaciones de usuario recomendadas para flujos de plan/objetivo/código de Codex