Ir para o conteúdo
Arara Code

Guias e comparativos

Prompts para programar com IA: regras e exemplos

Um bom prompt para programar com IA diz o objetivo, aponta os arquivos e explica como conferir o resultado, por exemplo com um teste que deve passar. Em tarefas grandes ou vagas, peça primeiro que a IA explore o código, faça perguntas e proponha um plano antes de editar. Regras que valem para todo pedido, como comandos de build e teste, vão no AGENTS.md ou no CLAUDE.md.

Arara Code

Publicado pelo projeto Arara Code com base na documentação oficial citada.

Seja específico: objetivo, arquivos e como conferir

O guia de boas práticas do Claude Code, da Anthropic, recomenda prompts específicos: diga o arquivo, descreva o sintoma e explique, logo no início, como fica o resultado corrigido. Isso costuma poupar uma rodada de correções. O guia dá um exemplo. Em vez de “corrija o bug de login”, escreva “usuários relatam que o login falha depois que a sessão expira; veja a renovação do token em src/auth/, escreva um teste que falhe reproduzindo o problema e depois corrija”.

Diga também como conferir o resultado. Segundo o mesmo guia, o Claude encerra quando o trabalho parece pronto, e sem uma verificação para rodar, parecer pronto é tudo o que ele tem. Dê algo que responda passou ou falhou, como um arquivo de teste, o código de saída do build ou um linter. Depois, peça evidência: o comando executado e a saída dele. Uma frase como “todos os testes passam”, sozinha, diz pouco.

Anthropic: boas práticas do Claude Code

Explore, planeje e só depois programe

O guia de boas práticas do Codex, da OpenAI, sugere quatro itens em cada prompt: objetivo, contexto (arquivos, documentos, exemplos ou erros), restrições e o critério de pronto. Quando a tarefa é complexa, ambígua ou difícil de descrever, o guia recomenda pedir um plano antes do código. No Codex, o modo Plan, ativado com “/plan” ou Shift+Tab, deixa o agente reunir contexto, fazer perguntas de esclarecimento e montar o plano antes de implementar.

Quando nem você sabe direito o que quer, peça que a IA entreviste você antes de editar. Os dois guias sugerem isso, e o da OpenAI acrescenta que ela deve questionar suas suposições. O da Anthropic mostra um pedido para limitar requisições numa API pública que termina com “me entreviste até conseguir escrever a especificação e depois grave em SPEC.md”. Em seguida, o guia recomenda uma sessão nova para implementar a partir desse arquivo, com o contexto limpo.

OpenAI: boas práticas do Codex

AGENTS.md e CLAUDE.md: instruções que o agente lê sozinho

Regras que valem para todo pedido não precisam ser repetidas no prompt. O AGENTS.md é um formato aberto, descrito como um README para agentes e usado por mais de 60 mil projetos de código aberto, segundo o site oficial. Crie o arquivo na raiz do repositório com o que um agente precisa saber: visão geral do projeto, comandos de build e teste, estilo de código, instruções de teste e cuidados de segurança. Em monorepos, vale o arquivo mais próximo.

O Claude Code lê o CLAUDE.md no início de cada sessão e, segundo a documentação, também pode ler o AGENTS.md do repositório quando não há CLAUDE.md. Coloque ali os comandos de build e teste e as convenções do projeto. Escreva regras que possam ser verificadas: “rode npm test antes do commit” em vez de “teste suas mudanças”. A documentação recomenda menos de 200 linhas por arquivo e, no Claude Code e no Codex CLI, “/init” gera uma primeira versão.

AGENTS.md: formato aberto para agentes

Como aplicar essas regras de prompt no Arara Code

No chat lateral do Arara Code, entregue o contexto em vez de descrevê-lo. Selecione o código e use Ctrl+L, ou clique com o botão direito num arquivo do explorador e escolha “Adicionar ao chat”. O menu “@” adiciona imagens, como a captura de um erro, e o “Mapa do código” do projeto. Se a IA fizer perguntas, como você pediu no plano, responda no próprio chat. Durante a execução, acompanhe a lista de tarefas e aprove ou recuse cada edição e comando.

Para tarefas simples, como renomear algo em poucos arquivos, escolha um esforço menor no seletor plataforma · modelo · esforço; o guia da Anthropic diz que esforço maior gasta mais tempo e tokens. Antes de enviar, confira se o pedido diz o objetivo, aponta os arquivos e explica como conferir o resultado, se tarefas grandes começam com plano e perguntas e se as regras fixas estão no AGENTS.md ou no CLAUDE.md. Depois, rode os testes e revise o diff antes do commit.

Arara Code: repositório público da IDE

Fontes e leitura complementar

Ler em Markdown

Continue explorando

Dê espaço à sua próxima ideia.

Conheça o Arara Code no seu próprio projeto. Comece pelo instalador e revise as mudanças que seu assistente fizer.