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 se verifica 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, antes exigiam 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 percepções 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; fluxos de trabalho podem ser a melhor invenção desde as skills. Eles são uma versão aprimorada dos objetivos e valem muito a pena serem aprendidos. 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; fique à vontade para pular para as seções de interesse. Para ter uma ideia direta do que ele pode fazer, veja a Seção 1;
Para entender por que é necessário, veja as Seções 3 a 5
; para copiar soluções de implementação diretamente, vá 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:
- Fazer várias teorias concorrentes tentarem reproduzir testes instáveis.
- Mineração de 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 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 conclui 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, maciçamente paralelas, altamente estruturadas ou adversarial. Especificamente, mostra três modos de falha:
- Preguiça do Agente: Diante de tarefas complexas com múltiplas partes, 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 com base em uma rubrica, 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 várias 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.
- Fan-out e Sintetizar: Dividir uma tarefa em muitas etapas menores, executar um agente para cada uma e sintetizar 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 todos os agentes terminarem antes de mesclar a saída estruturada.
- Validação Adversarial: Para cada agente gerado, execute um agente adversarial separado para validar a saída com base em uma rubrica ou critérios.
- Gerar e Filtrar: Gerar múltiplas ideias sobre um tópico, filtrá-las por rubrica ou validação, e manter apenas os resultados da mais alta qualidade e verificados após a deduplicação.
- Torneio: Fazer N agentes competirem na mesma tarefa usando métodos diferentes. Agentes de julgamento aos pares determinam os vencedores até que apenas um reste.
- Loop até Concluir: Para tarefas com cargas de trabalho desconhecidas, gerar 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: O Bun usou fluxos de trabalho ao reescrever Zig para Rust. Ele 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 adversarial e mescla. Evite comandos que consomem muitos recursos para maximizar o paralelismo.
- Pesquisa Aprofundada: A skill
/deep-researchdo Claude Code usa fluxos de trabalho para fazer fan-out de pesquisas na web, raspar fontes, verificar adversarial alegações e sintetizar um relatório com citações. Isso também se aplica a pesquisas não web, como compilar relatórios de status do Slack ou explorar recursos de 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 severidade), classificar 1000+ linhas em um prompt reduz a qualidade e explode o contexto. Use torneios, pipelines aos pares ou classificação paralela em buckets; cada comparação é seu próprio agente.
- Memória e Seguimento de Regras: Quando 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, minere correções recorrentes de sessões recentes, agrupe-as com agentes paralelos e valide adversarial se a regra teria evitado o erro antes de refinarCLAUDE.md.
- Triagem em Grande Escala: Um fluxo de trabalho de triagem classifica itens, deduplica contra registros existentes e toma ação. 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 Gosto: Útil para decisões de design ou nomenclatura que dependem de 'gosto' e se beneficiam de rubricas. Claude explora soluções enquanto um agente de revisão as julga com base em 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 saídas com base em 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, 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 rotineira, considere se o poder de computação extra é necessário; a maioria das codificações não precisa de cinco revisores.
8. Dicas para Construir Fluxos de Trabalho
- Formulação de Prompts: Prompts detalhados funcionam melhor. Fluxos de trabalho não são apenas para tarefas grandes; 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 rígidos de conclusão. - 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 de fluxo de trabalho para salvar. Coloque-os em
~/.claude/workflowsou distribua via skills. Referencie arquivos JavaScript de fluxo de trabalho emSKILL.md. Para flexibilidade, solicite ao Claude que trate os fluxos de trabalho das skills como modelos em vez de scripts literais.
9. Um Novo Ponto de Partida
Os fluxos de trabalho fornecem uma maneira poderosa e nova de estender o Claude Code. Veja isso como um ponto de partida para explorar novos métodos de conclusão de tarefas com o Claude. Há muito mais a descobrir sobre como usá-lo da melhor forma.
