Como usar o Trilha

O Trilha desenha processos em raias: cada coluna é um ator (uma pessoa, área ou sistema) e cada cartão é um passo. Em cada passo ficam as regras de negócio, as entidades (tabelas, serviços, documentos), as mudanças de estado e as dúvidas. Ele serve para levantar, discutir e validar um processo antes de construir o sistema.

DesenharAtores, passos e setas, com decisões e caminhos alternativos.

DetalharRegras com a origem (cartão, escopo, sistema atual, proposta), entidades e estados.

ValidarMarcar cada passo como confirmado, a ajustar ou com dúvida, e exportar as anotações.

ContarCenários percorrem o fluxo com um caso real, etapa por etapa.

Primeiros passos

Crie um fluxo. Na lista da esquerda, clique em + novo fluxo…, digite o nome e tecle Enter. Ele já vem com três colunas: Solicitante, Responsável e Sistema.
Ajuste as colunas. Dê duplo clique no nome de uma coluna para renomear. Use + ator, no fim das colunas, para incluir outra. Passe o mouse sobre o cabeçalho para mover (← →) ou remover (×).
Crie os passos. Clique numa célula vazia (aparece um +), escreva o título e tecle Enter. Se o passo ficar abaixo de todos os outros, ele já sai ligado ao anterior.
Ligue os passos. Clique num passo para abrir o painel e use + adicionar caminho…, ou "ligar clicando no destino" e clique no passo de chegada.
Detalhe. No painel do passo, inclua regras, entidades, mudanças de estado e dúvidas. Toda lista termina com + adicionar….
Valide. Com o processo montado, revise cada passo com quem conhece o assunto e marque ✓ Confirmado, ✎ Ajustar ou ? Dúvida.

Quer ver um fluxo completo? Abra o exemplo "Pedido de reembolso". Se ele tiver sido alterado ou apagado, use "Restaurar fluxo de exemplo", no rodapé da lista.

Como editar

Não existe um modo de edição: tudo é alterado no próprio lugar onde aparece.

Para…	Faça
Editar um texto (nome, título, descrição, número, coluna, categoria…)	Duplo clique no texto. `Enter` salva, `Esc` cancela e clicar fora também salva. Em textos longos, `Ctrl`/`⌘` + `Enter` salva.
Preencher um campo vazio	Clique em + adicionar descrição… (ou similar).
Incluir um item numa lista	Clique em + adicionar…, no fim da lista. Depois de salvar com `Enter`, a linha reabre para o próximo item.
Alterar um item de lista	Duplo clique no item; ele vira uma linha editável.
Remover um item	Passe o mouse e clique no ×.
Mover um passo	Arraste para outra célula. Soltar sobre outro passo abre uma linha nova ali.
Trocar tipo, coluna ou linha de um passo	No topo do painel do passo, dê duplo clique em "Secretaria · Passo · linha 3".
Desfazer	Botão Desfazer ou `Ctrl`/`⌘` + `Z`.
Arrumar a numeração	Botão Renumerar: numera os passos pela posição (1, 2, 3, e "3a" para o alternativo da mesma linha).

O passo

Tipos

1Envia o pedidopasso: uma ação comum

2Pedido está correto?decisão: o fluxo se divide

2aCorrige e reenviaalternativo: exceção ou desvio

4Recebe o avisofim: encerra o fluxo

O que fica em cada passo

Título (verbo + objeto: "Avalia o pedido"), subtítulo e observação, que aparecem no cartão, e uma descrição mais longa no painel.
Regras de negócio, cada uma com um tipo de origem: Cartão veio de um cartão ou história de usuário (ex.: US-001) · Escopo documento de escopo · Atual como funciona hoje · Análise achado técnico · Proposta sugestão a validar · Pendente decisão em aberto.
Entidades e serviços, com a operação: criaalteralêenvia.
Mudanças de estado, no formato "Pedido: Enviado → Aprovado".
Dúvidas relacionadas, como códigos ("D-01") ou textos curtos.
Validação: confirmado, a ajustar ou dúvida, com uma anotação livre. Na tela, o cartão ganha uma barra colorida.

Ligações

principal: o caminho normal alternativa: uma exceção opcional: pode acontecer a qualquer momento retorno: volta a um passo anterior

O rótulo é o texto curto na seta ("sim", "não", "pagou"). A descrição aparece em "Caminhos a partir daqui", no painel do passo.
Um retorno que poluiria o desenho pode ficar só no detalhe: desmarque "desenhar a seta".
Também dá para criar a ligação pelo passo de chegada, em Vem de → + adicionar origem….

Abas

Regras: Todas as regras do fluxo, agrupadas por passo, com filtro pelo tipo de origem. Cada grupo tem o seu + adicionar regra….
Entidades: Todas as tabelas e serviços citados, com a categoria (duplo clique para editar) e os passos que usam cada um. Renomear uma entidade aqui atualiza todos os passos.
Estados: Ciclos de vida das entidades principais (ex.: Pedido: Enviado → Aprovado → Pago). Os estados finais aparecem com borda vermelha.
Cenários: Casos concretos que percorrem o fluxo. Veja a próxima seção.
Anotações: O resumo da validação, passo a passo, com cópia ou download em Markdown para levar a um cartão ou documento.

Cenários

