---
title: "Problemas da programação com IA, por sintoma (o que está acontecendo → o que fazer)"
author: garplab
publisher: TypingTube
license: CC BY 4.0
license_url: https://creativecommons.org/licenses/by/4.0/
license_scope: Todo o corpo deste documento (exceto este frontmatter)
language: pt
canonical: https://typing-tube.net/articles/pt/lookup
---

# Problemas da programação com IA, por sintoma (o que está acontecendo → o que fazer)

Uma tabela para buscar por sintoma, não por título. O link "Detalhes" leva à seção do artigo que descreve a solução com as medições.

Esta tabela pressupõe o Claude Code (o agente de programação da Anthropic). hook, CLAUDE.md, subagent e auto memory são os nomes de seus recursos.

| O que está acontecendo | O que fazer | Recursos do Claude Code | Detalhes |
|---|---|---|---|
| Toda vez que a IA roda os testes, dezenas de milhares de linhas de saída inundam o contexto | Centralize a execução dos testes em um único script wrapper, grave toda a saída em um arquivo de log e devolva à IA apenas um resumo das falhas. | `context window` / `wrapper script` / `fixed-prefix count line ([observed])` | [読まない技術 第1回：テスト結果を読まない技術](https://typing-tube.net/articles/cd93e0c5cac832#cd93e0c5cac832-4eea2df8) |
| Quanto mais notas de conhecimento a IA salva, mais cada sessão futura precisa ler | Use um hook PreToolUse que roda logo antes de gravar na memória para fazer a IA ler uma checklist primeiro, e mantenha no arquivo de instruções (CLAUDE.md) apenas uma linha: "leia antes de escrever". | `MEMORY.md` / `loaded at session start` / `context rot` | [読まない技術 第2回：メモリを読まない技術](https://typing-tube.net/articles/384477896fec22#384477896fec22-4eea2df8) |
| Os testes passam, mas não fica claro se eles realmente protegem alguma coisa | Escreva uma política de uma página sobre mutation testing (técnica de quebrar o código de propósito para ver se os testes detectam) e faça a IA ler esse documento sempre que pedir uma revisão dos testes. | `mutation testing` / `positive control` / `vacuous truth` | [読まない技術 第3回：単体テストを読まない技術](https://typing-tube.net/articles/e4ad91d2fd6c67#e4ad91d2fd6c67-4eea2df8) |
| Às vezes a IA usa uma skill registrada, às vezes não | Mantenha o comando como um script comum, bloqueie invocações incorretas com um hook PreToolUse e aponte para a documentação que a IA deve ler. | `PreToolUse hook (Bash matcher)` / `hook stderr + exit 2` / `mission` | [読まない技術 第4回：スキルを使わない技術](https://typing-tube.net/articles/8f9ae8791b448d#8f9ae8791b448d-4eea2df8) |
| Depois que o trabalho é passado a um sub-agent, você não vê o que está acontecendo até ele terminar | Defina em YAML quais tarefas podem ser delegadas a um sub-agent e quais arquivos de entrada precisam existir antes de iniciá-lo, e verifique isso com um hook antes do início. | `subagent (Agent tool)` / `subagent (no parent context)` / `contract (inputs / outputs / acceptance)` | [読まない技術 第5回：サブエージェントの出力だけは読め](https://typing-tube.net/articles/62f714d7c2b599#62f714d7c2b599-7e6cc5ce) |
| Quanto mais regras você adiciona ao arquivo de instruções, menos as regras anteriores são seguidas | Reescreva cada regra do tipo "não faça X", uma de cada vez, como um teste automatizado (Minitest) capaz de detectar a violação. | `CLAUDE.md` / `Claude Code hooks (PreToolUse / PostToolUse / Stop / SubagentStop)` / `hook contract (proof of reading)` | [読まない技術 第6回：ルールを読まない技術](https://typing-tube.net/articles/569d598941c00f#569d598941c00f-4eea2df8) |
| A memória compartilhada entre sessões paralelas fica bagunçada, e fazer a IA ler a política não resolve | Mova o mesmo arquivo de política para um hook PostToolUse e mostre-o junto com o diff logo após salvar. Mantenha o conteúdo igual — mude apenas o momento. | `MEMORY.md` / `concurrent test runs` / `hooks / automated tests` | [読まない技術 第7回：共有メモリを整理しない技術](https://typing-tube.net/articles/83c46d1e6b2591#83c46d1e6b2591-4eea2df8) |
| Mesmo depois de anotar como lidar com uma falha, a IA comete o mesmo erro de novo na próxima vez | Resuma a política de nova tentativa em algumas linhas em um arquivo, e tenha um hook que detecta a falha e a insere automaticamente. | `auto memory (feedback_*)` | [読まない技術 第8回：修正履歴を読まない技術](https://typing-tube.net/articles/f7c9c30f567aee#f7c9c30f567aee-4eea2df8) |
| Mesmo lendo as notas de handoff e o relatório de conclusão, as partes inconvenientes estão faltando | Sempre coloque, ao lado do relatório de conclusão, números obtidos mecanicamente por algo como git diff --stat. | `handoff` / `test summary line (full log in a file)` | [読まない技術 第9回：引き継ぎを読まない技術](https://typing-tube.net/articles/a43b57a94d2216#a43b57a94d2216-4eea2df8) |
| Os números contados pela máquina viram números diferentes até chegarem ao relatório | Adicione um prefixo fixo à linha com o número, e tenha um hook que verifica se ele foi copiado ao pé da letra. | `machine-counted numbers ([observed] / git diff --stat)` / `test summary line (full log in a file)` / `self-report (bias toward completion)` | [読まない技術 第10回：AIに要約しろと言わない技術](https://typing-tube.net/articles/yomanai-10-no-summary#yomanai-10-no-summary-4eea2df8) |
| Interromper a IA no meio da tarefa desorganiza tudo o que ela faz depois | Em vez de uma pessoa interromper no meio da tarefa, deixe que intervenham um hook PostToolUse que devolve a política logo após salvar e um hook que detecta a falha e devolve o trabalho. A pessoa espera um ponto de corte. | `user message during a task` / `recency` / `context window` | [読まない技術 第11回：口を挟まない技術](https://typing-tube.net/articles/6c6d2e4f80a649#6c6d2e4f80a649-e4cb60ea) |
| No fim da sessão, não está decidido o que precisa ser lido e o que não precisa | Não leia o entregável nem o log de trabalho — julgue aprovação ou reprovação só pelo exit code dos testes ou do linter. | `self-report (bias toward completion)` / `machine-counted numbers ([observed] / git diff --stat)` / `exit code (pass / fail)` | [読まない技術 第12回：作業結果を読まない技術](https://typing-tube.net/articles/1769779c2f1b4b#1769779c2f1b4b-4eea2df8) |
| Uma proposta já rejeitada volta a aparecer na sessão seguinte | Consolide toda decisão rejeitada em um único documento, usando um formato fixo. |  | [AIの意見を聞かない技術 第1回：提案を検討しない技術](https://typing-tube.net/articles/kikanai-01-no-review#kikanai-01-no-review-9e2b31e8) |
| Mesmo com uma proibição de uma linha escrita, ela acaba sendo interpretada de forma mais ampla ou mais restrita do que deveria | No documento único que reúne as decisões rejeitadas (por exemplo non_goals.md), adicione uma seção "motivo" a cada proibição, ao lado da conclusão. |  | [AIの意見を聞かない技術 第2回：禁止を書かない技術](https://typing-tube.net/articles/kikanai-02-reason#kikanai-02-reason-2973ce11) |
| A proibição está escrita corretamente, mas não é seguida, e toda vez alguém vem perguntar a respeito | No documento de decisões rejeitadas, adicione uma seção "escopo" a cada proibição e liste, linha por linha, os casos-limite que geram dúvida. | `gap between goal pressure and spec` / `rule-to-test mapping` | [AIの意見を聞かない技術 第3回：禁止ルールを作らない技術](https://typing-tube.net/articles/kikanai-03-scope#kikanai-03-scope-1db3e01a) |
| Ao dar a mesma instrução a vários sub-agents, cada um retorna em um formato diferente | Na lista de tarefas que podem ser delegadas a um sub-agent, especifique explicitamente os arquivos de entrada que devem estar prontos antes do início. | `subagent mission catalog + launch hook` / `contract (inputs / outputs / acceptance)` / `required input files` | [AIの意見を聞かない技術 第4回：サブエージェントの入力だけは、確かめろ](https://typing-tube.net/articles/kikanai-04-subagent-input#kikanai-04-subagent-input-0b96e6a8) |
| Proibições sem teste automatizado se acumulam, permanecendo só texto no papel | No documento de decisões rejeitadas, adicione uma seção "verificação mecânica" à lista e indique, item por item, se existe um teste automatizado (Minitest) correspondente. | `probabilistic compliance (p^n)` | [AIの意見を聞かない技術 第5回：自動テストを書かない技術](https://typing-tube.net/articles/kikanai-05-machine-check#kikanai-05-machine-check-0f82d02b) |
| Todo trabalho da IA termina com "abra a tela e confira" | Prepare um único smoke test com Playwright, e julgue aprovação ou reprovação pelo registro deixado no banco de dados, não pela aparência da tela. | `automatic error report from users` | [AIの意見を聞かない技術 第6回：AIの確認依頼を断る技術](https://typing-tube.net/articles/kikanai-06-production#kikanai-06-production-6c41de4e) |
| Toda vez que a IA diz algo um pouco fora do ponto, é você quem explica e corrige | Em vez de uma pessoa explicar e corrigir cada desvio, escreva a correção no stderr do hook (exit 2) e nas mensagens de falha dos testes automatizados, para que esse seja o caminho pelo qual ela chega à IA. | `SendMessage (retry)` | [AIの意見を聞かない技術 第7回：AIの話を聞かない技術](https://typing-tube.net/articles/kikanai-07-no-listening#kikanai-07-no-listening-f900b392) |
| A lista de decisões rejeitadas não para de crescer e parece caminhar para o ponto em que ninguém mais a lê | Adicione uma seção "não adotado" ao final do documento de decisões rejeitadas, e registre ali as propostas rejeitadas. | `MEMORY.md` / `context rot` | [AIの意見を聞かない技術 第8回：ルールを整理しない技術](https://typing-tube.net/articles/kikanai-08-no-inventory#kikanai-08-no-inventory-d72023ae) |
| As linhas "sempre execute isto" do arquivo de instruções nunca parecem diminuir | Use um teste automatizado para verificar se todo comando que o arquivo de instruções marca como "sempre execute" também existe em um hook de pre-commit. | `CLAUDE.md` / `Minitest` / `hooks / automated tests` | [言わない技術 第1回：検証を指示しない技術](https://typing-tube.net/articles/iwanai-01-no-verification#iwanai-01-no-verification-f9f3539e) |
| Mesmo depois de escrever exatamente como fazer, a correção não volta daquele jeito | Em vez de ditar o procedimento, defina, por caso de uso, os arquivos de entrada que precisam existir antes de um sub-agent poder ser iniciado. | `per-mission guide document` / `presupposition` / `launch without a contract` | [言わない技術 第2回：具体的な指示を出さない技術](https://typing-tube.net/articles/iwanai-02-no-procedure#iwanai-02-no-procedure-e45dd403) |
| Relatar um bug significa escrever os passos e os sintomas você mesmo, toda vez | Configure um formulário de relato de bugs em que a pessoa digita apenas uma frase descrevendo o sintoma, e deixe o JavaScript coletar automaticamente a URL, o histórico de ações e as informações do navegador. | `bug report form (JS collects URL / actions / browser)` | [言わない技術 第3回：不具合詳細を書かない技術](https://typing-tube.net/articles/iwanai-03-no-bug-details#iwanai-03-no-bug-details-e45dd403) |
| Digitar "primeiro me dê um plano" toda vez já é, em si, uma tarefa repetitiva | Nenhuma implementação nova é necessária. Basta colocar um único documento de design em vigor, e a IA lerá os documentos existentes e seguirá o mesmo formato. |  | [言わない技術 第4回：計画を書けと言わない技術](https://typing-tube.net/articles/iwanai-04-no-plan-request#iwanai-04-no-plan-request-be44c158) |
| As linhas que você mais quer que sejam seguidas são escritas com mais ênfase, mas não dá para saber se isso ajuda | Pare de tentar medir o efeito — em vez disso, conte as linhas do arquivo de instruções que usam ênfase, e adicione um teste automatizado (um ratchet) que falha quando essa contagem ultrapassa um limite. | `emphasis count in CLAUDE.md` / `sycophancy` / `Dir.glob scan` | [言わない技術 第5回：念を押さない技術](https://typing-tube.net/articles/iwanai-05-no-emphasis#iwanai-05-no-emphasis-abb803f1) |
| O entregável de um sub-agent volta em um formato diferente do esperado | Para cada caso de uso de sub-agent, defina em um único documento os critérios de aceitação do entregável — nome do arquivo, formato, campos obrigatórios. | `subagent (Agent tool)` / `contract (inputs / outputs / acceptance)` / `self-report (bias toward completion)` | [言わない技術 第6回：サブエージェントの出力だけは、細かく指示しろ](https://typing-tube.net/articles/iwanai-06-subagent-output#iwanai-06-subagent-output-633e9bd9) |
| Encontrar um erro dá vontade de perguntar: "você realmente leu isso?" | Em vez de cobrar uma resposta, fixe a segunda frase de cada pedido no modelo de pergunta "não é verdade que ...?". | `sycophancy` | [言わない技術 第7回：AI を問い詰めない技術](https://typing-tube.net/articles/iwanai-07-no-interrogation#iwanai-07-no-interrogation-293fc181) |
| Responder "não é isso" para a resposta recebida não a torna melhor | Em vez de apontar você mesmo, apresente proibições sem alternativa por meio de um hook PostToolUse, mostrado junto com o diff logo após salvar. | `SendMessage (retry)` / `guarded_by + marker` / `over-triggering` | [言わない技術 第8回：AI にダメ出ししない技術](https://typing-tube.net/articles/iwanai-08-no-criticism#iwanai-08-no-criticism-e4cb60ea) |
| A IA fala sobre o conteúdo de um arquivo como se o tivesse aberto, quando não abriu | Faça a IA escrever markers correspondentes tanto no documento referenciado quanto no código, e verifique com um teste automatizado que esses markers realmente existem. | `hallucination` / `escape hatch (SKIP_*= / --no-verify)` / `marker` | [言わない技術 第9回：AI に考えさせない技術](https://typing-tube.net/articles/iwanai-09-no-guessing#iwanai-09-no-guessing-61ef1df2) |
| A IA fica perguntando "A ou B?" e o trabalho trava enquanto você decide | Pare de responder na hora — organize as coisas para que a escolha seja decidida por um teste automatizado ou um hook. |  | [言わない技術 第10回：質問に答えない技術](https://typing-tube.net/articles/iwanai-10-no-answering#iwanai-10-no-answering-0efdc39b) |
| A IA está fazendo a revisão, mas não fica claro o que ela não está olhando | Use um teste automatizado externo que conta coisas para detectar qualquer teste automatizado que varre arquivos mas não tem uma asserção de limite mínimo na contagem (por exemplo, assert_operator ... :>=). | `Minitest` / `vacuous truth` / `Dir.glob scan` | [言わない技術 第11回：AI にレビューをさせない技術](https://typing-tube.net/articles/iwanai-11-no-review#iwanai-11-no-review-659e23ad) |
| As capturas de tela vão se acumulando, mas não fica claro qual delas verificou o quê | Antes de conferir a tela, exija respostas para duas perguntas — "o que está sendo verificado" e "por que um método mais barato não resolve" — e mantenha uma diretriz de uma página para tentar primeiro a opção mais barata, na ordem teste unitário, teste de integração e depois E2E. | `Playwright screenshot` / `verification ladder (unit → integration → E2E)` / `verification declaration file + PreToolUse hook` | [確かめない技術 第1回：スクリーンショットを撮らない技術](https://typing-tube.net/articles/tashikamenai-01-no-screenshots#tashikamenai-01-no-screenshots-d3d345e4) |
| Existe uma etapa que exige escrever algo, mas não é possível contar quantas execuções pularam essa etapa | Antes de uma captura de tela ou de um E2E, faça escrever um arquivo de declaração que diga o que será verificado (por exemplo tmp/visual_verification.md), torne sua existência uma pré-condição de um hook PreToolUse, e sem ele a captura ou o E2E não começa. | `verification declaration file + PreToolUse hook` / `Claude Code hooks (PreToolUse / PostToolUse / Stop / SubagentStop)` / `PreToolUse hook (Bash matcher)` | [確かめない技術 第2回：宣言を信じない技術](https://typing-tube.net/articles/tashikamenai-02-declaration-guard#tashikamenai-02-declaration-guard-4eea2df8) |
| O mesmo teste roda de novo mesmo sem o código ter mudado, e você espera por isso mesmo assim | Adicione uma opção --last ao script wrapper de testes, que reproduz o log anterior, tornando a nova execução desnecessária. | `--last (replay the previous result)` / `mtime check` / `expensive entry point (screenshot / E2E / production)` | [確かめない技術 第3回：テストを再実行しない技術](https://typing-tube.net/articles/tashikamenai-03-no-rerun#tashikamenai-03-no-rerun-ffaed55c) |
| Nada foi quebrado, mas uma fileira de erros desconhecidos aparece | Faça o script wrapper de testes adquirir um lock exclusivo (usando a atomicidade do mkdir), e recuse-se a rodar se não conseguir obtê-lo. | `flaky failure` / `mkdir lock` / `concurrent test runs` | [確かめない技術 第4回：偽の失敗を読まない技術](https://typing-tube.net/articles/tashikamenai-04-false-failures#tashikamenai-04-false-failures-a29d752a) |
| O relatório "os testes passaram" não menciona as partes que nunca rodaram | Marque os testes E2E pesados com uma tag pelo nome da área e faça skip deles por padrão, imprimindo sempre a lista das áreas que não rodaram. | `E2E area (E2E=<area>)` / `skipped-area count line` / `pass / fail by DB record` | [確かめない技術 第5回：全部走らせない技術](https://typing-tube.net/articles/tashikamenai-05-selective-e2e#tashikamenai-05-selective-e2e-bb037847) |
| Não há como saber depois se uma instrução que especificava como proceder foi realmente seguida | Quando quiser que um procedimento seja seguido, não reforce as palavras da instrução — em vez disso, mude o processo para que segui-lo deixe um rastro no entregável (por exemplo, fazendo com que ele imprima uma linha para cada arquivo aberto). | `sycophancy` / `file existence check` / `tool_use count` | [動かさない技術 第1回：手順を守らせない技術](https://typing-tube.net/articles/ugokasanai-01-no-procedure-enforcement#ugokasanai-01-no-procedure-enforcement-129e096a) |
| Um wrapper que você colocou em prática é abandonado no meio do caminho, voltando ao comando puro | Quando quiser que o wrapper seja usado, não reforce a instrução — em vez disso, verifique se ainda existe um motivo para recorrer ao comando puro, ou seja, se falta alguma capacidade ao wrapper. | `wrapper script` / `the raw command the model defaults to` / `workaround after exit 2` | [動かさない技術 第2回：ラッパーを使わせない技術](https://typing-tube.net/articles/ugokasanai-02-no-wrapper-enforcement#ugokasanai-02-no-wrapper-enforcement-129e096a) |
| Fazer a mesma pergunta repetidas vezes traz uma resposta diferente a cada vez, e resumir tudo faz algo se perder | Antes de combinar várias respostas em uma só, imprima a frequência de cada tipo de observação — quantas, de quantas, a levantaram. | `one subagent run` / `answer key` | [動かさない技術 第3回：集めない技術](https://typing-tube.net/articles/ugokasanai-03-no-aggregation#ugokasanai-03-no-aggregation-f7af24f4) |
| Não há como saber se uma linha do tipo "faça X se necessário" chegou a disparar | Não escreva instruções condicionais como "faça X se necessário" — em vez disso, force a etapa com um hook que bloqueia o avanço até que ela seja concluída. | `rule-to-test mapping` / `Claude Code hooks (PreToolUse / PostToolUse / Stop / SubagentStop)` / `file existence check` | [動かさない技術 第4回：役に立たない技術](https://typing-tube.net/articles/ugokasanai-04-no-conditional-instruction#ugokasanai-04-no-conditional-instruction-e45dd403) |
| Dizer "pense de novo" muda a resposta, mas não fica claro se a IA realmente se convenceu | Em vez de devolver com "pense de novo", aponte especificamente qual premissa está errada. | `sycophancy` / `SendMessage (retry)` / `guarded_by + marker` | [動かさない技術 第5回：選び直させない技術](https://typing-tube.net/articles/ugokasanai-05-no-reselection#ugokasanai-05-no-reselection-88f30148) |
| Escrever "não adivinhe" fez a IA passar a voltar sem construir nada | Não entregue apenas uma proibição — combine-a com uma saída alternativa, como "se nada se aplicar, gere 'não aplicável'". | `escape hatch (SKIP_*= / --no-verify)` / `hooks + automated tests + ratchet` / `hallucination` | [動かさない技術 第6回：逃げ道を塞がない技術](https://typing-tube.net/articles/ugokasanai-06-no-blocking-exits#ugokasanai-06-no-blocking-exits-420ce5bc) |
| Quanto mais tempo uma conversa que está indo bem continua, mais trabalho dá para verificá-la | Encerre a sessão em cada limite de tarefa, e comece a próxima tarefa em uma nova sessão. | `context window` / `input / output / cache read tokens` / `sycophancy` | [動かさない技術 第7回：セッションを続けない技術](https://typing-tube.net/articles/ugokasanai-07-no-long-sessions#ugokasanai-07-no-long-sessions-a59368ec) |
| Todos os entregáveis estão corretos, mas o desperdício que não aparece neles continua se acumulando | Quando os entregáveis estiverem prontos, rode um script para tabular o próprio log de trabalho (transcript), uma única vez. | `file existence check` / `machine-counted numbers ([observed] / git diff --stat)` / `Dir.glob scan` | [動かさない技術 第8回：成果物で判断しない技術](https://typing-tube.net/articles/ugokasanai-08-no-artifact-judgment#ugokasanai-08-no-artifact-judgment-588e1e37) |
| As notas deixadas para a próxima pessoa saem de sincronia com a realidade e ficam desatualizadas | Não deixe o conhecimento em um documento — incorpore-o na mensagem de falha de um teste automatizado ou na mensagem de interrupção de um hook, para que apareça exatamente no momento em que é preciso. | `handoff` / `MEMORY.md` / `mtime check` | [動かさない技術 第9回：知見を残さない技術](https://typing-tube.net/articles/ugokasanai-09-no-knowledge-notes#ugokasanai-09-no-knowledge-notes-cb7946f3) |
| A investigação da causa continua, e a leitura segue mesmo depois de a resposta já ter aparecido | Conte, a partir do log de trabalho, sequências de leituras que não mudaram nada, e escreva em uma linha uma condição de parada antes de começar a investigar. | `machine-counted numbers ([observed] / git diff --stat)` / `input / output / cache read tokens` / `Dir.glob scan` | [追わない技術 第1回：深追いしない技術](https://typing-tube.net/articles/owanai-01-no-deep-dive#owanai-01-no-deep-dive-36119a54) |
| O modelo de menor preço é definido como padrão sem medir se ele realmente serve para o caso de uso | Dê a mesma tarefa ao modelo barato e ao modelo caro, e decida só depois de contar separadamente os turnos até a conclusão e as quantidades lidas de novo, reaproveitadas (cache read) e escritas. | `rule-to-test mapping` / `Minitest` / `machine-counted numbers ([observed] / git diff --stat)` | [追わない技術 第2回：一番安いモデルを使わない技術](https://typing-tube.net/articles/owanai-02-no-cheapest-model#owanai-02-no-cheapest-model-15eb5702) |
| Quando algo não funciona, a solução buscada é um modelo maior, não um mecanismo melhor | Dê a mesma tarefa ao modelo mais caro e ao mais barato, e transforme em uma verificação permanente os pontos em que só o mais barato falha. | `rule-to-test mapping` / `Minitest` / `machine-counted numbers ([observed] / git diff --stat)` | [追わない技術 第3回：最新モデルを使わない技術](https://typing-tube.net/articles/owanai-03-no-latest-model#owanai-03-no-latest-model-eec0ed05) |
| Uma pesquisa que a sessão principal conseguiria terminar sozinha é passada a um sub-agent só por precaução | Antes de delegar, verifique se o agente pai já tem esse contexto. Se tiver, continue nele; entregue a um sub-agent apenas o grande volume de leitura que ele ainda não tem. | `subagent (Agent tool)` / `context window` / `input / output / cache read tokens` | [追わない技術 第4回：サブエージェントを使わない技術](https://typing-tube.net/articles/owanai-04-no-subagent#owanai-04-no-subagent-efc681e6) |
| A opção padrão é dividir o trabalho em quatro e rodar tudo ao mesmo tempo, só porque sim | Dê a cada sub-agent apenas o que ele consegue devolver em uma única resposta. O que define o custo não é a quantidade de sub-agents, mas quantas idas e voltas cada sub-agent resultante da divisão faz com o agente pai. | `subagent (Agent tool)` / `input / output / cache read tokens` / `machine-counted numbers ([observed] / git diff --stat)` | [追わない技術 第5回：エージェントチームを使わない技術](https://typing-tube.net/articles/owanai-05-no-agent-team#owanai-05-no-agent-team-037074af) |
| "Olha isso também" é injetado de fora no meio do trabalho | Espere um ponto de corte natural do trabalho e então incorpore o pedido extra com escopo reduzido. Ao perguntar à própria IA sobre lacunas, sempre acrescente: "se estiver suficiente, diga isso explicitamente". Assim ela tem uma saída (escape hatch) e não precisa inventar uma lacuna. | `subagent (Agent tool)` / `instruction priority (position / recency / system vs user)` / `over-triggering` | [追わない技術 第6回：途中でレビューさせない技術](https://typing-tube.net/articles/owanai-06-no-midway-review#owanai-06-no-midway-review-542ab968) |
| A escolha de qual modelo usar está sendo feita comparando-os lado a lado | Antes de começar a comparar modelos, conte a quantos hooks ou testes automatizados equivale o esforço dessa comparação. Se for possível escrever mais mecanismos do que esse número, coloque-os em prática antes de comparar. | `input / output / cache read tokens` / `rule-to-test mapping` | [追わない技術 第7回：モデルを選ばない技術](https://typing-tube.net/articles/owanai-07-no-model-choice#owanai-07-no-model-choice-41136ab2) |
| "Não houve diferença" está sendo usado como motivo para encerrar a verificação | Antes de encerrar com "não houve diferença", conte duas coisas: se algum resultado foi excluído da contagem (por exemplo sub-agents que falharam), coloque-o de volta e recalcule; se mais da metade dos itens tiver zero em todas as condições, reformule a tarefa e meça de novo. | `machine-counted numbers ([observed] / git diff --stat)` / `vacuous truth` | [追わない技術 第8回：諦めさせない技術](https://typing-tube.net/articles/owanai-08-no-giving-up#owanai-08-no-giving-up-82156f07) |

---

Fonte: "Problemas da programação com IA, por sintoma (o que está acontecendo → o que fazer)" por garplab (TypingTube) https://typing-tube.net/articles/pt/lookup / CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)
Esta tabela pode ser copiada, republicada, traduzida e usada comercialmente desde que a fonte seja citada. A versão mais recente e o texto completo de cada artigo estão na URL acima.