Experimento 001 Mapeamento de processos Skill de código aberto para o Claude Code fichas rodando

Não desenha no chute. Prova.

Você conta como o trabalho anda. O Senku conduz a entrevista, escreve a carta do processo, solta fichas por todos os caminhos, simula 4.000 casos e entrega o fluxograma BPMN 2.0 e o mapeamento completo, prontos para o dono aprovar.

relato + perguntas
+ fichas + 4.000 casos
= processo provado python senku.py validar → ✓ Nenhum problema.
01 · O método

Observa. Registra. Testa. Só então afirma.

Mapa de processo costuma errar de dois jeitos: desenhado sem perguntar o que acontece no “Não”, e documentado sem medir nem aprovar. O Senku trabalha como cientista para não errar de nenhum dos dois.

I

Observa.

a entrevista

Sete blocos de perguntas, na ordem em que um bom analista pergunta: abertura, SIPOC, passos, decisões, tempos, gestão e TO-BE. Ele não espera o relato perfeito: pergunta só o que muda o mapa.

II

Registra.

a carta do processo

Tudo vai para um arquivo só, o carta.json. Passo, responsável, sistema, regra e tempo vêm de você. O que ele deduz vira pergunta; o que ninguém respondeu vira lacuna, com prioridade, e o documento sai como rascunho.

III

Testa.

fichas e simulação

Fichas percorrem todos os caminhos atrás de decisão sem saída, paralelo que nunca se junta e laço sem fim. São 73 verificações, das regras 7PMG ao BPMN Method and Style. Depois, 4.000 casos simulados medem tempo, carga e retrabalho.

IV

Afirma.

o mapa aprovado

Fluxograma em raias e mapeamento completo saem da carta, sem retoque à mão. O aprovar registra quem aceitou, quando e um hash por seção. Mudou depois? O situacao avisa e o comparar mostra o quê.

02 · Os elementos

A tabela periódica do processo.

Todo processo é feito dos mesmos elementos. Quase todos são um campo da carta do Senku; os três últimos são a prova que ele faz em cima dela. Toque num elemento.

03 · O experimento

Solte as fichas. Quebre o fluxo.

É assim que o BPMN define a execução: uma ficha entra no início e anda pelas setas. Na decisão, segue um caminho; no paralelo, se divide; na junção, espera as outras. Se alguma fica presa, o mapa está errado, e o Senku avisa antes de você mostrar ao dono.

Hipótese

O processo de compras SUP-01 sempre chega ao fim, por qualquer caminho.

Método

Fichas pelas 22 setas do fluxograma real, com os percentuais da entrevista: 85% aprovado, 92% conforme.

Controle

Apague a saída de “Corrigir requisição” e veja o que o validar diz.

exemplos/compras/carta.json
chegaram ao fim 0presas 0
04 · A medição

4.000 casos. Zero no prazo.

Com os tempos e percentuais da entrevista, o Senku simula caso a caso, com retrabalho e paralelo. No exemplo de compras, o prazo combinado é de 10 dias úteis. Nenhum caso simulado cabe nele.

Do pedido à entrega

SUP-01 · 4.000 casos simulados · dias úteis

O que o mapa mostra

python senku.py analisar

Cada ponto é um caso.

Os tempos são estimativas da entrevista, não medição. O próprio Senku avisa: confirme antes de usar em decisão.

05 · O que sai do laboratório

Um comando. Nove formatos.

Tudo abaixo saiu de python senku.py documentar no exemplo de compras: 6 áreas, 14 atividades, 2 decisões, retrabalho, fornecedor externo e trabalho em paralelo. Nenhum retoque à mão.

abra o exemplo inteiro → markdown · word · bpmn · planilha · a carta que gerou tudo

Memory Card: o processo aprovado vira um save.

Como o cartão de memória de um videogame: depois do aceite, cada processo é salvo num repositório seu no GitHub, privado por padrão, com fluxograma, mapeamento, carta, versão e o motivo de cada mudança. Antes de mapear um processo novo, ele procura no cartão. Só grava com o seu “sim”.

06 · Resultados

Conferido em teste, não prometido.

214testes automatizados passando, no Windows e no Linux
73verificações de boa modelagem: 7PMG, BPMN Method and Style, tempos, RACI, prazos
4.000casos simulados a cada análise
5modeladores de onde o .bpmn pode vir: Bizagi, bpmn.io, Camunda 7 e 8, ARIS, Signavio
simida e volta BPMN (exportar, abrir, importar) sem mudar o fluxo, conferida nos testes
0dependências: só a biblioteca padrão do Python 3.8+

Referências

  1. Mendling, J.; Reijers, H. A.; van der Aalst, W. M. P. Seven Process Modeling Guidelines (7PMG), 2010.
  2. Silver, B. BPMN Method and Style: as regras de estilo do desenho.
  3. ABPMP. BPM CBOK (SIPOC e RACI). Lean: os oito desperdícios.
07 · Instalar

Um comando. Nada de pip.

Você precisa de Python 3.8 ou mais novo e do Claude Code. Só a biblioteca padrão do Python.

Testado no Windows e no Linux; Python puro, deve rodar no macOS, mas não é testado lá
Seus mapeamentos ficam fora do repositório, na sua máquina
Conferir a instalação: python senku.py status
1 · instale para todos os projetos
2 · peça ao Claude
quero mapear o processo de reembolso de despesas
3 · ou rode o exemplo, na pasta da skill
08 · Margem de erro

O que o Senku não faz.

Não inventa o processo.Passo, responsável, sistema, regra, tempo e percentual vêm de você. O que faltar sai como lacuna, e o documento sai como rascunho.
Tempo da entrevista não é medição.A simulação mostra o efeito do que foi dito. Confirme com dados do sistema antes de decidir.
Não substitui o dono.O mapa só vira oficial com o aceite de quem responde pelo resultado.
Não é modelador visual.Para arrastar caixas, exporte o .bpmn ou o .drawio, edite no seu modelador e importe de volta.
Não publica seus dados.Os mapeamentos ficam fora do repositório, e o Memory Card só grava com o seu “sim”, num repositório seu.
Precisa do Claude Code.A skill é de código aberto; o uso do Claude segue o seu plano.
0%
rastreável. cada passo com origem, cada número com fonte.

Qual processo você vai levar ao laboratório primeiro?