Agentes de programación y skills en una app del Chatfuel wizard

El Chatfuel wizard termina entregándole la nueva app a un agente de programación. Instala una skill por cada módulo que elegiste, escribe el archivo de instrucciones que el agente lee al inicio de cada sesión y ofrece abrir el agente en el proyecto con una lista de verificación de configuración. Son compatibles Claude Code y Codex CLI. Las skills contienen lo que el agente necesita para cambiar la app de forma segura: las operaciones GraphQL del módulo, cómo funciona esa parte de la Public API y las reglas que aplica el proxy de la app.

Qué agentes de programación admite el wizard

El wizard busca Claude Code (claude) y Codex CLI (codex) en tu PATH:

• Encuentra un agente: el wizard lo usa.
• Encuentra los dos: el wizard pregunta cuál continúa el trabajo. --agent claude o --agent codex responde de antemano.
• No encuentra ninguno: el wizard ofrece instalar uno con npm i -g @anthropic-ai/claude-code o npm i -g @openai/codex.

Solo se escribe una estructura, la del agente que elegiste:

• Claude Code: skills en .claude/skills/, instrucciones en CLAUDE.md.
• Codex CLI: skills en .agents/skills/, instrucciones en AGENTS.md, que indica la ruta completa de cada skill.

Qué contienen las skills

Cada módulo instala una skill llamada chatfuel-<id>, como chatfuel-contacts o chatfuel-bookings. Una skill contiene la estructura de ese módulo, las operaciones GraphQL que usa, referencias sobre las partes de la Public API que tiene detrás y guías para los cambios comunes. Dos skills vienen con todas las apps, sin importar lo que elegiste:

• chatfuel-core: autenticación, las reglas del proxy, el transporte HTTP y WebSocket, la paginación, el esquema GraphQL de Chatfuel y un validador para operaciones nuevas.
• chatfuel-update: cómo leer lo que informa npx @chatfuel/wizard update y resolver los archivos que cambiaste y que la actualización también cambia.

El wizard pregunta dónde instalar las skills: en el proyecto o en tu directorio personal, para que una sola copia sirva a todas las apps que crees. Módulos del wizard enumera los módulos a los que pertenece cada skill.

Qué dicen el archivo de instrucciones y la lista de verificación de configuración

El wizard escribe dos archivos para el agente, con funciones distintas:

• El archivo de instrucciones (CLAUDE.md o AGENTS.md) se lee en cada sesión y es breve: las rutas de los módulos de la app, las skills que hay que leer antes de tocar la API, qué claves de .env son secretas, con la regla "NEVER print or commit", y cómo retomar la configuración.
• La lista de verificación de configuración se lee una sola vez, en la entrega: qué decirte en el primer mensaje, un recorrido por los módulos instalados con enlaces a la app, los permisos de Chatfuel que necesita cada módulo y las primeras tareas de cada módulo. Para Claude Code es el comando /chatfuel:finish-setup; para Codex es la skill chatfuel-finish-setup.

Cuando aceptas la oferta de abrir el agente al final de la ejecución, el wizard inicia el agente en el nuevo proyecto con la lista de verificación. El agente inicia por sí mismo el servidor de desarrollo y te saluda con lo que se creó. Para retomarla más tarde, ejecuta claude /chatfuel:finish-setup en el directorio de la app o pídele a Codex que use la skill chatfuel-finish-setup.

Con --embed, tu archivo de instrucciones existente no se reemplaza. El wizard escribe su parte entre los marcadores <!-- chatfuel:begin --> y <!-- chatfuel:end -->, y al volver a ejecutarlo solo reescribe esa parte.

Prompts que funcionan con una app del wizard

Nombra el módulo y el resultado que quieres; el agente encuentra la skill correspondiente. Estos prompts vienen de las primeras tareas de las notas de entrega de los módulos:

• "Agrega una búsqueda a la lista del chat en vivo y haz que la consulta de la lista de conversaciones y su suscripción en tiempo real usen el mismo filtro." Lo resuelve chatfuel-livechat.
• "Agrega una leyenda de colores de estado a la barra de herramientas del calendario de reservas." Lo resuelve chatfuel-bookings.
• "Agrega un módulo llamado notas con una pantalla de lista y una pantalla de archivados." Lo resuelve chatfuel-core, que describe dónde vive un módulo y qué puede importar.
• "Cambia los colores de acento de la app y nada más." Lo resuelve chatfuel-core: los colores viven en un solo archivo de tokens de diseño.
• "Agrega archivos adjuntos al editor de mensajes del chat en vivo." Lo resuelve chatfuel-livechat, con chatfuel-core para la ruta de carga.

Cómo agrega el agente una nueva operación de la API

El proxy de la app solo reenvía los documentos GraphQL con los que se compiló la app y rechaza todo lo demás, así que una operación nueva o modificada requiere tres pasos. Menciónalos en tu prompt y el agente hace los tres:

1. Parte de las operaciones del módulo en su skill y escribe el nuevo documento.
2. Valídalo con el esquema de Chatfuel usando el validador de chatfuel-core.
3. Agrégalo al archivo de operaciones del módulo en la app y ejecuta npm run codegen, que le asigna tipos y lo registra en el proxy.

La introspección está desactivada en producción, así que el agente trabaja con el esquema que está dentro de chatfuel-core. La descripción general de la Public API y las páginas de referencia de esta sección describen las mismas operaciones.

Cómo dejar que el agente también trabaje con tus bots

Las skills le enseñan el código al agente. Para que el mismo agente lea y cambie tus bots de Chatfuel mientras desarrolla, por ejemplo para revisar un contacto o una configuración, conecta el servidor MCP de Chatfuel: Claude Code o Codex.