Source: https://arara.code.app.br/artigos/prompts-para-programar-com-ia
Language: pt-BR
Published: 2026-10-31T20:25:00-03:00

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 e com fontes conferidas em 31 de outubro de 2026.

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](https://code.claude.com/docs/en/best-practices)

## 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](https://learn.chatgpt.com/guides/best-practices)

Relacionado

[Programar com IA do zero: guia para iniciantesProgramar com IA do zero: o que esperar segundo dados de 2025, um primeiro projeto, o básico de Git, uma rotina segura e os primeiros passos no Arara Code.](https://arara.code.app.br/artigos/programar-com-ia-do-zero)

## 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](https://agents.md/)

## 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](https://github.com/arara-ide/arara-code)

## Fontes e leitura complementar

- [Anthropic: boas práticas do Claude Code](https://code.claude.com/docs/en/best-practices)
- [OpenAI: boas práticas do Codex](https://learn.chatgpt.com/guides/best-practices)
- [AGENTS.md: formato aberto para agentes](https://agents.md/)
- [Claude Code: memória e arquivos CLAUDE.md](https://code.claude.com/docs/en/memory)
- [Arara Code: repositório público da IDE](https://github.com/arara-ide/arara-code)

[Ler em Markdown](https://arara.code.app.br/artigos/prompts-para-programar-com-ia.md)

## Continue explorando

### [Como migrar do VS Code ou do Cursor para o Arara Code](https://arara.code.app.br/artigos/migrar-do-vs-code-ou-cursor)

Como migrar do VS Code ou do Cursor para o Arara Code: o que a importação traz, como conferir extensões no Open VSX, seus CLIs de IA e um plano de uma tarde.

[Ler o guia](https://arara.code.app.br/artigos/migrar-do-vs-code-ou-cursor)

### [Arara Code vs Kiro: assistentes ou fluxo orientado a specs?](https://arara.code.app.br/artigos/arara-code-vs-kiro)

Compare specs, steering e hooks do Kiro com os assistentes integrados, editor Code-OSS e fluxo pelo WhatsApp do Arara Code. Com fontes oficiais.

[Ler o guia](https://arara.code.app.br/artigos/arara-code-vs-kiro)

## 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.

Baixar Arara Code
