LegalWorkflow

CLI que transforma os processos do seu escritório de advocacia em workflows de agentes de IA com checkpoints de aprovação humana — sem exigir conhecimento técnico de IA.

O init cria a estrutura do projeto do escritório. Depois, dentro do Claude Code, o comando /legalworkflow conduz uma conversa sobre o processo que você quer automatizar ("elaboração de contratos", "contestação de reclamação trabalhista", "análise de contratos recebidos"...), propõe o workflow completo (agentes, prompts, checkpoints), você ajusta o que quiser no próprio chat e os arquivos são criados no projeto. Repita o /legalworkflow para criar quantos workflows quiser no mesmo projeto.

A IA nunca decide sozinha. Todo workflow tem ao menos um checkpoint em que um humano (advogado, sócio, revisor) aprova, rejeita ou pede ajustes antes de o fluxo continuar.

Requisitos

• Node.js 18 ou superior — https://nodejs.org

• Claude Code instalado e autenticado — os agentes rodam sobre o Claude Agent SDK:

  npm install -g @anthropic-ai/claude-code
  claude   # faça login na primeira vez

Para conferir se está tudo pronto: npx legalworkflow doctor.

Começando

1. Crie o projeto

npx legalworkflow init

O assistente pergunta o idioma do conteúdo gerado (português ou inglês), o seu nome, o nome do escritório e informações livres sobre ele (você pode colar um texto, links do site, Instagram, blog...). A estrutura do projeto é criada na hora — ainda sem workflows.

2. Crie seus workflows com o Claude

cd meu-escritorio
claude

Dentro do Claude Code, digite:

/legalworkflow

O Claude entrevista você sobre o processo a automatizar, pergunta sobre bases de conhecimento (petições-modelo, teses, jurisprudências...), propõe o workflow completo — agentes com responsabilidades, checkpoints com critérios — e você ajusta tudo no próprio chat. Com a sua aprovação, os arquivos são criados e validados. Rode /legalworkflow de novo sempre que quiser adicionar outro workflow ao projeto.

Todo projeto inclui também um agente fixo de segurança (verificador-seguranca), que roda antes de qualquer workflow para detectar prompt injection nos documentos de entrada — os trechos maliciosos são listados e ignorados pelos demais agentes.

Executando um workflow

Coloque o documento do caso (ex.: a petição inicial) em input/, como .txt ou .md, e rode:

npx legalworkflow run nome-do-workflow

Quando o comando pedir a descrição do caso, cite o caminho do arquivo (ex.: "Analise a petição em input/inicial.txt").

Os agentes executam em sequência, cada um recebendo a saída do anterior. Ao chegar em um checkpoint, a execução pausa e mostra a saída produzida com os critérios de aprovação. Você pode:

• Aprovar — o fluxo continua;
• Rejeitar com instruções — o agente anterior refaz o trabalho considerando seu feedback;
• Sair — a execução fica salva; retome quando quiser com --resume:

npx legalworkflow run nome-do-workflow --resume

Todos os resultados (incluindo as saídas intermediárias de cada agente) ficam em output/, em uma pasta datada por execução.

Comandos

| Comando | O que faz | | --- | --- | | npx legalworkflow init | Criar a estrutura de um novo projeto | | /legalworkflow (no Claude Code) | Criar um workflow no projeto, por entrevista guiada | | npx legalworkflow add-workflow <json> | Adicionar um workflow a partir de uma proposta em JSON (usado pelo /legalworkflow) | | npx legalworkflow run <workflow> | Executar um workflow (--resume retoma uma execução pausada) | | npx legalworkflow agents | Listar os agentes do projeto | | npx legalworkflow workflows | Listar os workflows do projeto | | npx legalworkflow validate | Validar a estrutura do projeto | | npx legalworkflow config | Alterar dados do escritório e bases de conhecimento | | npx legalworkflow doctor | Diagnosticar problemas na instalação |

Estrutura do projeto gerado

meu-escritorio/
├── .claude/
│   ├── commands/
│   │   └── legalworkflow.md      # o comando /legalworkflow do Claude Code
│   └── skills/
│       └── identidade-visual/
│           └── SKILL.md           # aplica a identidade visual (identity/) aos documentos finais
├── agents/            # um diretório por agente
│   ├── verificador-seguranca/  # agente fixo anti prompt injection
│   └── redator/
│       ├── agent.md       # prompt do agente (edite livremente)
│       └── config.json    # modelo, temperatura, ferramentas
├── workflows/
│   ├── meu-workflow.yaml  # definição do workflow (etapas + checkpoints)
│   └── meu-workflow.mmd   # diagrama Mermaid (visualize em mermaid.live)
├── prompts/           # prompts compartilhados entre agentes
├── knowledge/         # bases de conhecimento permanentes do escritório
├── identity/          # regras de identidade visual do escritório (.skill, logomarca, manual de marca)
├── input/             # documentos da execução atual (petição do caso etc.)
├── output/            # resultados de cada execução
└── config/settings.json   # dados do escritório e bases de conhecimento

Os prompts em agents/*/agent.md são texto simples em Markdown — refine-os com o vocabulário e as teses do seu escritório. Materiais colocados em knowledge/ ficam disponíveis para os agentes que têm ferramentas de leitura. Coloque em identity/ os arquivos .skill (ou logomarca/manual de marca) com a identidade visual do escritório — a skill identidade-visual os aplica automaticamente ao redigir documentos finais.

Exemplo

O diretório examples/escritorio-demo contém um projeto pronto com o workflow Produção de Petição Inicial (pesquisador → redator → checkpoint do advogado), útil para conhecer a estrutura sem passar pelo init.

Problemas?

npx legalworkflow doctor

O diagnóstico verifica a versão do Node.js, a presença do Claude Code no PATH, se o diretório atual é um projeto LegalWorkflow e a permissão de escrita em output/ — e sugere a correção para cada item que falhar.

Licença

MIT