Playbook de engenharia orientada a claude.dev
As equipes da Anthropic publicam como constroem software com agentes em claude.dev. Este skill carrega essa orientação, digerida postagem por postagem. Atualizado até 2026-10-15 (16 postagens).
Como responder
- Encontre o tópico da pergunta na tabela abaixo e leia o arquivo de referência correspondente antes de responder. Abra um resumo de postagem em
posts/quando precisar dos detalhes ou das palavras exatas. - Molde a resposta assim:
- O que as equipes da Anthropic fazem: a orientação que se aplica, cada ponto vinculado à sua postagem como
https://claude.dev/blog/<slug>/. - Além do claude.dev: qualquer coisa que as postagens não cubram, respondida com base na prática geral e identificada como tal. Deixe esta parte de fora quando as postagens cobrirem toda a pergunta.
- O que as equipes da Anthropic fazem: a orientação que se aplica, cada ponto vinculado à sua postagem como
- Cite apenas os resumos em
posts/, nunca de memória. - Os "Detalhes perecíveis" de um resumo (nomes de modelos, preços, padrões de esforço) são válidos apenas para o modelo ou versão que nomeiam. Verifique o que está atual antes de repetir um.
- Se o usuário pedir a orientação mais recente, ou se a pergunta tratar de algo após a data acima, leia https://claude.dev/rss.xml e qualquer postagem mais nova que essa data antes de responder.
Tópicos
| A pergunta é sobre | Leia |
|---|---|
| Revisão de código, aprovações, merge, flags, rollout, rollback, quem é dono de uma mudança | references/shipping.md |
| Testes, evals, casos dourados, avaliadores, benchmarks, portões de CI, agentes verificando o próprio trabalho | references/verification.md |
| Entregar trabalho a agentes: especificações de tarefa, CLAUDE.md, esforço, escolha de modelo, sessões locais ou em nuvem, subagentes, skills, formatos de saída | references/delegation.md |
| Agentes executando sem supervisão ou em agendamento: estado entre execuções, credenciais, orçamentos, guardrails | references/automation.md |
| Construção de agentes: ferramentas, contexto, cache de prompt, workflows | references/agent-design.md |
| Custo por tarefa, tempo humano por mudança, reversões, incidentes | references/measurement.md |
Regras centrais
- Nomeie a linha de chegada e a verificação que a comprova, e deixe cozinhar. (Opus 5.5 playbook, Cloud sessions)
- Nenhuma afirmação sem evidência. Agentes executam verificações reais e mostram a saída antes que uma pessoa olhe, e um agente diferente faz a verificação. (Code review, Dynamic workflows)
- Pergunte qual verificação deve pegar um problema, não se um humano leu o código. Aprovações humanas escalam com o risco, a mudança define o nível, e a aprovação de um agente nunca conta como a de uma pessoa. (Code review)
- Julgue o sistema pelo tempo humano por mudança, com reversões e incidentes como o guardrail. (Code review)
- Casos dourados vêm da realidade, e dois especialistas concordariam em cada veredito. Transforme incidentes em casos de eval, e leia transcrições avaliadas antes de confiar em um avaliador. (Code review, Eval design)
- Confie apenas em ganhos que superam o ruído em casos que o ajustador nunca viu. (Eval design)
- Dê aos agentes um número a superar que seja comprovadamente correlacionado ao resultado real, e consolide cada vitória no CI. (claude.ai 3x faster)
- Torne erros baratos de desfazer: uma fila de merge, flags de curta duração, rollout em etapas, rollback rápido e um dono nomeado para cada mudança. (Code review, claude.ai 3x faster)
- Agentes não supervisionados falham alto: uma leitura falha nunca é um dia silencioso, e nada conta como concluído até que o destino confirme. (Agent automations)
- Mantenha o contexto enxuto e deixe o agente encontrar o resto; exclua regras conforme os modelos melhoram. (Context engineering, Seeing like an agent)
- Pague por tarefas concluídas, não por tokens: uma verificação é mais barata que mais esforço, e uma repetição custa mais do que qualquer economia. (Task cost)