convez.ai
Skill
synapticcodes

dynamic-workflows

synapticcodes/dynamic-workflows

Ver no GitHub
InicialPluginScore · de 0 a 100

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-workflows

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 via args.

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 commandPadraoPara que serve
/classify-and-actClassify-and-actClassificar a entrada e rotear para agentes/acoes diferentes
/fanout-and-synthesizeFan-out-and-synthesizeQuebrar em N partes paralelas e sintetizar num resultado
/adversarial-verificationAdversarial verificationPara cada achado, um agente verificador tenta refuta-lo contra um rubric
/generate-and-filterGenerate-and-filterGerar muitas ideias, deduplicar e filtrar por rubric
/tournamentTournamentN tentativas competem; juiz par-a-par ate sobrar 1 vencedor
/loop-until-doneLoop until doneRepetir 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 commandCompoePara que serve
/root-causegenerate-and-filter + adversarial-verificationInvestigar causa-raiz: hipoteses de evidencias disjuntas, testadas por painel
/triageclassify-and-act + dedupe + quarentenaProcessar fila/backlog em escala, com seguranca anti-injection
/deep-verificationfanout (extrair) + adversarial-verification + verificador-da-fonteFontear 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 de parallel/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 vira null, 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 (undefined se omitido).
  • budget — alvo de tokens (budget.total; null quando lancado sem alvo).

Restricoes do runtime (importante)

  • Date.now(), Math.random() e new Date() sem argumento lancam erro (quebram o journaling/resume). Para tempo, passe via args; 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

  1. ultracode: no prompt (ou "use um workflow") para o Claude escrever a orquestracao na hora — use estas skills como referencia de padrao.
  2. Ou peca explicitamente: /fanout-and-synthesize <tarefa>.
  3. Combine com /loop (rodar em intervalos) e /goal (criterio de conclusao). Defina orcamento: "use 10k tokens".
  4. Gostou de um run? No /workflows, tecla s salva o script em .claude/workflows/.

Fontes

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
Ver o original no GitHub

Bom para

Relacionados