convez.ai
SkillAutomaçãoAvançado
costrict-plugins-repo

Workflow Builder para Claude Code

costrict-plugins-repo/alirezarezvani-claude-code-skills-workflow-builder

Crie workflows multi-agente escaláveis com controle determinístico

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para projetar e gerar scripts de workflow multi-agente determinísticos em JavaScript, otimizando consumo de tokens através de sub-agentes em contextos isolados. Inclui motor de recomendação de topologia, validador de workflows, scaffolder de templates e referências completas de padrões de orquestração.

Instalação

$npx convez-ai costrict-plugins-repo/alirezarezvani-claude-code-skills-workflow-builder

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
37%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Triagem automatizada de PRs e code review em pipeline
  • Processamento em paralelo de múltiplas tarefas (fan-out)
  • Loops controlados de processamento em lote
  • Orquestração de decisões com judge panels

Veredito

Skill robusto e bem documentado para quem precisa orquestrar workflows complexos no Claude Code. A intake-first rule e validação automática reduzem erros, mas exige compreensão sólida de padrões de concorrência e controle de fluxo.

README

A tradução para o português deste README ainda está na fila.

workflow-builder

Design and write deterministic multi-agent workflow scripts for Claude Code's Workflow tool — .js files in .claude/workflows/ that fan work out to fresh-context sub-agents under plain JavaScript control flow. Only leaf agent() calls spend tokens, so the main session stays clean and the run is resumable.

Targets the Workflow tool introduced in Claude Code v2.1.147 (gated behind CLAUDE_CODE_WORKFLOWS=1, browsable via /workflows).

The intake-first rule

Every workflow-creation session opens with an intake question set (what task, what unit of work, known list vs. loop, barrier vs. pipeline, structured output, depth). When the user is vague, the skill does not stall or interrogate in a loop — it runs a deterministic recommendation engine that infers a topology and presents it with the reasoning ("here's what I'd build and why"), then confirms before writing any file.

What's in the box

ComponentWhereWhat it does
Intake recommendation engineskills/workflow-builder/scripts/workflow_intake.pyClassifies a (vague) task → recommended topology + runner-up + per-stage model plan + budget guard + a one-line rationale per choice.
Workflow validatorskills/workflow-builder/scripts/validate_workflow.pyStdlib linter for .js workflows: pure-literal meta, no Date.now()/Math.random()/argless new Date(), no FS/Node APIs in the orchestrator, parallel() thunks, guarded loops, filter(Boolean), size cap. PASS / WARN / FAIL with line numbers.
Scaffolderskills/workflow-builder/scripts/scaffold_workflow.pyEmits a runnable starter for any of 5 topologies (fan-out, pipeline, barrier, loop, judge-panel).
3 referencesskills/workflow-builder/references/API reference · orchestration patterns · decision + intake guide (7-8 sources each).
Templates + exampleskills/workflow-builder/assets/Fan-out / pipeline / loop starters + a complete PR-triage workflow.
Persona agentagents/cs-workflow-architect.mdDesign-first interrogator that refuses to write before the topology is confirmed.
Slash commandcommands/cs-workflow-build.md/cs:workflow-build <task> — runs the full intake → scaffold → validate flow.

Quick start

cd skills/workflow-builder

# 1. Turn a vague request into a concrete proposal
python scripts/workflow_intake.py --task "review my open PRs for bugs"

# 2. Scaffold the confirmed topology
python scripts/scaffold_workflow.py --topology pipeline --name pr-triage \
  --description "Triage open PRs" > /tmp/pr-triage.js

# 3. Validate before running
python scripts/validate_workflow.py /tmp/pr-triage.js

All three tools run with --sample (no args) and --help.

Running the workflows it writes

export CLAUDE_CODE_WORKFLOWS=1          # the feature is off by default
# save the .js under .claude/workflows/ , then launch + watch via /workflows
# P = pause/resume , X = skip a sub-agent ; failed agents retry automatically

Attribution

Conceptually inspired by Ray Amjad's claude-code-workflow-creator. All content here was written for this repo against Claude Code's publicly-documented Workflow tool API; no text was copied verbatim.

License

MIT.

Ver o original no GitHub

Bom para

Relacionados