Que fait Visualiseur de workflow ?
Lorsque quelqu'un veut comprendre un workflow en détail, le texte continu suffit rarement. Un processus a un ordre, des transferts, des décisions et des temps d'attente. Un graphique adapté rend tout cela lisible d'un coup. Il remplace une longue réponse textuelle plutôt que de s'y ajouter.
La forme est choisie librement. Aucune forme n'a la priorité, ni la chronologie ni aucune autre. La structure du workflow décide.
Quand ce skill s'applique
Deux conditions ensemble :
- Le sujet est un workflow, processus ou procédure (le sien, un qui a été discuté, ou qui doit être expliqué à partir de zéro).
- L'utilisateur veut plus de détails : "en détail", "plus précisément", "étape par étape", "explique à nouveau", "comment ça se déroule".
Si le mot "workflow" n'apparaît qu'au passage et que la question peut être répondue rapidement, répondez brièvement dans le chat. Un graphique pour chaque mention superficielle le dévalorise.
Procédure
- Clarifiez le processus. Prenez le processus de la conversation, des fichiers ou des sources nommées par l'utilisateur. Si quelque chose d'essentiel manque, demandez une fois, brièvement. N'inventez pas d'étapes, de durées ou d'outils. Tout élément non vérifié est marqué "Open".
- Lisez la structure, puis choisissez la forme. Voir la section suivante. Dites dans le chat en une phrase quelle forme vous avez choisie et pourquoi. L'utilisateur peut vous contredire d'un mot.
- Esquisse. 4 à 10 étapes au total, regroupées en 2 à 4 phases ou couloirs. Plus dilue le graphique ; résumez plutôt les sous-processus.
- Remplissez chaque étape.
- Marqueur temporel ou position : une durée réelle, un moment dans le temps ou un ordre ("Étape 3"). Pas d'heures devinées.
- Un symbole de la légende.
- Un titre (nom, court) et une à deux phrases sur ce qui se passe et pourquoi.
- Optionnel : boîte Important : uniquement lorsqu'une information peut faire ou défaire le processus (prérequis, source d'erreur, approbation).
- Optionnel : boîte Concret : une image tangible, un exemple ou une analogie qui rend une étape abstraite saisissable. L'image explique quelque chose ; elle ne décore pas.
- Construisez la légende. Seulement les symboles qui apparaissent dans le graphique, plus les éléments de la forme choisie. La légende est en haut.
- Livrez sous forme de page. Construisez-la à partir de
assets/base-template.html(jetons, en-tête, légende, boîtes) et ajoutez la structure de la forme choisie selonreferences/shapes.md. Pour le flowchart, il existe un exemple fini dansassets/flowchart-example.html: réutilisez son CSS et remplacez le contenu. Titrez la page avec le nom du workflow, par exemple "Flux d'approbation de documents". Si votre environnement peut publier des pages ou artefacts, publiez-y ; sinon, livrez un fichier HTML autonome. - Répondez dans le chat. Une ou deux phrases : la forme choisie avec la raison, et tout point ouvert. Ne répétez pas le contenu du graphique.
Choisir la forme
Lisez d'abord la structure du workflow, puis décidez. Ces questions aident :
- Y a-t-il des décisions dont le résultat ramène en arrière (une boucle), ou dont les chemins se rejoignent, et le lecteur doit-il pouvoir tracer le chemin avec le doigt ? → Flowchart
- Les chemins se divisent-ils à des décisions et aboutissent-ils à des endroits différents sans revenir ? → Branching
- Plusieurs personnes, outils ou rôles portent-ils des parties du processus, la difficulté est-elle dans les transferts, et il n'y a pas de boucle ? → Couloirs (Lanes)
- Le processus recommence-t-il à l'identique après la dernière étape, ou le résultat alimente-t-il la prochaine exécution, sans décisions intermédiaires ? → Cycle
- Des brins s'exécutent-ils en même temps et doivent-ils se rejoindre quelque part ? → Pistes parallèles
- Le processus est-il essentiellement une séquence d'étapes dans le temps, avec des temps d'attente, des échéances ou des durées importantes ? → Chronologie (Timeline)
- Le workflow mélange-t-il plusieurs propriétés ? Choisissez celle où le lecteur a le plus de chances de se tromper. La propriété secondaire devient une boîte d'info ou une étiquette de lieu : un flowchart peut montrer où une étape se déroule sans avoir besoin de couloirs.
Une boucle est la raison la plus courante de changer de forme. La cacher dans une boîte d'info l'enterre, et c'est exactement là où les lecteurs trébuchent. S'il y en a une, le flowchart est généralement la forme la plus honnête, même si les couloirs ou la chronologie semblent convenables au premier coup d'œil.
Ne choisissez pas par l'apparence ou par habitude. Une forme qui ne correspond pas à la structure falsifie le processus : un axe cache les alternatives, des couloirs sans véritables transferts sont de la décoration.
Les règles de construction exactes pour chaque forme se trouvent dans references/shapes.md. Lisez uniquement la section de la forme choisie.
Symboles
Tous angulaires, pas de cercles. Les formes sont dessinées avec du CSS plutôt qu'avec des caractères pour qu'elles paraissent identiques partout.
| Symbole | Forme | Signification |
|---|---|---|
| Action | carré plein | quelque chose est fait ou produit |
| Décision | carré vide | le flux bifurque ici |
| Point de contrôle | losange | vérification, signature, approbation |
| Transfert | triangle | le résultat passe à une personne, un outil ou une phase |
| Attente | barre horizontale | rien ne se passe activement, le temps passe |
| Open | carré en tirets | l'information est manquante ou non vérifiée |
Ajoutez d'autres symboles uniquement si le workflow en a vraiment besoin, et expliquez-les dans la légende.
Style
Le template est livré avec un neutre par défaut : fond papier chaud, encre presque noire, un seul accent pâle utilisé uniquement comme surface, et la police système. Toutes les couleurs sont des jetons dans :root. Si l'utilisateur a une marque ou un système de design, changez uniquement ces jetons ; ne restylisez pas la structure.
- Fond papier, encre pour les titres, graphite pour le texte courant, teinte calme pour les surfaces silencieuses, traits fins pour les filets.
- L'accent est utilisé uniquement comme surface, jamais comme couleur de texte ou de ligne. Le texte dessus est toujours encre. Au plus une grande bande d'accent par page ; les petites barres de repère (10px) sous les titres de phase ou de couloir peuvent se répéter.
- Une seule famille de police. Hiérarchie via le poids et l'espacement des lettres ; espacement des lettres uniquement sur les majuscules.
- Pas d'ombres, de dégradés, de coins arrondis, d'emojis ni de points d'exclamation. Les listes utilisent des carrés d'encre. Les connexions sont des lignes droites à angles droits, 2px encre.
- La page reste sur un seul thème, sur fond papier. Toutes les couleurs sont définies explicitement pour qu'elle soit lisible aussi bien dans les interfaces claires que sombres.
- Mobile d'abord, pas de défilement horizontal de la page. Tout ce qui doit être plus large (couloirs) défile dans son propre conteneur.
N'inventez pas de nouvelles couleurs, polices ou formes. Si le système manque de quelque chose, nommez le manque et résolvez-le dans le cadre des jetons.
Langue
Rédigez le graphique dans la langue utilisée par l'utilisateur. Restez factuel, à base de noms, et court. Pas de remplissage, pas de jargon à la mode. Les explications peuvent être vives mais précises : une image forte plutôt que trois faibles.
Liste de vérification avant livraison
- La forme suit la structure du workflow, et la phrase dans le chat en donne la raison.
- Chaque boucle est dessinée comme un chemin et non seulement mentionnée dans le texte.
- Chaque mention de temps est documentée ou marquée comme simple ordre.
- Tout élément non vérifié porte le symbole "Open".
- Tous les symboles du graphique apparaissent dans la légende, et aucun autre.
- L'accent est utilisé uniquement comme surface, jamais comme texte ou ligne.
- Aucun texte ne dépasse du bord, même à 400px de largeur.
- Le texte du chat ne répète pas le contenu du graphique.