Orquestación de Documentación
Cuando se invoque esta habilidad, ejecute el siguiente flujo:
Paso 1: Auditoría de Arquitectura
Invoque al agente general-purpose con esta instrucción:
Audite el código base actual en busca de cambios desde la última actualización de la documentación. Lea la documentación de máquina existente (un registro raíz único
AGENTS.md) y compárela con el proyecto real. Produzca un informe de cambios conciso que cubra:
- Nuevos o eliminados bundles, habilidades, agentes, claves de configuración o comandos CLI
- Exportaciones del instalador o semántica de plantillas modificadas (
installer/lib/*.mjs)- Declaraciones de configuración en
bundle.yamldesincronizadas con el uso de placeholders- Deriva en la salida renderizada:
node installer/cli.mjs doctor --allow-missinglimpio (renderizado confirmado + bloqueo en sincronía — volver a renderizar y confirmar después de ediciones de bundle);.gitignoresigue cubriendo los renders deliberadamente no rastreados (flujo de trabajo de enlace de etiqueta, worktrees, documentos de visión general.waffle/)Emita ÚNICAMENTE el informe de cambios como texto estructurado. NO modifique ningún archivo.
Paso 2: Documentación para Agentes
Tome el informe de cambios e invoque al agente docs-agent con esta instrucción:
Aquí está el informe de cambios de arquitectura para el código base de wafflestack:
{salida del paso 1}
Actualice la documentación de máquina — un registro raíz único
AGENTS.md— para reflejar el estado actual del proyecto. Lea los archivos fuente reales para verificar los detalles — no se base únicamente en el informe de cambios. Siga las pautas de la habilidad docs-agent para el formato y la estructura.
Paso 3: Documentación para Humanos
Una vez que docs-agent complete, invoque al agente docs-human con esta instrucción:
La documentación de máquina acaba de ser actualizada. Actualice la documentación orientada a humanos —
DECISIONS.md,STATUS.mdyARCHITECTURE.mden la raíz del repositorio — para que coincida.Lea la documentación de máquina actualizada y el código fuente real para garantizar la precisión. Siga las pautas de la habilidad docs-human para el formato, la estructura y sus barreras de seguridad (los documentos en voz del propietario se marcan, nunca se reescriben).
Importante
- Cada paso debe completarse antes de que comience el siguiente — la salida de cada uno informa al siguiente.
- El paso 1 es de solo lectura — el agente de auditoría solo informa.
- docs-agent y docs-human DEBEN modificar sus respectivos archivos de documentación.