Catálogo

Guias de IA

Um catálogo de ferramentas e técnicas de IA, cada uma com o que é, quando usar e — principalmente — quando não usar.

Toda semana aparece uma ferramenta nova de IA e uma técnica nova para usá-la. A parte difícil nunca é descobrir que elas existem: é saber qual resolve o seu problema hoje e qual só vai adicionar complexidade. Cada verbete aqui começa por essa decisão e só depois vira tutorial. O catálogo cresce com o tempo — os primeiros cobrem codificação assistida, engenharia de contexto e sistemas multiagentes.

TipoTópico

7 verbetes

Ferramenta · Anthropic

Claude Code

O agente de codificação da Anthropic que mora no terminal e trabalha dentro do seu repositório.

É: Um agente de codificação que roda no terminal, lê e edita os arquivos do seu projeto, executa comandos e commita — em vez de só sugerir a próxima linha.
Use quando: Quando a tarefa envolve vários arquivos, exige entender o repositório inteiro ou é repetitiva o bastante para você conseguir descrevê-la em uma frase.
Evite quando: Quando você não sabe explicar o resultado esperado, quando o código é crítico e ninguém vai revisar, ou quando a mudança cabe em duas linhas que você digitaria mais rápido.

Ferramenta · OpenAI

Codex

O agente de codificação da OpenAI, que aparece no terminal, na IDE, na nuvem e dentro dos seus pull requests.

É: Um agente de codificação da OpenAI que roda a mesma tarefa em quatro lugares: terminal, extensão de IDE, sandbox na nuvem e revisão automática de pull requests.
Use quando: Quando você quer despachar tarefas bem delimitadas e ir fazer outra coisa — especialmente várias em paralelo — ou quando quer uma primeira revisão automática em todo PR.
Evite quando: Quando a tarefa precisa de idas e vindas com você a cada passo, ou quando ninguém da equipe tem tempo de revisar o que voltar da nuvem.

Ferramenta · Anysphere

Cursor

O editor que colocou a IA no centro da edição de código — e virou o padrão de fato para programar com assistência.

É: Um editor de código — fork do VS Code — em que a IA não é um plugin, e sim parte da forma de editar arquivos, navegar e refatorar.
Use quando: Quando você quer manter a mão no volante: editar, ver o diff na hora, ajustar e seguir, com o menor atrito possível entre pensar e aplicar.
Evite quando: Quando a sua equipe é presa a uma IDE específica, quando o código não pode sair da rede interna, ou quando você precisa de automação sem ninguém olhando.

Ferramenta · Google

Antigravity

A aposta do Google em uma IDE onde você gerencia agentes em vez de escrever código.

É: Uma IDE agent-first do Google, construída sobre o Gemini, em que a tela principal é um gerenciador de agentes trabalhando em paralelo — não um arquivo aberto.
Use quando: Quando você quer prototipar rápido delegando tarefas paralelas e quer que o próprio agente verifique o resultado no navegador antes de te entregar.
Evite quando: Quando o trabalho é de produção com risco real, quando o orçamento precisa ser previsível, ou quando a equipe não tolera mudanças de produto frequentes.

Conceito

Context rot

Por que encher a janela de contexto piora a resposta — e o que fazer a respeito.

É: A queda mensurável de qualidade de um LLM conforme o número de tokens de entrada cresce — mesmo em tarefas simples e mesmo dentro da janela anunciada.
Use quando: Use o conceito sempre que for decidir quanto contexto injetar: em RAG, em agentes de longa duração e em qualquer prompt que cresce com o tempo.
Evite quando: Não é desculpa para não dar contexto. Contexto insuficiente erra mais rápido e mais feio que contexto grande.

Técnica · Padrão aberto

Agent Skills

Pastas com instruções que transformam um agente genérico em especialista — sem inchar o contexto.

É: Uma pasta com um arquivo SKILL.md que ensina a um agente como executar uma tarefa específica — carregada só quando a tarefa aparece.
Use quando: Quando existe um procedimento real e repetível, com regras próprias, que você hoje explica à mão toda vez que precisa dele.
Evite quando: Quando a instrução cabe em duas frases, quando o conhecimento muda todo dia, ou quando o que você precisa é acesso a um sistema — isso é MCP, não skill.

Conceito

RAG comum vs RAG empresarial

Por que o protótipo que responde bem em uma tarde não sobrevive ao primeiro contato com uma empresa de verdade.

É: RAG é buscar trechos relevantes e injetá-los no prompt. RAG empresarial é a mesma ideia acrescida de permissões, frescor, resolução de conflito, evidência e avaliação contínua.
Use quando: Use RAG quando a resposta depende de conhecimento que muda e que o modelo não tem. Use a versão empresarial quando a resposta errada tem consequência.
Evite quando: Não use RAG quando o conhecimento é estável e pequeno o bastante para caber no prompt, nem quando o problema real é que a informação não existe em lugar nenhum.