Desenvolver com agentes

P3.1 O ciclo de trabalho: objetivo, proposta, autorização, conferência

Todo trabalho nesta trilha segue o mesmo ciclo:

1. Objetivo: você diz o que quer e como vai saber que está pronto (P3.2).
2. Proposta: o Claude estuda o problema e propõe o próximo passo, explicando por quê.
3. Autorização: você autoriza, pede outro caminho ou pede uma segunda opinião (P3.3 e P3.6).
4. Conferência: o Claude executa e mostra a evidência de que funcionou; você confere (P3.4).

O ciclo se repete até o critério de pronto ser atingido. Nem todo passo precisa da sua autorização. O que decide é o risco, não o tamanho da tarefa:

P3.2 Dizer aonde quer chegar e o que é "pronto"

Um agente trabalha bem sozinho quando sabe conferir o próprio trabalho. Para isso, o pedido precisa de um critério de pronto verificável: algo que um teste, uma conta ou uma pessoa consiga dizer se está certo ou não. Use este modelo:

Quero: [o resultado, com um verbo]
Para: [quem vai usar e para quê]
Pronto quando:
  1. [algo que dá para conferir]
  2. [outro]
Não pode: [o que não deve mudar ou acontecer]
Antes de cada etapa importante, me mostre o que propõe, por quê, as alternativas e o risco.

O plugin autonomo transforma esses critérios em testes automáticos. Quando todos passam, o trabalho está pronto; quando um falha, o Claude sabe o que corrigir sem precisar perguntar a você.

P3.3 Decidir sobre as propostas do Claude

Cada decisão importante chega num formato fixo, o cartão de decisão. Se o Claude esquecer algum campo, peça.

O que proponho

Guardar os cadastros numa planilha do Google em vez de um banco de dados.

Por quê

São menos de 500 linhas, você já usa o Drive e consegue conferir os dados sem mim.

Alternativas

Um banco de dados gratuito: mais trabalho agora, aguenta crescer.

Risco e como desfazer

Baixo. Migrar depois leva cerca de uma hora.

O que preciso de você

Autorizar, escolher a alternativa ou pedir uma segunda opinião.

Quatro perguntas para não autorizar no automático:

1. Eu entendi o porquê? Se não, peça: "explique como se eu nunca tivesse programado".
2. Dá para desfazer? Se não dá, leia com mais calma e peça uma prévia.
3. Isso aproxima do critério de pronto? Se o passo não tem relação com o objetivo, pergunte por que ele é necessário.
4. O que eu perco com a alternativa? Toda escolha tem um custo; saber qual é faz parte da decisão.

Registre cada decisão importante num arquivo DECISOES.md no projeto. Peça ao Claude para criar e manter, mas o motivo da decisão é seu:

## 2026-11-02 · Onde guardar os cadastros
Proposta: planilha do Google (alternativa: banco de dados gratuito)
Segunda opinião: não pedi
Decidi: planilha
Por quê: são poucos dados e eu preciso conferir sem depender de ninguém.
Rever quando: passar de 2 mil cadastros

P3.4 Conferir o resultado sem ler código

Você não precisa ler o código para saber se ele funciona. Precisa ler a evidência:

P3.5 Quando travar

• Erro que você não entende: "Explique este erro em linguagem simples e proponha duas saídas, com o risco de cada uma."
• O Claude anda em círculos (tenta a mesma correção várias vezes): peça para ele parar, resumir o que tentou e o que aprendeu, e propor uma abordagem diferente.
• Algo que funcionava quebrou: "Volte para a última versão em que os testes passavam e me mostre o que mudou desde então." O Git guarda todas as versões.
• Você não sabe se a proposta é boa: peça uma segunda opinião (P3.6).

P3.6 Segunda opinião: Gemini e GPT na decisão

Antes de uma decisão importante, você pode ouvir outros modelos. O jeito mais simples não custa nada a mais: peça ao Claude a pergunta pronta, cole no ChatGPT ou no Gemini que você já usa e traga a resposta de volta.

Prepare uma pergunta para eu levar ao GPT e ao Gemini sobre esta decisão.
Inclua só o contexto necessário, sem dados pessoais, senhas ou documentos sigilosos.
Depois que eu colar as respostas, me diga onde vocês concordam, onde divergem
e o que você recomenda agora, avisando se mudou de ideia.

• Opinião informa, teste decide. Três modelos podem concordar e estar errados, porque aprenderam de textos parecidos. Perguntas de fato (funciona? a conta está certa?) se resolvem com teste, não com votação.
• Vale para decisões de julgamento: escolher entre duas soluções, revisar um texto para cliente, avaliar um risco.
• Privacidade: mandar contexto para outro modelo é enviar dados para outra empresa. Confira o que vai na pergunta antes de colar.
• Registre as opiniões e a sua decisão no DECISOES.md.

P3.7 Como funcionam os laboratórios com agentes

Os laboratórios das duas trilhas têm o mesmo problema, o mesmo objetivo e o mesmo critério de pronto. Na trilha com agentes, você aprende como o problema se resolve vendo o Claude resolver, e depois resolve uma variação conduzindo o Claude. Saber como se resolve vale tanto quanto ter resolvido. Só assistir dá a sensação de ter entendido sem ter entendido; por isso cada laboratório tem cinco momentos:

Nas páginas dos módulos, o seletor Sua trilha mostra a versão de cada laboratório. A versão da outra trilha fica recolhida, como opcional: abrir para ver como um desenvolvedor resolve o mesmo problema ajuda a entender o que o Claude fez.

Projeto do módulo: o primeiro laboratório com agentes

Faça o projeto do Módulo 2, o extrator de recibos, na versão com agentes. É o mesmo problema que a trilha com código resolve escrevendo o programa. Este módulo está concluído quando você tem:

1. O pedido inicial com critério de pronto verificável (P3.2).
2. Um DECISOES.md com pelo menos cinco decisões, cada uma com o seu porquê (P3.3).
3. Os testes passando, e um teste que você viu falhar de propósito (P3.4).
4. Uma decisão tomada com segunda opinião (P3.6).

Recursos para aprofundar

• Visão geral do Claude Code · documentação oficial em português
• Como o Claude Code funciona · o ciclo de trabalho do agente
• Plugin autonomo · prepara o computador e configura a autonomia com barreiras