Communitygithub.com

Workflow Visualizer

Explica um workflow em detalhes como uma página visual (legenda de símbolos, caixas informativas, explicações tangíveis) e escolhe a forma do diagrama com base na estrutura do processo. Use sempre que um workflow, processo ou procedimento for o tópico E o usuário quiser detalhamento, por exemplo: 'em mais detalhes', 'passo a passo', 'como exatamente isso funciona', 'explique o fluxo novamente'. Não use quando 'workflow' for mencionado de passagem ou uma resposta curta for suficiente.

O que é Workflow Visualizer?

O Workflow Visualizer é uma skill para agentes de IA que transforma descrições textuais de processos ou workflows em diagramas visuais ricos e informativos. Em vez de uma longa explicação em texto, a skill gera uma página HTML auto-contida, com legenda de símbolos, caixas informativas e uma representação gráfica (fluxograma, linha do tempo, raias, etc.) que se adapta à estrutura real do processo analisado. A skill analisa a conversa ou documentos fornecidos, identifica a estrutura do workflow (se há loops, decisões, transferências, atrasos, etc.) e seleciona a forma de diagrama mais adequada — seja um fluxograma, uma linha do tempo, raias, ciclo, trilhas paralelas ou ramificações. Cada etapa do processo é detalhada com título, descrição, marcador de tempo, e caixas opcionais para informações críticas ('Importante') ou exemplos concretos ('Concreto'). A saída é uma página HTML estilizada com design limpo e responsivo, seguindo regras tipográficas e de cores pré-definidas. A skill é ideal para situações onde o usuário pede explicações detalhadas de um workflow, processo ou procedimento, como 'explique em mais detalhes', 'passo a passo' ou 'como exatamente isso funciona'. A skill suporta qualquer plataforma de agente de IA que possa executar código e gerar arquivos HTML (como Claude Code, Cursor, Codex) e é ativada automaticamente quando o contexto envolve um workflow e o usuário demonstra desejo por profundidade.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jirispataart-deve/workflow-visualizer/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. O contexto é um workflow, processo ou procedimento (do próprio usuário, de algo discutido, ou que precisa ser explicado do zero).
  2. 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

  1. 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".
  2. 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.
  3. 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.
  4. 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.
  5. Monte a legenda. Apenas os símbolos que aparecem no gráfico, mais os elementos da forma escolhida. A legenda fica no topo.
  6. 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 seguindo references/shapes.md. Para fluxograma há um exemplo pronto em assets/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.
  7. 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ímboloFormaSignificado
Açãoquadrado preenchidoalgo é feito ou produzido
Decisãoquadrado vazioo fluxo se ramifica aqui
Ponto de verificaçãolosangoverificação, aprovação
Transferênciatriânguloo resultado passa para uma pessoa, ferramenta ou fase
Esperabarra horizontalnada acontece ativamente, o tempo passa
Abertoquadrado tracejadoinformaçã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.

Habilidades Relacionadas