Agentes de programação e skills em um app do Chatfuel wizard

O Chatfuel wizard termina entregando o novo app a um agente de programação. Ele instala uma skill para cada módulo que você escolheu, escreve o arquivo de instruções que o agente lê no início de cada sessão e oferece iniciar o agente no projeto com um checklist de configuração. O Claude Code e o Codex CLI são suportados. As skills trazem o que o agente precisa para alterar o app com segurança: as operações GraphQL do módulo, como essa parte da Public API se comporta e as regras que o proxy do app impõe.

Quais agentes de programação o wizard suporta

O wizard procura o Claude Code (claude) e o Codex CLI (codex) no seu PATH:

• Um agente encontrado: o wizard usa esse agente.
• Os dois encontrados: o wizard pergunta qual deles continua o trabalho. --agent claude ou --agent codex responde a essa pergunta com antecedência.
• Nenhum encontrado: o wizard oferece instalar um deles com npm i -g @anthropic-ai/claude-code ou npm i -g @openai/codex.

Só uma estrutura é escrita, para o agente que você escolheu:

• Claude Code: skills em .claude/skills/, instruções em CLAUDE.md.
• Codex CLI: skills em .agents/skills/, instruções em AGENTS.md, que indica o caminho completo de cada skill.

O que as skills contêm

Cada módulo instala uma skill chamada chatfuel-<id>, como chatfuel-contacts ou chatfuel-bookings. Uma skill reúne a estrutura desse módulo, as operações GraphQL que ele usa, referências sobre as partes da Public API por trás dele e playbooks para alterações comuns. Duas skills vêm com todo app, não importa o que você escolheu:

• chatfuel-core: autenticação, as regras do proxy, transporte HTTP e WebSocket, paginação, o schema GraphQL do Chatfuel e um validador para novas operações.
• chatfuel-update: como ler o que npx @chatfuel/wizard update informa e resolver os arquivos que você alterou e que a atualização também altera.

O wizard pergunta onde instalar as skills: no projeto ou no seu diretório pessoal, para que uma única cópia sirva a todos os apps que você criar. Módulos do wizard lista os módulos aos quais cada skill pertence.

O que dizem o arquivo de instruções e o checklist de configuração

O wizard escreve dois arquivos para o agente, com funções diferentes:

• O arquivo de instruções (CLAUDE.md ou AGENTS.md) é lido em toda sessão e continua curto: as rotas dos módulos do app, as skills que o agente deve ler antes de mexer na API, quais chaves do .env são segredos, com a regra "NEVER print or commit" (nunca exibir nem fazer commit), e como retomar a configuração.
• O checklist de configuração é lido uma vez, na entrega: o que dizer a você na primeira mensagem, um tour pelos módulos instalados com links para o app, as permissões do Chatfuel de que cada módulo precisa e as primeiras tarefas de cada módulo. Para o Claude Code, é o comando /chatfuel:finish-setup; para o Codex, é a skill chatfuel-finish-setup.

Quando você aceita a oferta de iniciar o agente no fim da execução, o wizard inicia o agente no novo projeto com o checklist. O próprio agente inicia o servidor de desenvolvimento e cumprimenta você com um resumo do que foi construído. Para retomar depois, execute claude /chatfuel:finish-setup no diretório do app ou peça ao Codex para usar a skill chatfuel-finish-setup.

Com --embed, o seu arquivo de instruções existente não é substituído. O wizard escreve a parte dele entre os marcadores <!-- chatfuel:begin --> e <!-- chatfuel:end -->, e uma nova execução reescreve só essa parte.

Prompts que funcionam com um app do wizard

Diga o módulo e o resultado que você quer; o agente encontra a skill correspondente. Estes prompts vêm das primeiras tarefas nas notas de entrega dos módulos:

• "Adicione uma busca à lista do chat ao vivo e faça a consulta da lista de conversas e a assinatura ao vivo dela usarem o mesmo filtro." Atendido por chatfuel-livechat.
• "Adicione uma legenda de cores de status à barra de ferramentas do calendário de agendamentos." Atendido por chatfuel-bookings.
• "Adicione um módulo chamado notes com uma tela de lista e uma tela de arquivados." Atendido por chatfuel-core, que descreve onde um módulo fica e o que ele pode importar.
• "Mude as cores de destaque do app e nada mais." Atendido por chatfuel-core: as cores ficam em um único arquivo de design tokens.
• "Adicione anexos de arquivo ao campo de mensagem do chat ao vivo." Atendido por chatfuel-livechat, com chatfuel-core para a rota de upload.

Como o agente adiciona uma nova operação da API

O proxy do app encaminha apenas os documentos GraphQL com os quais o app foi gerado e recusa qualquer outro, então uma operação nova ou alterada exige três etapas. Mencione-as no seu prompt e o agente faz as três:

1. Comece pelas operações do módulo na skill dele e escreva o novo documento.
2. Valide-o com o schema do Chatfuel usando o validador da chatfuel-core.
3. Adicione-o ao arquivo de operações do módulo no app e execute npm run codegen, que gera os tipos dele e o registra no proxy.

A introspecção em produção está desativada, então o schema dentro da chatfuel-core é aquele com que o agente trabalha. A visão geral da Public API e as páginas de referência desta seção descrevem as mesmas operações.

Como deixar o agente trabalhar também com os seus bots

As skills ensinam o código ao agente. Para que o mesmo agente leia e altere os seus bots do Chatfuel enquanto constrói o app, por exemplo para conferir um contato ou uma configuração, conecte o servidor MCP do Chatfuel: Claude Code ou Codex.