CommunityRedacción y edicióngithub.com

dustinkeeton/wafflestack

🧇 Una mezcla para cada repositorio: definiciones reutilizables de agentes y habilidades de IA renderizadas en archivos nativos del entorno (.claude/, .codex/, .agents/)

¿Qué es wafflestack?

Esta habilidad orquesta la generación y sincronización de documentación técnica en repositorios que utilizan wafflestack, un ecosistema de definiciones reutilizables de agentes y habilidades de IA. Se ejecuta en tres pasos secuenciales: una auditoría de arquitectura de solo lectura que detecta cambios en el código fuente, seguida de la actualización automática de la documentación para máquinas (AGENTS.md) y luego la documentación para humanos (DECISIONS.md, STATUS.md, ARCHITECTURE.md). Cada paso utiliza un agente especializado (general-purpose, docs-agent y docs-human) cuyas salidas alimentan al siguiente, garantizando coherencia entre el código real, los registros de agentes y las guías del proyecto. Está diseñada para entornos como Claude Code, Cursor y Codex, asegurando que la documentación se mantenga actualizada sin intervención manual.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add dustinkeeton/wafflestack

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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.yaml desincronizadas con el uso de placeholders
  • Deriva en la salida renderizada: node installer/cli.mjs doctor --allow-missing limpio (renderizado confirmado + bloqueo en sincronía — volver a renderizar y confirmar después de ediciones de bundle); .gitignore sigue 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.md y ARCHITECTURE.md en 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.

Skills relacionados