Um cenário conta o fluxo com um exemplo real, como "Ana pede reembolso de R$ 250". Ele tem:

etapas, cada uma ligada a um passo, com a narrativa do que acontece;
uma tabela (ex.: pessoas e situação) e marcadores (ex.: camas e estado), que mudam a cada etapa;
um resumo (ex.: "Pedido: Aprovado").

Na aba Cenários, Editar abre o editor:

Estado inicial: defina as colunas, as linhas, os marcadores e as cores de cada estado.
Cada etapa: dê duplo clique numa célula ou num marcador para mudar o valor naquela etapa. O que mudou fica destacado, com ↺ para voltar ao valor herdado.
Ver no fluxo abre o diagrama com o cenário passo a passo, a partir da etapa escolhida.

Importar e exportar

Exportar (no fluxo aberto): Baixa um arquivo .fluxo.json só com aquele fluxo.
Exportar tudo (no topo): Abre a lista de fluxos para você marcar quais vão no arquivo.
Importar JSON: Escolha um arquivo ou cole o conteúdo. Se o fluxo já existir, o sistema pergunta se deve substituir ou importar como cópia.
Exportar imagem (barra do diagrama): PNG ou SVG, tema claro ou escuro, com ou sem título, legenda e marcações de validação. "Copiar PNG" permite colar a imagem direto num cartão do Trello ou num documento.

Criar um fluxo com IA

Em vez de desenhar do zero, você conta a história do processo e uma IA (Claude, ChatGPT ou outra) monta o arquivo no formato do sistema. Depois é só importar e ajustar com duplo clique.

Escreva a história seguindo o modelo abaixo. O montador de história ajuda a preencher por partes.
Junte o prompt com a história. O montador já faz isso, com o botão "Gerar texto para a IA".
Cole na conversa com a IA. Ela responde com um bloco json.
No sistema, clique em Importar JSON e cole a resposta.

Como contar a história

A IA só monta bem o que estiver claro na história. Não precisa saber nada de JSON: conte o processo como se explicasse para alguém de fora.

Diga sempre quem faz"Gestor → aprova o pedido". Cada "quem" vira uma coluna.

Uma ação por linhaComece com um verbo. Se tem "e" no meio, provavelmente são dois passos.

Primeiro o caminho felizDepois, em outra parte, as decisões e exceções: recusa, cancelamento, prazo vencido, retorno.

Numere e referencie"No passo 2, se não estiver correto, volta ao passo 1." A IA usa os números para ligar os passos.

Diga de onde vem a regraCartão (com o código), escopo, sistema atual ou proposta. O que não está decidido, marque como pendente.

Use os nomes reaisTabelas, sistemas e documentos com o nome que o time usa ("PEDIDO_REEMBOLSO", "e-mail de confirmação").

Modelo de história

Copie, preencha e apague as partes que não fizerem sentido. Só "Atores" e "Caminho principal" são indispensáveis.

Montador de história

Preencha as partes abaixo; os exemplos em cinza mostram o tipo de texto esperado. O que você escreve fica salvo neste navegador até você limpar. No fim, Gerar texto para a IA junta o prompt com a sua história, pronto para colar.

O prompt

É a instrução que ensina a IA a montar o arquivo: o formato do JSON, como posicionar os passos nas colunas e linhas, como ligar, o que fazer com o que estiver incerto e o que conferir antes de responder. Também inclui um exemplo completo e válido. Se não usar o montador, copie o prompt e troque a última linha pela sua história.

Levar o resultado para o sistema

Na resposta da IA, copie o conteúdo do bloco json (muitas ferramentas têm um botão "copiar" no próprio bloco).
Volte ao sistema e clique em Importar JSON, no topo.
Cole no campo "Ou cole o JSON" e clique em Importar texto colado.
Confira o desenho. Ajuste com duplo clique e arraste o que ficou fora do lugar. "Renumerar" arruma a numeração.

Se algo der errado

"O conteúdo não é JSON": a IA provavelmente escreveu texto fora do bloco, ou o JSON veio cortado. Peça: "Responda só com o JSON completo, num único bloco".
Passos amontoados ou setas estranhas: peça para revisar a "linha" e a coluna ("atorId") de cada passo, lembrando que cada passo do caminho principal fica numa linha nova.
Faltou alguma coisa: peça a correção na mesma conversa ("inclua a exceção de cancelamento no passo 5") e importe de novo, escolhendo "Substituir".
O sistema completa o que estiver faltando (ids, listas vazias) e descarta ligações para passos que não existem.

Atalhos

`Enter`	salva o campo ou o item da lista (e abre o próximo item)
`Shift` + `Enter`	quebra a linha num item de lista com texto longo
`Ctrl`/`⌘` + `Enter`	salva descrições e anotações
`Esc`	cancela a edição; fora de um campo, fecha o painel do passo ou cancela o "ligar clicando"
`Ctrl`/`⌘` + `Z`	desfaz a última alteração

Onde ficam os dados

Tudo fica no navegador onde você trabalhou (armazenamento local). Não há servidor nem banco.
Outro navegador, outro computador ou uma janela anônima não enxergam os seus fluxos. Para levar ou compartilhar, use Exportar e Importar.
Limpar os dados do site no navegador apaga os fluxos. Exporte de vez em quando para ter uma cópia de segurança.