dynamic-workflows
synapticcodes/dynamic-workflows
Padroes de dynamic workflows (fan-out, adversarial verify, tournament, loop-until-done, classify-and-act...) empacotados como skills reutilizaveis para Claude Code. 6 padroes base + 3 composicoes + roteador dynamic-help.
Instalação
npx convez-ai synapticcodes/dynamic-workflows1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
dynamic-workflows
Plugin de padroes de dynamic workflows do Claude Code, derivado do artigo "A harness for every task: dynamic workflows in Claude Code" (Thariq Shihipar & Sid Bidasaria).
Cada padrao vira uma skill com duas partes:
SKILL.md— o conhecimento: quando usar o padrao, como prompptar os subagentes, qual rubric/criterio aplicar, armadilhas.workflow.js— um template de orquestracao parametrizavel. Nao e para rodar verbatim: o Claude o adapta ao caso, ajustando prompts, schemas e parametros viaargs.
Por onde comecar
Nao sabe qual usar? Rode /dynamic-help <descreva sua tarefa> — ele le o contexto, recomenda o padrao (ou a composicao) e oferece lancar. E uma skill de instrucao (nao gasta agentes).
Skills incluidas (padroes base)
| Slash command | Padrao | Para que serve |
|---|---|---|
/classify-and-act | Classify-and-act | Classificar a entrada e rotear para agentes/acoes diferentes |
/fanout-and-synthesize | Fan-out-and-synthesize | Quebrar em N partes paralelas e sintetizar num resultado |
/adversarial-verification | Adversarial verification | Para cada achado, um agente verificador tenta refuta-lo contra um rubric |
/generate-and-filter | Generate-and-filter | Gerar muitas ideias, deduplicar e filtrar por rubric |
/tournament | Tournament | N tentativas competem; juiz par-a-par ate sobrar 1 vencedor |
/loop-until-done | Loop until done | Repetir spawn de agentes ate uma condicao de parada (loop-until-dry) |
Skills de aplicacao (composicoes)
Estas compoem os padroes base e embutem conhecimento de dominio:
| Slash command | Compoe | Para que serve |
|---|---|---|
/root-cause | generate-and-filter + adversarial-verification | Investigar causa-raiz: hipoteses de evidencias disjuntas, testadas por painel |
/triage | classify-and-act + dedupe + quarentena | Processar fila/backlog em escala, com seguranca anti-injection |
/deep-verification | fanout (extrair) + adversarial-verification + verificador-da-fonte | Fontear cada claim de um documento antes de publicar |
sort-at-scale (ordenar listas grandes) nao e uma skill separada: e um preset do /tournament (mode:"rank", bucket-rank + merge), porque seria so o mesmo motor de julgamento em modo ordenacao.
API de dynamic workflows (referencia rapida)
Um workflow e um arquivo .js executado por um runtime isolado. Comeca com um bloco meta (literal puro) e usa primitivas:
agent(prompt, opts?)— roda um subagente. Sem opts retorna o texto final.schema: JSON Schema -> forca saida estruturada validada (retry on mismatch). Use sempre que uma etapa seguinte consumir o resultado.label: nome no painel/workflows.phase: agrupa o agente numa fase de progresso (use dentro deparallel/pipeline).model: sobrescreve o modelo so para esta chamada (ex.: rotear etapa barata para um modelo menor).agentType: tipo de subagente customizado (ex.:"general-purpose").isolation: "worktree": roda em worktree git proprio (so quando agentes escrevem arquivos em paralelo e conflitariam).
parallel(thunks)— barreira: espera todos. Thunks sao() => agent(...). Falha viranull, sempre.filter(Boolean). Concorrencia ~= nucleos da maquina (cap 16); excedente fila.pipeline(items, ...stages)— sem barreira: cada item flui pelos estagios independentemente. Stage recebe(prevResult, originalItem, index). Default: prefira pipeline; use barreira so quando um estagio precisa de TODOS os resultados anteriores de uma vez.workflow(nameOrRef, args?)— compoe outro workflow inline (1 nivel de profundidade).phase(title)inicia grupo de progresso;log(msg)emite linha de narracao.args— JSON passado no lancamento (undefinedse omitido).budget— alvo de tokens (budget.total;nullquando lancado sem alvo).
Restricoes do runtime (importante)
Date.now(),Math.random()enew Date()sem argumento lancam erro (quebram o journaling/resume). Para tempo, passe viaargs; para variedade, varie prompt/label por indice.- O script nao acessa filesystem nem shell diretamente — quem le/escreve/roda comandos sao os agentes.
- Limites: ate 16 agentes concorrentes; 1000 agentes por run.
Como usar
ultracode:no prompt (ou "use um workflow") para o Claude escrever a orquestracao na hora — use estas skills como referencia de padrao.- Ou peca explicitamente:
/fanout-and-synthesize <tarefa>. - Combine com
/loop(rodar em intervalos) e/goal(criterio de conclusao). Defina orcamento: "use 10k tokens". - Gostou de um run? No
/workflows, teclassalva o script em.claude/workflows/.
Fontes
- https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code
- https://code.claude.com/docs/en/workflows
Instalacao
Opcao A — local (para testar / uso interno)
# 1. registre este diretorio como marketplace
/plugin marketplace add /caminho/para/dynamic-workflows/workflows-plugin
# 2. instale o plugin
/plugin install dynamic-workflows@dynamic-workflows-marketplace
Opcao B — via GitHub (recomendado para distribuir)
/plugin marketplace add synapticcodes/dynamic-workflows
/plugin install dynamic-workflows@dynamic-workflows-marketplace
Depois de instalar, reinicie a sessao para o plugin carregar completamente.
Atualizacao
Edite os arquivos em workflows-plugin/, atualize a version no .claude-plugin/plugin.json e no .claude-plugin/marketplace.json, faca o export do conteudo da pasta workflows-plugin/ para o repo GitHub (branch main) e rode:
/plugin marketplace update dynamic-workflows-marketplace