Claude Workflow
jl-cmd/claude-workflow
Enforce multi-step workflows bloqueando conclusão prematura
Ver no GitHubPlugin de execução de fluxos de trabalho para Claude Code que bloqueia a conclusão de sessões até que todas as etapas definidas sejam marcadas como concluídas. Implementa um hook Stop que verifica o estado de progresso antes de permitir o encerramento da sessão.
Instalação
npx convez-ai jl-cmd/claude-workflow1 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
Casos de uso
- Garantir execução sequencial de tarefas em multi-etapas
- Prevenir saída acidental antes de completar todos os passos
- Rastrear progresso de skills complexos com dependências
Veredito

Ferramenta bem-estruturada para enforçar disciplina em workflows multi-etapas do Claude Code. Implementação simples e robusta com fallbacks seguros; ideal para skills que exigem sequência rigorosa de etapas.
README
A tradução para o português deste README ainda está na fila.
claude-workflow
Workflow enforcement for Claude Code skills. A Stop hook blocks session completion until all defined workflow steps are marked done.
Installation
- Add the marketplace:
/plugin marketplace add jl-cmd/claude-workflow
- Install the plugin:
/plugin install claude-workflow@jl-cmd-claude-workflow
How It Works
- A skill defines steps and writes them to a workflow state file at
~/.claude/runtime/workflow-state.json. - Each step updates the state file's
completedarray as it finishes. - The Stop hook (
hooks/verify-completion.py) runs when a session tries to end. If any steps remain incomplete, it blocks completion with a message listing what is left.
State File Format
{
"workflow": "my-workflow",
"steps": ["step-a", "step-b", "step-c"],
"completed": ["step-a"]
}
workflow-- name shown in the blocking messagesteps-- all steps that must completecompleted-- steps finished so far
Usage
Try the built-in demo:
/workflow-demo
This runs a 3-step workflow. Try ending the session before all steps finish -- the hook will block you.
Adding Enforcement to Your Own Skills
- In your SKILL.md frontmatter, reference the hook:
---
name: my-skill
hooks:
- type: Stop
script: hooks/verify-completion.py
---
- In your skill's first step, write the state file:
import json, os
state_path = os.path.expanduser("~/.claude/runtime/workflow-state.json")
os.makedirs(os.path.dirname(state_path), exist_ok=True)
state = {
"workflow": "my-skill",
"steps": ["step-1", "step-2", "step-3"],
"completed": [],
}
with open(state_path, "w") as f:
json.dump(state, f, indent=2)
- After each step completes, append to the
completedarray:
import json
state_path = os.path.expanduser("~/.claude/runtime/workflow-state.json")
with open(state_path) as f:
state = json.load(f)
state["completed"].append("step-1")
with open(state_path, "w") as f:
json.dump(state, f, indent=2)
- Once all steps are in
completed, the Stop hook allows the session to end normally.
Safety
- If the state file does not exist or is malformed, the hook allows completion (never crashes).
- If the hook input contains
stop_hook_active: true, it exits immediately to prevent infinite loops. - The state file path can be overridden via the
CLAUDE_WORKFLOW_STATE_PATHenvironment variable (used in tests).
License
MIT