O Claude Code agora pode escrever instantaneamente seu próprio harness, adaptado à tarefa em questão. Essa capacidade é chamada de fluxo de trabalho dinâmico: ele escreve dinamicamente scripts de orquestração, executa dezenas a centenas de subagentes paralelos em uma única sessão e verifica a si mesmo antes que qualquer resultado seja apresentado a você.
O harness padrão do Claude Code é ótimo para escrever código, mas tarefas mais especializadas, como pesquisa, análise de segurança, equipes de agentes e revisões de código, exigiam anteriormente a construção de um harness personalizado sobre o Claude Code para alcançar o desempenho ideal.
Os fluxos de trabalho permitem criar dinamicamente esses harnesses personalizados, que são reutilizáveis, compartilháveis e permitem que o Claude resolva problemas de uma forma mais nativa do que a abordagem padrão.
Neste artigo, compartilharei minhas primeiras experiências e insights sobre o uso de fluxos de trabalho. Observe que os fluxos de trabalho consomem mais tokens e são mais adequados para tarefas complexas e de alto valor.
0. Introdução
A seção de introdução contém notas do Irmão Prática.
Uma ótima leitura; os fluxos de trabalho podem ser a melhor invenção desde as habilidades. Eles são uma versão aprimorada dos objetivos e valem muito a pena aprender. Este artigo explica vários cenários de aplicação para fluxos de trabalho em termos simples.
O autor original é Thariq @trq212, um funcionário central da Anthropic que frequentemente compartilha dicas sobre Claude Code.
O conteúdo é longo; sinta-se à vontade para pular para as seções de interesse. Para ter uma noção direta do que ele pode fazer, veja a Seção 1;
Para entender por que ele é necessário, veja as Seções 3 a 5
; para copiar soluções de implementação diretamente, pule para a Seção 6.
1. Exemplos de Prompts
Estes exemplos demonstram o que os fluxos de trabalho podem fazer. Você pode pedir diretamente ao Claude solicitações semelhantes:
- Ter várias teorias concorrentes tentando reproduzir testes instáveis.
- Minerar correções recorrentes de sessões passadas.
- Localizar causas raiz em canais de incidentes do Slack.
- Obter múltiplas perspectivas de crítica para um plano de negócios.
- Classificar currículos e validá-los.
- Usar uma seleção no estilo de torneio para nomear uma ferramenta de CLI.
- Realizar uma refatoração em toda a base de código.
- Verificar alegações técnicas em um rascunho de blog contra o código real.
2. Como Funcionam os Fluxos de Trabalho
Os fluxos de trabalho executam arquivos JavaScript contendo funções especiais para gerar e coordenar subagentes. Ferramentas JavaScript padrão, como JSON, Math e Array, podem ser usadas para processar dados. Os fluxos de trabalho podem escolher qual modelo os subagentes usam e decidir se eles são executados em uma worktree isolada. Se interrompido, o fluxo de trabalho pode retomar de onde parou.
3. Por que os Fluxos de Trabalho são Necessários
O harness padrão completa o planejamento e a execução dentro de uma única janela de contexto. Isso funciona bem para tarefas de codificação, mas falha para tarefas de longa duração, massivamente paralelas, altamente estruturadas ou adversariais. Especificamente, ele mostra três modos de falha:
- Preguiça do Agente: Diante de tarefas complexas com múltiplas partes, o Claude para prematuramente, terminando apenas uma parte (por exemplo, processando 35 de 50 revisões de segurança).
- Viés de Autopreferência: Quando solicitado a validar ou julgar resultados contra uma rubrica, o Claude tende a favorecer suas próprias conclusões.
- Desvio de Objetivo: A fidelidade é perdida ao longo de múltiplas interações; cada resumo perde detalhes, incluindo requisitos de borda e restrições.
Os fluxos de trabalho combatem isso orquestrando subagentes independentes, cada um com sua própria janela de contexto, objetivo focado e isolamento.
4. Fluxos de Trabalho Dinâmicos vs. Estáticos
Anteriormente, fluxos de trabalho estáticos construídos com o Claude Agent SDK ou claude -p coordenavam múltiplas instâncias do Claude Code de forma genérica, exigindo que você cobrisse todos os casos de borda. Com o Claude Opus 4.8 e fluxos de trabalho dinâmicos, o Claude agora pode escrever harnesses adaptados a cenários específicos.
5. Padrões Práticos para Usar Fluxos de Trabalho
Você pode acionar um fluxo de trabalho solicitando um diretamente ou usando ultracode em seu prompt para garantir que o Claude Code crie um. Os padrões comuns incluem:
- Classificar e Executar: Um agente classificador determina o tipo de tarefa e a roteia para diferentes agentes ou comportamentos; ele também pode classificar a saída após a conclusão.
- Distribuir e Sintetizar: Divida uma tarefa em muitas etapas menores, execute um agente para cada uma e sintetize os resultados. Isso é útil quando muitas etapas se beneficiam de janelas de contexto limpas e sem interferência. A síntese atua como uma barreira, aguardando que todos os agentes terminem antes de mesclar a saída estruturada.
- Validação Adversarial: Para cada agente gerado, execute um agente adversarial separado para validar a saída contra uma rubrica ou critérios.
- Gerar e Filtrar: Gere múltiplas ideias sobre um tópico, filtre-as por rubrica ou validação e mantenha apenas os resultados da mais alta qualidade e verificados após a desduplicação.
- Torneio: Faça com que N agentes compitam na mesma tarefa usando métodos diferentes. Agentes de julgamento em pares determinam os vencedores até que apenas um permaneça.
- Loop até Concluir: Para tarefas com cargas de trabalho desconhecidas, gere agentes continuamente até que uma condição de parada seja atendida (por exemplo, nenhuma nova descoberta, nenhum erro nos logs).
6. Cenários de Aplicação
- Migração e Refatoração: A Bun usou fluxos de trabalho ao reescrever Zig para Rust. Ela divide as tarefas em etapas seriais (locais de chamada, testes com falha, módulos), gera subagentes para cada correção em uma worktree, realiza revisões adversariais e mescla. Evite comandos intensivos em recursos para maximizar o paralelismo.
- Pesquisa Aprofundada: A habilidade
/deep-researchdo Claude Code usa fluxos de trabalho para distribuir pesquisas na web, raspar fontes, verificar alegações adversarialmente e sintetizar um relatório citado. Isso também se aplica a pesquisas não web, como compilar relatórios de status do Slack ou explorar recursos da base de código. - Validação Aprofundada: Para relatórios que exigem citações para cada fato, um fluxo de trabalho pode identificar alegações, fazer com que subagentes verifiquem cada uma e usar um agente verificador para garantir a qualidade da fonte.
- Classificação: Para listas grandes que precisam de medição qualitativa (por exemplo, classificar tickets por gravidade), classificar 1000+ linhas em um prompt reduz a qualidade e explode o contexto. Use torneios, pipelines em pares ou classificação paralela por buckets; cada comparação é seu próprio agente.
- Memória e Seguimento de Regras: Quando o Claude perde regras mesmo em
CLAUDE.md, crie um fluxo de trabalho com um verificador de regras para cada regra. Use uma persona cética para revisar regras e evitar falsos positivos. Por outro lado, mine correções recorrentes de sessões recentes, agrupe-as com agentes paralelos e valide adversarialmente se a regra teria evitado o erro antes de refinarCLAUDE.md.
- Triagem em Grande Escala: Um fluxo de trabalho de triagem classifica itens, desduplica contra registros existentes e toma medidas. Um padrão de 'quarentena' impede que agentes que leem conteúdo não confiável executem ações de alto privilégio, delegando-as a agentes de processamento. Use com
/looppara operação contínua.
- Exploração e Bom Gosto: Útil para decisões de design ou nomenclatura que dependem de 'bom gosto' e se beneficiam de rubricas. Claude explora soluções enquanto um agente de revisão as julga contra uma rubrica. As soluções podem ser classificadas ou selecionadas via torneio.
- Avaliação: Execute avaliações leves gerando agentes independentes em uma worktree e um agente de comparação para pontuar as saídas contra uma rubrica.
- Modelo e Roteamento Inteligente: Crie um agente classificador ajustado à tarefa para decidir qual modelo usar. Por exemplo, explicar um módulo de autenticação depende da contagem de arquivos; um classificador pesquisa isso primeiro e depois roteia para Sonnet ou Opus com base na complexidade.
7. Quando Não Usar Fluxos de Trabalho
Os fluxos de trabalho são novos e não são necessários para todas as tarefas; eles consomem significativamente mais tokens. Use-os criativamente para tarefas além do uso convencional. Para codificação de rotina, considere se o poder computacional extra é necessário; a maioria das codificações não precisa de cinco revisores.
8. Dicas para Construir Fluxos de Trabalho
- Criação de Prompts: Prompts detalhados funcionam melhor. Fluxos de trabalho não são apenas para grandes tarefas; você pode solicitar um fluxo de trabalho rápido para uma revisão adversarial rápida de uma hipótese.
- Combine com /goal e /loop: Para fluxos de trabalho repetíveis, como triagem ou pesquisa, use
/looppara intervalos e/goalpara requisitos de conclusão rigorosos. - Orçamento de Tokens: Defina um orçamento de tokens claro (por exemplo, 10k tokens) no prompt para limitar o uso.
- Salvar e Compartilhar: Pressione 's' no menu do fluxo de trabalho para salvar. Faça check-in em
~/.claude/workflowsou distribua via habilidades. Referencie arquivos JavaScript de fluxo de trabalho emSKILL.md. Para flexibilidade, solicite ao Claude que trate os fluxos de trabalho de habilidades como modelos, em vez de scripts literais.
9. Um Novo Ponto de Partida
Os fluxos de trabalho fornecem uma maneira nova e poderosa de estender o Claude Code. Veja isso como um ponto de partida para explorar novos métodos de concluir tarefas com o Claude. Há muito mais a descobrir sobre como usá-lo da melhor forma.
