Território 1 — Orientação e setup
O que é Claude Code de verdade
Claude Code é um agente que lê arquivos, executa comandos, altera projetos e verifica resultados em ciclos.
Sem esse modelo mental, ele parece apenas um chat que aprendeu a usar terminal.
Distinguir modelo, chat, copiloto e agenteEntender o loop agênticoReconhecer ferramentas e efeitos reaisSaber por que o projeto importa mais que o prompt isoladoPeça uma leitura somente exploratória de um projeto simples e observe quais ferramentas entram no loop.
O entregável “Mapa do loop agêntico” existe e pode ser verificado por outra pessoa.Quando ele ganha do chat, IDE e automação tradicional
Escolha Claude Code quando a tarefa exige navegar um projeto, coordenar arquivos, executar ferramentas e iterar com feedback.
Usar agente para pergunta simples custa mais e complica. Usar chat para tarefa de repositório também.
Comparar chat, autocomplete, agente e scriptIdentificar tarefas com contexto de projetoSeparar exploração, execução e automação recorrenteReconhecer quando não usar um agenteClassifique dez tarefas reais entre chat, IDE, Claude Code, script ou trabalho manual.
O entregável “Matriz de escolha” existe e pode ser verificado por outra pessoa.Terminal, IDE, desktop, web ou Remote Control
A mesma base agêntica aparece em superfícies diferentes, mas execução, revisão visual e continuidade mudam.
Escolher a superfície errada cria atrito e pode esconder onde o código realmente está rodando.
Comparar execução local, cloud e Remote ControlEscolher entre CLI, IDE, desktop e webEntender continuidade entre superfíciesIdentificar limites de cada ambienteExecute a mesma tarefa exploratória em duas superfícies e registre o que ficou melhor ou pior.
O entregável “Decisão de ambiente padrão” existe e pode ser verificado por outra pessoa.Instalação, autenticação e diagnóstico
Instale pelo método recomendado, autentique e valide a configuração antes de abrir um projeto importante.
Problema de instalação parece problema de inteligência quando ninguém roda o diagnóstico.
Instalar e atualizar Claude CodeAutenticar com o método adequadoUsar doctor e safe modeIdentificar plugin, hook ou MCP quebrando o ambienteInstale, rode doctor e abra um repositório de teste em uma branch separada.
O entregável “Ambiente validado” existe e pode ser verificado por outra pessoa.Comandos, modelos, effort e velocidade
Aprenda os controles que mudam o comportamento da sessão sem transformar a trilha em bingo de slash command.
Modelo mais forte, effort máximo e fast mode não são sinônimos de melhor decisão.
Usar comandos essenciais de sessãoTrocar modelo e effort com intençãoEntender fast mode e advisorEscolher profundidade conforme risco e tarefaExecute a mesma análise com duas configurações de modelo ou effort e compare qualidade, tempo e consumo.
O entregável “Política pessoal de modelo” existe e pode ser verificado por outra pessoa.Planos, limites e custo sem susto
Entenda a diferença entre uso incluído em assinatura, créditos, API e custo por execução.
Sem separar limite de plano de custo real, a leitura de /usage vira horóscopo financeiro.
Ler /usage corretamenteSeparar assinatura, créditos e APIIdentificar tarefas de alto consumoCriar um limite inicial por missãoRegistre uma baseline de custo ou uso para a primeira tarefa da trilha.
O entregável “Baseline de uso” existe e pode ser verificado por outra pessoa.Território 2 — O loop que resolve 80%
Contexto, ação, resultado e próxima decisão
Cada ferramenta usada devolve informação para a próxima decisão do agente.
O valor está no ciclo, não em uma resposta perfeita de primeira.
Ler o histórico de ferramentasInterromper e redirecionarSeparar intenção de execuçãoDetectar quando o loop perdeu o objetivoAcompanhe uma tarefa e anote como cada resultado alterou a decisão seguinte.
O entregável “Diário de um loop” existe e pode ser verificado por outra pessoa.Contexto que ajuda sem despejar o repositório
Dê objetivo, restrições, referências e critérios de aceite sem copiar tudo que encontrou.
Contexto demais compete com o problema. Contexto de menos força o agente a adivinhar.
Definir objetivo e não escopoApontar arquivos e exemplos relevantesExplicitar restrições importantesDeixar o agente buscar o restanteEscreva versões vaga, excessiva e verificável do mesmo pedido.
O entregável “Prompt verificável” existe e pode ser verificado por outra pessoa.Explore antes de editar
Peça uma leitura do fluxo, dos arquivos e das dependências antes de autorizar alterações.
Agente que começa editando cedo tende a defender uma hipótese ruim por tempo demais.
Pedir mapa de arquiteturaRastrear fluxo ponta a pontaSeparar fato de inferênciaConfirmar lacunas antes da implementaçãoInvestigue uma funcionalidade sem permitir edição e revise as suposições encontradas.
O entregável “Mapa da área afetada” existe e pode ser verificado por outra pessoa.Planeje antes de executar
Use plan mode para tarefas multi-arquivo, decisões arquiteturais ou mudanças com risco.
Plano bom reduz retrabalho. Plano enorme apenas antecipa a burocracia.
Entrar e sair de plan modePedir alternativas e trade-offsRevisar arquivos e ordem de execuçãoDefinir checkpoints antes da implementaçãoPeça um plano, rejeite pelo menos uma escolha e aprove apenas a versão revisada.
O entregável “Plano aprovado” existe e pode ser verificado por outra pessoa.Itere em passos pequenos
Quebre trabalho grande em fatias que possam ser rodadas, revisadas e revertidas.
Pedido monolítico maximiza a chance de receber muita coisa errada de uma vez.
Criar fatias verticais pequenasUsar feedback específicoPedir checkpoints intermediáriosInterromper quando a direção pioraImplemente uma tarefa em três etapas e valide cada uma antes de continuar.
O entregável “Sequência de três checkpoints” existe e pode ser verificado por outra pessoa.Leia o diff e exija uma prova
Revise a mudança, execute testes e peça evidência que corresponda ao risco.
Código plausível não é código correto. A pessoa que aprova continua sendo você.
Ler diff antes de aceitarRelacionar mudança a critério de aceiteRodar testes e checagens reaisRecusar afirmações sem evidênciaFaça uma alteração pequena, leia cada linha do diff e encontre ao menos um ponto para questionar.
O entregável “Primeiro commit auditado” existe e pode ser verificado por outra pessoa.Território 3 — Debugging e recuperação
Reproduza o erro antes de corrigir
Transforme relato vago em passos reproduzíveis, entrada, saída esperada e saída atual.
Sem reprodução, cada correção é um palpite caro.
Extrair passos de reproduçãoCapturar logs e estadoReduzir o casoDistinguir sintoma de causaEscolha um bug e faça o Claude reproduzi-lo sem editar arquivos.
O entregável “Receita de reprodução” existe e pode ser verificado por outra pessoa.Crie hipóteses e encontre a causa raiz
Peça hipóteses ordenadas por evidência e testes que possam derrubá-las.
Explicação convincente não substitui uma hipótese falsificável.
Gerar hipóteses concorrentesPriorizar pela evidênciaDesenhar teste discriminadorExplicar por que a causa produz o sintomaExija três hipóteses e um teste para eliminar cada uma antes da correção.
O entregável “Árvore de hipóteses” existe e pode ser verificado por outra pessoa.Faça o teste falhar antes de ficar verde
Crie ou identifique uma verificação que falhe pelo motivo correto antes de alterar a implementação.
Teste escrito depois pode apenas documentar o remendo que o agente acabou de inventar.
Escrever teste de regressãoConfirmar falha relevanteAplicar correção mínimaRodar suite relacionadaProduza teste vermelho, correção e teste verde para o bug escolhido.
O entregável “Regressão protegida” existe e pode ser verificado por outra pessoa.Perceba quando o Claude entrou em loop de remendo
Identifique sinais como mudança crescente, novos erros e explicações que mudam a cada tentativa.
Persistência agêntica também pode significar cavar um buraco com muita confiança.
Definir limite de tentativasParar e resumir o estadoVoltar à reproduçãoTrocar abordagem em vez de empilhar patchesInterrompa uma sequência de correções, peça um recap e redefina a investigação.
O entregável “Protocolo de saída do loop” existe e pode ser verificado por outra pessoa.Checkpoints, rewind e Git sem confundir as redes
Use checkpoint para arquivos da sessão e Git para histórico compartilhável e mudanças fora do alcance do rewind.
Checkpoint não substitui versionamento. Git também não desfaz a conversa.
Entender snapshots de arquivoUsar rewindSeparar estado da conversa e filesystemCriar branch e commit antes de tarefas arriscadasFaça uma mudança, reverta com checkpoint e repita usando Git.
O entregável “Plano de recuperação” existe e pode ser verificado por outra pessoa.Território 4 — Engenharia de contexto
Entenda o que ocupa a janela de contexto
Visualize mensagens, resultados de ferramentas, instruções, extensões e o que sobrevive à compactação.
Você não consegue administrar um orçamento que não enxerga.
Ler a timeline de contextoIdentificar maiores consumidoresEntender compactionSeparar contexto persistente e temporárioInspecione uma sessão real e classifique as cinco maiores fontes de contexto.
O entregável “Inventário de contexto” existe e pode ser verificado por outra pessoa.CLAUDE.md sem virar testamento
Registre comandos, convenções e decisões que o agente não consegue descobrir sozinho.
Instrução longa e genérica perde força e consome contexto em toda sessão.
Escolher escopo do arquivoEscrever regras específicasRegistrar comandos de validaçãoCortar conteúdo óbvioCrie ou revise um CLAUDE.md e remova tudo que o repositório já explica.
O entregável “CLAUDE.md operacional” existe e pode ser verificado por outra pessoa.Rules por pasta, linguagem e tipo de arquivo
Carregue instruções específicas somente quando o trabalho tocar os caminhos correspondentes.
Regra global para problema local faz todo o projeto pagar a conta.
Criar `.claude/rules`Usar escopo por caminhoSeparar frontend, backend, teste e segurançaVerificar quando cada regra carregaCrie duas rules com escopos diferentes e teste o carregamento.
O entregável “Rules contextuais” existe e pode ser verificado por outra pessoa.Auto memory: deixe aprender, mas faça auditoria
Use memória automática para padrões descobertos e revise o que foi salvo.
Memória errada carregada todo dia transforma um engano em tradição.
Distinguir memória de instruçãoAbrir e editar /memoryRemover segredos e conclusões ruinsEntender escopo entre worktreesAudite a memória de um projeto e classifique cada item como útil, errado ou sensível.
O entregável “Memória auditada” existe e pode ser verificado por outra pessoa.Vibe Doc como contexto de produto
Use documentos de contexto, personas, dados, métricas, layout e integrações para reduzir suposições de produto.
Claude pode escrever código correto para uma decisão de produto completamente errada.
Separar intenção de produto e instrução operacionalReferenciar documentos sob demandaTransformar requisito em critério de aceiteDetectar contradições antes do códigoPreencha ou revise um Vibe Doc e peça uma auditoria de lacunas e conflitos.
O entregável “Vibe Doc revisado” existe e pode ser verificado por outra pessoa.Documentação, imports e contexto sob demanda
Mantenha detalhes em documentos próprios e carregue o que a tarefa exige.
Tudo no CLAUDE.md é sempre pago. Documento referenciado entra quando precisa.
Importar documentação relevanteCriar índice de contextoEscrever para humano e agenteAtualizar docs junto com mudançasCrie um índice de documentos e teste uma tarefa com e sem a referência correta.
O entregável “Mapa de documentação” existe e pode ser verificado por outra pessoa.Prompt caching e estabilidade da sessão
Entenda o que mantém ou invalida cache para evitar leituras erradas sobre custo e velocidade.
Mudar modelo, plugin ou MCP no meio da comparação pode destruir a base do experimento.
Entender camadas de cacheReconhecer invalidaçõesVerificar desempenho do cacheComparar subagentes e sessão principalFaça duas execuções controladas e depois invalide o cache intencionalmente.
O entregável “Experimento de cache” existe e pode ser verificado por outra pessoa.Clear, compact e recap com intenção
Escolha entre limpar, compactar ou recapitular conforme a continuidade necessária.
Carregar contexto morto é caro. Limpar contexto vivo também.
Usar /clear entre tarefasCompactar com focoGerar recap antes de trocar de sessãoDecidir quando começar de novoPegue uma sessão longa, gere recap, compacte e compare o estado resultante.
O entregável “Protocolo de continuidade” existe e pode ser verificado por outra pessoa.Monorepos e bases grandes
Reduza o que o agente lê, distribua contexto por diretório e limite o escopo de trabalho.
Em base grande, contexto mal configurado vira custo, lentidão e navegação por grep infinito.
Escolher diretório inicialDistribuir CLAUDE.md e rulesBloquear código gerado ou vendorizadoUsar inteligência de código e worktreesDesenhe uma estratégia de contexto para uma base com múltiplos domínios.
O entregável “Plano para base grande” existe e pode ser verificado por outra pessoa.Território 5 — Claude Code OS
Anatomia de .claude e ~/.claude
Entenda o que pertence ao usuário, ao projeto, à máquina e à organização.
Arquivo no escopo errado pode vazar preferência, quebrar o time ou simplesmente nunca carregar.
Mapear arquivos e diretóriosSeparar configuração pessoal e compartilhadaEntender dados locais de sessãoVersionar apenas o que faz sentidoClassifique os arquivos atuais do seu setup por escopo e compartilhamento.
O entregável “Mapa do Claude Code OS” existe e pode ser verificado por outra pessoa.Settings, precedência e escopos
Configure comportamento em escopo managed, user, project e local sem criar guerra de precedência.
Configuração que funciona apenas na sua máquina não é padrão de projeto.
Entender escoposAplicar precedênciaSeparar settings e settings.localVerificar configuração ativaMova uma configuração para o escopo correto e valide em uma nova sessão.
O entregável “Settings organizados” existe e pode ser verificado por outra pessoa.Permissions e modos de aprovação
Use allow, ask e deny junto com modos de permissão adequados ao risco.
Aprovar tudo manualmente mata o fluxo. Liberar tudo mata outra coisa.
Escrever regras de permissãoEscolher plan, accept edits, auto ou dontAskEntender prioridade de denyTestar regras com comandos compostosConfigure uma ação liberada, uma que pergunta e uma bloqueada.
O entregável “Política de permissões” existe e pode ser verificado por outra pessoa.Hooks: quando uma regra precisa acontecer sempre
Dispare scripts, prompts, agentes ou endpoints em eventos do ciclo de vida.
CLAUDE.md orienta. Hook pode bloquear, validar e registrar.
Escolher evento e matcherCriar PreToolUse e PostToolUseUsar hooks command, prompt, agent e HTTPTratar timeout e falhaCrie um hook de qualidade e outro que bloqueie uma ação perigosa.
O entregável “Dois quality gates” existe e pode ser verificado por outra pessoa.Skills: procedimentos que carregam sob demanda
Empacote conhecimento, instruções e recursos para um procedimento recorrente.
Skill boa economiza explicação. Skill ruim automatiza ambiguidade.
Definir gatilho e descriçãoEscrever SKILL.mdIncluir scripts e referênciasTestar acionamento manual e automáticoTransforme um procedimento semanal em uma skill reutilizável.
O entregável “Primeira skill” existe e pode ser verificado por outra pessoa.Subagentes: isole contexto e responsabilidade
Crie agentes especializados com prompt, ferramentas, modelo, skills e memória próprios.
Subagente não é organograma imaginário. É unidade de delegação com fronteira clara.
Escolher tarefa que merece isolamentoRestringir ferramentasDefinir formato de retornoUsar memória ou fork quando necessárioCrie um subagente revisor ou pesquisador e compare a sessão principal.
O entregável “Subagente especializado” existe e pode ser verificado por outra pessoa.MCP: conecte ferramentas sem colecionar servidor
Use MCP quando o agente precisa acessar dados ou ações externas que fecham um workflow real.
Cada integração adiciona poder, contexto, manutenção e superfície de ataque.
Escolher MCP, CLI ou APIConfigurar escopoRevisar ferramentas expostasDesligar e depurar servidoresConecte um servidor útil, execute leitura e ação segura e documente a remoção.
O entregável “Integração MCP validada” existe e pode ser verificado por outra pessoa.Plugins: distribua o sistema inteiro
Empacote skills, agentes, hooks, MCPs e outros componentes em uma unidade instalável.
Copiar pasta pelo Slack funciona até a segunda atualização.
Entender anatomia de pluginValidar componentesCriar marketplace interno ou públicoPlanejar versão e compatibilidadeEmpacote ao menos uma skill e um agente em um plugin local.
O entregável “Plugin mínimo” existe e pode ser verificado por outra pessoa.Território 6 — Workflows do mundo real
Entrar em uma codebase desconhecida
Mapeie arquitetura, modelos, fluxos e vocabulário antes de escolher onde tocar.
Ler dez arquivos aleatórios não é onboarding.
Obter visão geralEncontrar código relevanteTraçar fluxo ponta a pontaCriar glossário do domínioProduza um briefing de onboarding para uma área do projeto.
O entregável “Mapa de codebase” existe e pode ser verificado por outra pessoa.Construir uma feature vertical
Implemente uma fatia que atravessa interface, regra, dados e validação sem tentar construir o produto inteiro.
Feature horizontal demais produz muita infraestrutura e pouco valor visível.
Escolher fatia verticalPlanejar contratos e dadosImplementar em checkpointsValidar critério de aceiteConstrua uma funcionalidade pequena do Vibe Doc até a execução.
O entregável “Feature funcionando” existe e pode ser verificado por outra pessoa.Corrigir um bug real sem esconder o sintoma
Aplique reprodução, hipótese, teste de regressão e correção mínima em um caso real.
O workflow só virou habilidade quando funciona fora do Dojo.
Reusar o protocolo de debuggingLimitar o diffProteger regressãoDocumentar causa raizResolva um bug real do projeto ou de um issue público.
O entregável “Bug corrigido” existe e pode ser verificado por outra pessoa.Refatorar sem mudar comportamento
Defina invariantes, crie rede de testes e altere estrutura em pequenos passos.
Refatoração agêntica sem invariantes vira reescrita com branding melhor.
Definir comportamento preservadoCriar caracterizaçãoRefatorar incrementalmenteMedir legibilidade e riscoRefatore uma área pequena mantendo a mesma suite e saída observável.
O entregável “Refatoração protegida” existe e pode ser verificado por outra pessoa.Criar e melhorar testes
Use o agente para encontrar lacunas, gerar casos e revisar se os testes realmente protegem comportamento.
Cobertura alta pode apenas provar que muitas linhas foram executadas durante um teatro.
Mapear risco e coberturaGerar casos de bordaEvitar teste acoplado à implementaçãoExecutar suite e revisar falsos positivosEscolha um fluxo crítico e adicione testes que falhariam com uma regressão plausível.
O entregável “Suite de risco” existe e pode ser verificado por outra pessoa.Documentação, notas, imagens e trabalho não código
Use Claude Code em pastas de documentação, requisitos, imagens e artefatos que sustentam o projeto.
Agente de código também é útil quando o produto ainda está em Markdown.
Trabalhar em pastas não códigoReferenciar arquivos e imagensAtualizar documentação junto com implementaçãoGerar diagramas e decisõesAtualize uma documentação com base em uma mudança real e valide links e exemplos.
O entregável “Documentação sincronizada” existe e pode ser verificado por outra pessoa.Revisar código e preparar pull request
Gere uma revisão focada em risco, valide achados e produza um PR pequeno e legível.
Review que comenta estilo e inventa bug ocupa tempo sem reduzir risco.
Revisar diff por impactoReproduzir achadosPreparar descrição de PRSeparar revisão local e multiagenteRevise uma branch, elimine falso positivo e gere a descrição final do PR.
O entregável “PR revisável” existe e pode ser verificado por outra pessoa.Território 7 — Autonomia e trabalho paralelo
Tarefas longas e sessões em background
Prepare tarefas que podem continuar sem você olhando cada ferramenta.
Autonomia útil começa com objetivo, limites, teste e condição de parada.
Definir missão autônomaExecutar em backgroundAcompanhar bloqueiosRetomar sem perder contextoDelegue uma tarefa de pelo menos três etapas e intervenha apenas em checkpoints.
O entregável “Tarefa longa concluída” existe e pode ser verificado por outra pessoa.Retomar, nomear e ramificar sessões
Use sessões como linhas de investigação e preserve alternativas sem misturar contextos.
Uma conversa infinita não é memória. É um depósito com busca ruim.
Nomear e retomar sessõesCriar branch de conversaComparar abordagensEncerrar sessões obsoletasCrie duas abordagens a partir da mesma sessão e escolha uma com critério.
O entregável “Árvore de decisões” existe e pode ser verificado por outra pessoa.Worktrees para mudanças que não podem colidir
Isole branches e diretórios de trabalho para sessões paralelas que editam código.
Dois agentes no mesmo diretório conseguem transformar paralelismo em batalha naval.
Criar e remover worktreesEscolher fronteiras de arquivoIntegrar branchesPreservar trabalho não commitadoExecute duas tarefas independentes em worktrees e integre ambas.
O entregável “Duas linhas paralelas integradas” existe e pode ser verificado por outra pessoa.Subagentes em paralelo na mesma missão
Delegue pesquisas ou revisões independentes e reúna respostas no contexto principal.
Paralelizar tarefas dependentes apenas produz respostas inconsistentes mais rápido.
Definir tarefas independentesEvitar contexto duplicadoPadronizar retornoSintetizar conflitosDelegue três análises independentes e peça uma síntese comparativa.
O entregável “Relatório multiagente” existe e pode ser verificado por outra pessoa.Agent View para despachar e monitorar sessões
Use uma visão central para acompanhar sessões em background, bloqueios e conclusões.
Tela bonita não resolve ausência de dono, prioridade ou critério de encerramento.
Abrir e navegar no Agent ViewDespachar tarefas independentesAnexar a uma sessãoComparar com subagentes e worktreesDespache duas sessões e registre quando foi necessário intervir.
O entregável “Painel de sessões operado” existe e pode ser verificado por outra pessoa.Agent Teams: coordenação entre sessões
Explore times de agentes quando os membros precisam compartilhar tarefas e se comunicar.
Se todo mundo depende de todo mundo, você não criou um time. Criou uma reunião.
Definir papéis e fronteirasCriar uma equipeAcompanhar tarefas e estadoComparar com subagentesExecute um desafio pequeno com dois papéis independentes e integração final.
O entregável “Experimento com Agent Teams” existe e pode ser verificado por outra pessoa.Workflows dinâmicos e execução até condição
Use workflows quando a tarefa pede repetição, paralelismo ou continuidade até uma condição verificável.
Workflow autônomo sem limite pode transformar uma checagem em assinatura mensal surpresa.
Escolher quando usar workflowGerar e salvar um fluxoDefinir tamanho e condição de paradaAcompanhar e retomar execuçãoCrie um workflow que repita uma verificação até o critério ficar verdadeiro.
O entregável “Workflow reutilizável” existe e pode ser verificado por outra pessoa.Território 8 — Automação e integração
Modo headless e execução não interativa
Execute Claude em pipelines, scripts e tarefas em lote sem depender da interface interativa.
Automação começa quando a entrada, saída e falha deixam de depender de você interpretar a tela.
Usar claude -pControlar ferramentas e permissõesRetomar conversasTratar códigos de saídaCrie um script que recebe um arquivo e produz uma análise reproduzível.
O entregável “Primeira execução headless” existe e pode ser verificado por outra pessoa.Pipes, streaming e saída estruturada
Transforme resposta em dados consumíveis por outras ferramentas.
Texto bonito é péssima API.
Enviar dados por stdinEscolher formato de saídaValidar JSON ou schemaTransmitir resultadosMonte um pipeline que lê dados, gera JSON válido e passa para outra ferramenta.
O entregável “Pipeline estruturado” existe e pode ser verificado por outra pessoa.Routines e tarefas agendadas
Dispare agentes por agenda, API ou evento quando o workflow é estável e recorrente.
Automatizar tarefa instável só garante que ela falhe pontualmente.
Criar routineConfigurar gatilhoEscolher repositório e branchAcompanhar execuçõesAutomatize uma auditoria ou atualização segura e execute duas vezes.
O entregável “Routine validada” existe e pode ser verificado por outra pessoa.GitHub Actions, CI e revisão automatizada
Integre Claude ao ciclo de issue, pull request, build e revisão com permissões explícitas.
Agente em CI herda a velocidade e também os riscos da sua configuração.
Configurar workflowLimitar token e permissõesUsar contexto do eventoRevisar resultado antes de mergeCrie uma automação de revisão ou diagnóstico em um repositório de teste.
O entregável “Workflow de CI” existe e pode ser verificado por outra pessoa.Remote Control, Slack, Chrome e computer use
Conecte o agente às superfícies onde solicitações e validações realmente acontecem.
Mais superfície significa mais contexto, mais permissão e mais lugares para uma ação escapar.
Continuar sessão remotamenteDisparar trabalho por SlackInteragir com navegadorDistinguir integração de automaçãoDesenhe um fluxo multissuperfície e execute apenas a parte de menor risco.
O entregável “Blueprint de integração” existe e pode ser verificado por outra pessoa.Claude Agent SDK: o próximo passo
Leve loop, ferramentas, permissões, hooks, MCP e sessões para uma aplicação própria em Python ou TypeScript.
Quando o workflow precisa de produto, interface e governança próprias, a CLI deixa de ser o destino final.
Entender arquitetura do SDKEscolher Python ou TypeScriptConfigurar ferramentas e limitesPlanejar hospedagem e isolamentoCrie um agente mínimo que lê arquivos, usa uma ferramenta e retorna saída estruturada.
O entregável “Protótipo com Agent SDK” existe e pode ser verificado por outra pessoa.Território 9 — Segurança, custo e governança
Segredos e arquivos sensíveis
Exclua credenciais do contexto, do log, do Git e das ferramentas que não precisam delas.
Uma chave exposta para o agente continua exposta mesmo que ninguém tenha feito screenshot.
Identificar fontes de segredoBloquear leitura e ediçãoSeparar autenticação de instruçãoRotacionar quando necessárioFaça uma auditoria de arquivos sensíveis e teste um bloqueio real.
O entregável “Mapa de segredos” existe e pode ser verificado por outra pessoa.Sandboxing e isolamento
Escolha entre sandbox de shell, container, VM, web sandbox ou outra fronteira conforme o risco.
Permissão decide o que o agente pede. Isolamento limita o estrago quando algo passa.
Comparar ambientes isoladosSeparar filesystem e redeConfigurar sandboxEntender limitações de plataformaExecute uma tarefa arriscada em ambiente isolado e documente o que ficou inacessível.
O entregável “Ambiente isolado validado” existe e pode ser verificado por outra pessoa.Segurança de MCPs, plugins e supply chain
Avalie origem, atualização, ferramentas expostas e capacidade de agir fora do repositório.
Instalar extensão de agente é executar confiança de terceiros com contexto privilegiado.
Revisar fornecedor e códigoLimitar escopo de ferramentaFixar versão quando necessárioCriar processo de remoçãoFaça uma revisão de ameaça de um MCP ou plugin antes de instalar.
O entregável “Ficha de risco de extensão” existe e pode ser verificado por outra pessoa.Custo por resultado, não por token solto
Compare modelo, effort, contexto e autonomia pelo custo de concluir uma tarefa com qualidade.
Modelo barato que exige cinco correções pode ser a opção mais cara.
Medir custo por tarefaComparar estratégiasDefinir teto de execuçãoSeparar custo local e retorno recorrenteRepita uma tarefa com duas estratégias e calcule custo por resultado aprovado.
O entregável “Benchmark de custo” existe e pode ser verificado por outra pessoa.Analytics, observabilidade e auditoria
Acompanhe adoção, sessões, custo, ferramentas, erros e eventos de segurança.
Sem telemetria, todo rollout parece sucesso até a fatura ou o incidente.
Escolher métricas de usoSeparar atividade e valorMonitorar custo e erroAuditar ações e MCPsCrie um scorecard mínimo para uma pessoa ou time piloto.
O entregável “Scorecard operacional” existe e pode ser verificado por outra pessoa.Adoção em times sem virar faroeste
Defina casos de uso, arquivos compartilhados, políticas, revisão humana, suporte e evolução.
Comprar licença é procurement. Adoção é mudança de sistema de trabalho.
Começar com pilotoPadronizar escopos e configuraçõesDefinir guardrails e exceçõesMedir valor e riscoDesenhe um piloto de quatro semanas para um time pequeno.
O entregável “Plano de adoção” existe e pode ser verificado por outra pessoa.Padrões que mandam projetos para o Cemitério
Reconheça autonomia sem revisão, demo sem workflow, escala sem custo e confiança sem prova.
Os projetos mudam de ferramenta, mas morrem com uma criatividade surpreendentemente baixa.
Identificar falha de problemaDetectar demo sem adoçãoEncontrar custo não modeladoPlanejar prevenção e encerramentoFaça um pré-mortem da sua missão e escolha três formas plausíveis de fracasso.
O entregável “Pré-mortem” existe e pode ser verificado por outra pessoa.Boss final — Ship, attack, measure, prove
Ship: coloque o projeto fora do seu computador
Publique ou entregue uma funcionalidade, melhoria de repositório ou sistema de time para uso real.
Demo local aceita contexto invisível que o mundo real não recebeu.
Executar checklist de entregaDocumentar dependênciasPreparar rollbackValidar com outra pessoa ou ambienteEntregue a missão escolhida para alguém usar ou revisar.
O entregável “Projeto entregue” existe e pode ser verificado por outra pessoa.Attack: tente quebrar antes que outra pessoa tente
Teste entradas inesperadas, segredos, permissões, integrações e decisões assumidas pelo agente.
A melhor revisão não pergunta se ficou elegante. Pergunta como falha e quem sofre.
Testar abuso e erroRevisar acesso excessivoSimular falha externaClassificar risco residualExecute o Red Team Challenge e corrija riscos críticos.
O entregável “Relatório de red team” existe e pode ser verificado por outra pessoa.Measure: prove tempo, custo, qualidade e frequência
Repita a baseline e calcule resultado líquido incluindo consumo, retrabalho e limitações.
Sem antes e depois, toda economia é uma memória otimista.
Repetir a medição inicialCalcular custo por execuçãoProjetar recorrênciaDeclarar amostra e limitaçõesCompare a baseline com a solução em uma tabela auditável.
O entregável “Case de ROI” existe e pode ser verificado por outra pessoa.Prove: monte o Evidence Pack
Organize contexto, decisões, commits, testes, segurança, ROI e post-mortem para avaliação externa.
Certificado diz que você terminou. Evidência mostra o que você consegue fazer.
Criar resumo executivoOrganizar evidências técnicasEscrever post-mortemGerar card compartilhávelGere um pacote que permita avaliar o projeto sem sua apresentação.
O entregável “Claude Code Evidence Pack” existe e pode ser verificado por outra pessoa.