[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"atpares-post-prompt-para-programar":3},{"slug":4,"title":5,"seoTitle":6,"description":7,"keyword":8,"category":9,"categories":10,"cta":11,"tags":12,"author":6,"coverId":13,"cover":14,"coverAlt":5,"readingMinutes":15,"publishedAt":16,"updatedAt":17,"body":18,"html":19,"headings":20,"related":43},"prompt-para-programar","Prompt para programar: como pedir código que você consegue revisar","","Stack, contrato de entrada e saída, caso de borda e teste. O que colocar no prompt para não receber cem linhas que você não sabe conferir.","prompt para programar","trabalho",[9],"codigo",[],"2a050c18-3b2b-43dd-a1aa-57ce4830d211","https:\u002F\u002Fapi.atpares.com\u002Fapi\u002Fprojects\u002Fprompteira\u002Fblog\u002Fmedia\u002F2a050c18-3b2b-43dd-a1aa-57ce4830d211",3,"2026-05-19","2026-09-17T14:26:28.118Z","Pedir código para IA é fácil. O difícil é receber código que você consegue conferir. Cem linhas que rodam e que você não entende são um problema que vai aparecer daqui a três semanas, quando quebrar.\n\nO que faz diferença no prompt é dizer onde esse código vai morar e o que ele precisa aguentar.\n\n# O contexto que falta em quase todo pedido\n\n```\nStack: {{linguagem e versão}}, {{framework e versão}}\nOnde vai morar: {{arquivo ou camada, e o que já existe perto}}\nPadrão do projeto: {{ex: sem classe, função pura, erro por exceção}}\nEntrada: {{formato exato, com um exemplo real}}\nSaída: {{formato exato, com um exemplo real}}\nO que já tentei: {{o que não funcionou e o erro que deu}}\n```\n\nO campo de entrada e saída com exemplo real vale mais que qualquer descrição. Ele elimina a rodada em que você descobre que a função devolve um formato que não serve.\n\n# Peça o contrato antes do código\n\nEm qualquer coisa que passe de vinte linhas, duas rodadas ganham de uma.\n\n```\nAntes de escrever código: descreva a assinatura da função, o que entra, o que sai, e os casos de borda que ela precisa tratar. Liste as decisões que você teria que tomar e onde tem mais de um caminho possível.\n\nNão escreva a implementação ainda.\n```\n\nVocê lê dez linhas, corrige o que estiver errado e só então pede o código. Corrigir o contrato custa uma frase, corrigir a implementação custa a implementação inteira.\n\n# Casos de borda, escritos por você\n\nA IA cobre os casos de borda que costumam aparecer. Ela não cobre os do seu domínio, porque não os conhece.\n\n```\nTrate estes casos:\n- lista vazia\n- valor nulo em {{campo}}\n- data no futuro\n- duas linhas com o mesmo {{identificador}}\n- número negativo em {{campo}}\n\nPara cada um, diga o que a função faz: retorna vazio, lança erro ou ignora a linha.\n```\n\nEscolher entre retornar vazio e lançar erro é decisão de projeto, não de quem escreve a função. Se você não decidir, a IA decide por você.\n\n# Peça o teste junto, e leia o teste primeiro\n\n```\nEscreva a função e os testes.\nOs testes devem cobrir: o caminho feliz, cada caso de borda listado acima e um caso que deve falhar.\nNomeie cada teste com a frase do que ele garante.\n```\n\nLer o teste antes do código é o atalho: se o nome do teste descreve o comportamento que você quer, o código provavelmente está certo. Se o teste testa o que o código faz, e não o que deveria fazer, você acabou de encontrar o problema.\n\n# Revisão de código que você não escreveu\n\n```\nRevise o código abaixo. Responda em três blocos:\n\n1. O que ele faz, em 3 linhas, sem repetir o código.\n2. Onde ele quebra: entrada que causa erro, condição não tratada, suposição escondida.\n3. O que eu preciso saber antes de colocar isso em produção.\n\nNão reescreva o código. Não sugira melhoria de estilo.\n\n---\n{{codigo}}\n```\n\nO bloco 1 é o mais importante e o que ninguém pede. Se a explicação do que o código faz não bater com o que você queria, o resto não interessa.\n\n# Depurar\n\n```\nErro: {{mensagem completa, com a pilha}}\nO que eu esperava: {{comportamento}}\nO que aconteceu: {{comportamento}}\nO que muda entre funcionar e não funcionar: {{entrada, ambiente, versão}}\n\nListe 3 causas possíveis, da mais provável para a menos, e diga como eu testo cada uma em menos de um minuto.\n\nNão me dê o código corrigido ainda.\n```\n\nPedir hipóteses testáveis em vez de correção direta evita o ciclo em que você aplica um conserto, o erro muda de lugar e você perde a linha do que estava investigando.\n\n# A regra que vale para tudo\n\nNão aceite código que você não conseguiria explicar para outra pessoa. Se não conseguir, peça assim:\n\n```\nExplique a linha {{n}}. Por que ela precisa existir e o que quebra se eu tirar.\n```","\u003Cp>Pedir código para IA é fácil. O difícil é receber código que você consegue conferir. Cem linhas que rodam e que você não entende são um problema que vai aparecer daqui a três semanas, quando quebrar.\u003C\u002Fp>\u003Cp>O que faz diferença no prompt é dizer onde esse código vai morar e o que ele precisa aguentar.\u003C\u002Fp>\u003Ch2 id=\"o-contexto-que-falta-em-quase-todo-pedido\">O contexto que falta em quase todo pedido\u003C\u002Fh2>\u003Cpre>\u003Ccode>Stack: {{linguagem e versão}}, {{framework e versão}}\nOnde vai morar: {{arquivo ou camada, e o que já existe perto}}\nPadrão do projeto: {{ex: sem classe, função pura, erro por exceção}}\nEntrada: {{formato exato, com um exemplo real}}\nSaída: {{formato exato, com um exemplo real}}\nO que já tentei: {{o que não funcionou e o erro que deu}}\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>O campo de entrada e saída com exemplo real vale mais que qualquer descrição. Ele elimina a rodada em que você descobre que a função devolve um formato que não serve.\u003C\u002Fp>\u003Ch2 id=\"peca-o-contrato-antes-do-codigo\">Peça o contrato antes do código\u003C\u002Fh2>\u003Cp>Em qualquer coisa que passe de vinte linhas, duas rodadas ganham de uma.\u003C\u002Fp>\u003Cpre>\u003Ccode>Antes de escrever código: descreva a assinatura da função, o que entra, o que sai, e os casos de borda que ela precisa tratar. Liste as decisões que você teria que tomar e onde tem mais de um caminho possível.\n\nNão escreva a implementação ainda.\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Você lê dez linhas, corrige o que estiver errado e só então pede o código. Corrigir o contrato custa uma frase, corrigir a implementação custa a implementação inteira.\u003C\u002Fp>\u003Ch2 id=\"casos-de-borda-escritos-por-voce\">Casos de borda, escritos por você\u003C\u002Fh2>\u003Cp>A IA cobre os casos de borda que costumam aparecer. Ela não cobre os do seu domínio, porque não os conhece.\u003C\u002Fp>\u003Cpre>\u003Ccode>Trate estes casos:\n- lista vazia\n- valor nulo em {{campo}}\n- data no futuro\n- duas linhas com o mesmo {{identificador}}\n- número negativo em {{campo}}\n\nPara cada um, diga o que a função faz: retorna vazio, lança erro ou ignora a linha.\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Escolher entre retornar vazio e lançar erro é decisão de projeto, não de quem escreve a função. Se você não decidir, a IA decide por você.\u003C\u002Fp>\u003Ch2 id=\"peca-o-teste-junto-e-leia-o-teste-primeiro\">Peça o teste junto, e leia o teste primeiro\u003C\u002Fh2>\u003Cpre>\u003Ccode>Escreva a função e os testes.\nOs testes devem cobrir: o caminho feliz, cada caso de borda listado acima e um caso que deve falhar.\nNomeie cada teste com a frase do que ele garante.\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Ler o teste antes do código é o atalho: se o nome do teste descreve o comportamento que você quer, o código provavelmente está certo. Se o teste testa o que o código faz, e não o que deveria fazer, você acabou de encontrar o problema.\u003C\u002Fp>\u003Ch2 id=\"revisao-de-codigo-que-voce-nao-escreveu\">Revisão de código que você não escreveu\u003C\u002Fh2>\u003Cpre>\u003Ccode>Revise o código abaixo. Responda em três blocos:\n\n1. O que ele faz, em 3 linhas, sem repetir o código.\n2. Onde ele quebra: entrada que causa erro, condição não tratada, suposição escondida.\n3. O que eu preciso saber antes de colocar isso em produção.\n\nNão reescreva o código. Não sugira melhoria de estilo.\n\n---\n{{codigo}}\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>O bloco 1 é o mais importante e o que ninguém pede. Se a explicação do que o código faz não bater com o que você queria, o resto não interessa.\u003C\u002Fp>\u003Ch2 id=\"depurar\">Depurar\u003C\u002Fh2>\u003Cpre>\u003Ccode>Erro: {{mensagem completa, com a pilha}}\nO que eu esperava: {{comportamento}}\nO que aconteceu: {{comportamento}}\nO que muda entre funcionar e não funcionar: {{entrada, ambiente, versão}}\n\nListe 3 causas possíveis, da mais provável para a menos, e diga como eu testo cada uma em menos de um minuto.\n\nNão me dê o código corrigido ainda.\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>Pedir hipóteses testáveis em vez de correção direta evita o ciclo em que você aplica um conserto, o erro muda de lugar e você perde a linha do que estava investigando.\u003C\u002Fp>\u003Ch2 id=\"a-regra-que-vale-para-tudo\">A regra que vale para tudo\u003C\u002Fh2>\u003Cp>Não aceite código que você não conseguiria explicar para outra pessoa. Se não conseguir, peça assim:\u003C\u002Fp>\u003Cpre>\u003Ccode>Explique a linha {{n}}. Por que ela precisa existir e o que quebra se eu tirar.\u003C\u002Fcode>\u003C\u002Fpre>",[21,25,28,31,34,37,40],{"level":22,"text":23,"anchor":24},2,"O contexto que falta em quase todo pedido","o-contexto-que-falta-em-quase-todo-pedido",{"level":22,"text":26,"anchor":27},"Peça o contrato antes do código","peca-o-contrato-antes-do-codigo",{"level":22,"text":29,"anchor":30},"Casos de borda, escritos por você","casos-de-borda-escritos-por-voce",{"level":22,"text":32,"anchor":33},"Peça o teste junto, e leia o teste primeiro","peca-o-teste-junto-e-leia-o-teste-primeiro",{"level":22,"text":35,"anchor":36},"Revisão de código que você não escreveu","revisao-de-codigo-que-voce-nao-escreveu",{"level":22,"text":38,"anchor":39},"Depurar","depurar",{"level":22,"text":41,"anchor":42},"A regra que vale para tudo","a-regra-que-vale-para-tudo",[44,57,69,81],{"slug":45,"title":46,"seoTitle":6,"description":47,"keyword":48,"category":49,"categories":50,"cta":51,"tags":52,"author":6,"coverId":53,"cover":54,"coverAlt":46,"readingMinutes":15,"publishedAt":55,"updatedAt":56},"exemplos-dentro-do-prompt","Exemplos dentro do prompt: por que mostrar funciona melhor que explicar","Um exemplo de entrada e saída corrige mais coisa que três parágrafos de instrução. Quantos usar, como escolher e o vício que eles criam.","few shot prompt","fundamentos",[49],"escrita",[],"26f6cdee-67e4-461c-bbc4-c0e727a97f4d","https:\u002F\u002Fapi.atpares.com\u002Fapi\u002Fprojects\u002Fprompteira\u002Fblog\u002Fmedia\u002F26f6cdee-67e4-461c-bbc4-c0e727a97f4d","2026-08-11","2026-09-17T14:26:27.625Z",{"slug":58,"title":59,"seoTitle":6,"description":60,"keyword":61,"category":9,"categories":62,"cta":63,"tags":64,"author":6,"coverId":65,"cover":66,"coverAlt":59,"readingMinutes":15,"publishedAt":67,"updatedAt":68},"prompt-para-planilha","Prompt para planilha: fórmula, tabela dinâmica e limpeza de dados","Como descrever colunas e linhas para receber a fórmula certa de primeira, e o pedido que evita fórmula que só funciona no exemplo.","prompt para planilha excel",[9],"dados",[],"22f19599-8a33-430b-bffc-172ecc4ad713","https:\u002F\u002Fapi.atpares.com\u002Fapi\u002Fprojects\u002Fprompteira\u002Fblog\u002Fmedia\u002F22f19599-8a33-430b-bffc-172ecc4ad713","2026-05-26","2026-09-17T14:26:28.020Z",{"slug":70,"title":71,"seoTitle":6,"description":72,"keyword":73,"category":9,"categories":74,"cta":75,"tags":76,"author":6,"coverId":77,"cover":78,"coverAlt":71,"readingMinutes":15,"publishedAt":79,"updatedAt":80},"prompt-para-estudar","Prompt para estudar: resumo, plano de revisão e simulado","Três prompts que trabalham juntos, do resumo do material ao simulado que corrige e explica o erro, sem deixar a IA inventar conteúdo.","prompt para estudar",[9],"educacao",[],"fd8fcb69-7214-4c92-89f5-875fec2ff1d8","https:\u002F\u002Fapi.atpares.com\u002Fapi\u002Fprojects\u002Fprompteira\u002Fblog\u002Fmedia\u002Ffd8fcb69-7214-4c92-89f5-875fec2ff1d8","2026-05-12","2026-09-17T14:26:27.937Z",{"slug":82,"title":83,"seoTitle":6,"description":84,"keyword":85,"category":6,"categories":86,"cta":87,"tags":88,"author":6,"coverId":89,"cover":90,"coverAlt":83,"readingMinutes":91,"publishedAt":92,"updatedAt":93},"gratuito-ou-premium-o-que-o-prompt-precisa-demonstrar-antes-de-voce-definir-o-pr","Gratuito ou premium: o que o prompt precisa demonstrar antes de você definir o preço","Você fechou o template, marcou em chaves duplas tudo que a outra pessoa vai preencher, anotou os modelos em que rodou o comando de verdade e colou uma execução sem edição.","gratuito ou premium",[],"Antes de marcar o quarto passo, faça a conferência no seu prompt nesta ordem. Leia o resultado bruto que você colou e veja se ele entrega sozinho o que o título promete, confira se os modelos declarados cobrem o cenário de quem vai usar, conte se cada parte que muda a cada uso está entre chaves duplas. Só então escolha entre gratuito e premium, sabendo que o preço é a parte que você vai rever depois. Os quatro passos estão em https:\u002F\u002Fprompteira.com\u002Fenviar",[],"e00f9709-5fcd-4fdb-885e-d701a1d8cda3","https:\u002F\u002Fapi.atpares.com\u002Fapi\u002Fprojects\u002Fprompteira\u002Fblog\u002Fmedia\u002Fe00f9709-5fcd-4fdb-885e-d701a1d8cda3",5,"2026-09-27","2026-09-27T21:30:52.907Z"]