Visualizador de Workflow
Quando alguém quer entender um workflow em detalhes, texto corrido raramente é suficiente. Um processo tem ordem, entregas, decisões e tempos de espera. Um gráfico adequado torna isso legível de imediato. Ele substitui a longa resposta em texto, em vez de se somar a ela.
A forma é escolhida livremente. Nenhuma forma tem prioridade, nem a linha do tempo nem qualquer outra. A estrutura do workflow decide.
Quando esta skill se aplica
Duas condições juntas:
- O contexto é um workflow, processo ou procedimento (do próprio usuário, de algo discutido, ou que precisa ser explicado do zero).
- O usuário quer mais profundidade: "em detalhes", "mais precisamente", "passo a passo", "explique novamente", "como funciona".
Se a palavra "workflow" aparecer apenas de passagem e a pergunta for respondida rapidamente, responda brevemente no chat. Um gráfico para cada menção superficial o desvaloriza.
Procedimento
- Esclareça o processo. Obtenha o processo da conversa, de arquivos, ou de fontes que o usuário indicar. Se algo essencial faltar, pergunte uma vez, brevemente. Não invente etapas, durações ou ferramentas. Qualquer coisa não verificada é marcada como "Aberto".
- Leia a estrutura, então escolha a forma. Veja a próxima seção. Diga em uma frase no chat qual forma você escolheu e por quê. O usuário pode anular sua escolha com uma palavra.
- Esboço. De 4 a 10 etapas no total, agrupadas em 2 a 4 fases ou faixas. Mais do que isso dilui o gráfico; resuma subprocessos.
- Preencha cada etapa.
- Marcador de tempo ou posição: uma duração real, ponto no tempo, ou ordem ("Etapa 3"). Nenhum horário adivinhado.
- Um símbolo da legenda.
- Um título (substantivo, curto) e uma a duas frases sobre o que acontece e por quê.
- Caixa Importante opcional: apenas quando uma informação pode fazer ou quebrar o processo (pré-requisito, fonte de erro, aprovação).
- Caixa Concreto opcional: uma imagem tangível, exemplo ou analogia que torne uma etapa abstrata compreensível. A imagem explica algo; não decora.
- Monte a legenda. Apenas os símbolos que aparecem no gráfico, mais os elementos da forma escolhida. A legenda fica no topo.
- Entregue como uma página. Construa a partir de
assets/base-template.html(tokens, cabeçalho, legenda, caixas) e adicione a estrutura da forma escolhida seguindoreferences/shapes.md. Para fluxograma há um exemplo pronto emassets/flowchart-example.html: reutilize seu CSS e substitua o conteúdo. Titule a página com o nome do workflow, por exemplo "Fluxo de aprovação de documentos". Se seu ambiente puder publicar páginas ou artefatos, publique-os; caso contrário, entregue um único arquivo HTML auto-contido. - Responda no chat. Uma ou duas frases: a forma escolhida com a justificativa, e quaisquer pontos em aberto. Não repita o conteúdo do gráfico.
Escolhendo a forma
Leia a estrutura do workflow primeiro, depois decida. Estas perguntas ajudam:
- Há decisões cujo resultado leva de volta (um loop), ou cujos caminhos se reencontram, e o leitor deve ser capaz de traçar o caminho com o dedo? → Fluxograma
- Os caminhos se dividem em decisões e terminam em lugares diferentes sem retornar? → Ramificação
- Várias pessoas, ferramentas ou papéis executam partes do processo, a dificuldade está nas transições, e não há loop? → Raias
- O processo recomeça inalterado após a última etapa, ou o resultado alimenta a próxima execução, sem decisões intermediárias? → Ciclo
- As vertentes ocorrem ao mesmo tempo e precisam se encontrar em algum lugar? → Trilhas paralelas
- O processo é essencialmente uma sequência de etapas ao longo do tempo, com tempos de espera, prazos ou durações relevantes? → Linha do tempo
- O workflow mistura várias propriedades? Escolha aquela em que o leitor tem mais chance de errar. A propriedade secundária se torna uma caixa de informação ou uma etiqueta de localização: um fluxograma pode mostrar onde uma etapa ocorre sem precisar de raias.
Um loop é a razão mais comum para mudar de forma. Escondê-lo em uma caixa de informação o enterra, e é exatamente aí que os leitores tropeçam. Se houver um, o fluxograma geralmente é a forma mais honesta, mesmo que raias ou a linha do tempo pareçam adequadas à primeira vista.
Não escolha por aparência ou hábito. Uma forma que não corresponda à estrutura falsifica o processo: um eixo esconde alternativas, raias sem transições reais são decoração.
As regras exatas de construção para cada forma estão em references/shapes.md. Leia apenas a seção da forma escolhida.
Símbolos
Todos angulares, sem círculos. As formas são desenhadas com CSS em vez de caracteres para que pareçam iguais em qualquer lugar.
| Símbolo | Forma | Significado |
|---|---|---|
| Ação | quadrado preenchido | algo é feito ou produzido |
| Decisão | quadrado vazio | o fluxo se ramifica aqui |
| Ponto de verificação | losango | verificação, aprovação |
| Transferência | triângulo | o resultado passa para uma pessoa, ferramenta ou fase |
| Espera | barra horizontal | nada acontece ativamente, o tempo passa |
| Aberto | quadrado tracejado | informação está faltando ou não verificada |
Adicione mais símbolos apenas se o workflow realmente precisar, e explique-os na legenda.
Estilo
O modelo vem com um padrão neutro: fundo de papel quente, tinta quase preta, um acento pálido usado apenas como superfície, e a fonte do sistema. Todas as cores são tokens em :root. Se o usuário tiver uma marca ou sistema de design, altere apenas esses tokens; não reformule a estrutura.
- Papel como fundo, tinta para títulos, grafite para texto corrente, um tom calmo para superfícies silenciosas, fios finos para réguas.
- O acento é usado apenas como superfície, nunca como cor de texto ou linha. O texto sobre ele é sempre tinta. No máximo uma faixa de acento grande por página; as pequenas barras marcadoras (10px) sob títulos de fase e faixa podem se repetir.
- Uma família de fontes. Hierarquia através de peso e espaçamento entre letras; espaçamento entre letras apenas em maiúsculas.
- Sem sombras, gradientes, cantos arredondados, emojis ou pontos de exclamação. Listas usam quadrados de tinta. As conexões são linhas retas com ângulos retos, 2px de tinta.
- A página permanece monocromática sobre papel. Todas as cores são definidas explicitamente para que seja lida da mesma forma em interfaces claras e escuras.
- Mobile first, sem rolagem horizontal da página. Qualquer coisa que precise ser mais larga (raias) rola em seu próprio contêiner.
Não invente novas cores, fontes ou formas. Se o sistema carecer de algo, nomeie a lacuna e resolva-a dentro dos tokens.
Idioma
Escreva o gráfico no idioma que o usuário está usando. Mantenha-o factual, baseado em substantivos e curto. Sem preenchimento, sem jargão. As explicações podem ser vívidas, mas precisas: uma imagem forte em vez de três fracas.
Lista de verificação antes de entregar
- A forma segue a estrutura do workflow, e a frase no chat nomeia o motivo.
- Cada loop é desenhado como um caminho e não apenas mencionado no texto.
- Cada declaração de tempo é documentada ou marcada apenas como ordem.
- Qualquer coisa não verificada carrega o símbolo "Aberto".
- Todos os símbolos no gráfico aparecem na legenda, e nenhum outro.
- O acento é usado apenas como superfície, nunca como texto ou linha.
- Nenhum texto ultrapassa a borda, nem mesmo a 400px de largura.
- O texto no chat não repete o conteúdo do gráfico.