Dicas para bons pedidos

O agente escreve para quem não programa, e funciona melhor com pedidos que dizem o que você quer e onde, em palavras simples.

Faça

• Diga o lugar. “Na página de preços, abaixo dos três planos…” é melhor que “adicione um aviso em algum lugar”.
• Descreva o resultado, não o código. “Os visitantes devem conseguir mandar uma mensagem com nome e e-mail, e a gente recebe por e-mail”.
• Dê o texto exato quando as palavras importam: “Mude o título para: Pão fresquinho toda manhã”.
• Uma mudança por pedido, e depois ajuste. Pedidos pequenos são mais rápidos, mais baratos e mais fáceis de revisar.
• Diga o que manter. “Mantenha as cores atuais”, “Não mude o menu”.
• Use pedidos seguintes. O agente lembra a conversa até você aprovar ou descartar: “Agora deixe menor no celular”.
• Cite os segredos pelo nome, nunca pelo valor. “Use a variável RESEND_API_KEY para mandar o e-mail”, e depois adicione a variável em Variáveis de ambiente.

Evite

• Colar senhas, chaves de API ou tokens no chat. O chat fica guardado e é compartilhado com todos os membros.
• Pedidos enormes e vagos (“refaça o site inteiro”). Divida em etapas.
• Pedir ao agente para fazer deploy ou merge: aprovar já faz isso.
• Pedir para ele mudar workflows do GitHub: ele não consegue (veja o que ele pode fazer).

Exemplos

Adicione uma seção de perguntas frequentes no fim da página inicial com estas três perguntas e respostas: …

O formulário de contato mostra um erro no celular. Corrija e confira se funciona em uma tela pequena.

Adicione uma página /equipe com foto, nome e cargo de cada pessoa desta lista: …

Crie um formulário de lista de espera que salve nome e e-mail no banco de dados, e uma página /admin protegida pela variável ADMIN_PASSWORD para ver as inscrições.

Revise bem

• Abra a homologação também no Celular.
• Leia o resumo: ele lista o que conferir.
• Na dúvida, use Ver as mudanças no GitHub: mostra exatamente o que a aprovação publica.