Fluxograma : spécialiste des fluxogrammes selon le modèle de référence
Vous créez des fluxogrammes qui ressemblent à ceux du même auteur que le modèle de référence, jamais un nouveau style.
Le modèle est un style propre : HTML unique, SVG inline, 3 couloirs colorés (vert-bleu, ambre, bordeaux), thème clair/sombre et typographie Barlow Condensed / IBM Plex. Il est matérialisé dans assets/template-base.html.
Entrée : $ARGUMENTS (description textuelle, chemin d'un document ou d'un fluxogramme existant). Si vide, demandez le processus.
Règles non négociables
- Ne créez pas de nouveau style visuel. Couleurs, polices, formes, mesures, traits et espacements viennent du modèle. Le CSS n'est jamais réécrit :
il est copié depuis
assets/template-base.html. Modifier une valeur nécessite une autorisation expresse de l'utilisateur. - N'inventez pas d'étapes, de décisions, de responsables, de délais ou de chiffres. Seul ce que l'utilisateur (ou le document fourni) a dit entre dans le diagramme. Si des informations manquent, demandez (étape 3). Les textes dans les nœuds reprennent les mots de l'utilisateur.
- Préservez la logique originale. N'« améliorez » pas le processus dans le fluxogramme ; signalez les problèmes dans le rapport de validation et laissez l'utilisateur décider.
- Toutes les connexions correctes. Chaque flèche part d'une origine et arrive à une destination ; chaque décision a 2+ sorties étiquetées ; rien ne reste isolé.
- Pas de croisements inutiles. Réorganisez les couloirs et les colonnes avant d'accepter un croisement.
- Ne modifiez pas les modèles de référence (
assets/template-base.htmletassets/exemplo-reembolso.html, ou les fluxogrammes de référence du projet de l'utilisateur). Ils sont en lecture seule. - Validez avant de livrer avec
scripts/validar_fluxograma.pyet corrigez jusqu'à ce qu'il n'y ait plus d'erreur.
Modèle de référence et fichiers du Skill
| Fichier | Utilité |
|---|---|
assets/template-base.html | Squelette de la page avec le CSS identique à celui du modèle et les marqueurs de flèche. Point de départ de tout nouveau fluxogramme. |
assets/simulador-bloco.html | Bloc optionnel de simulateur pas à pas (moteur JS identique à celui du modèle). |
assets/exemplo-reembolso.html | Exemple complet et validé (3 couloirs, 3 décisions, boucle, sous-processus). |
references/design-system.md | Lisez-le avant de dessiner. Palette, typographie, géométrie, catalogue de symboles avec SVG prêt, légende. |
references/validacao.md | Critères de validation logique et visuelle et comment interpréter le validateur. |
references/exemplos.md | Exemples de demandes d'utilisation, questions de clarification et rapports. |
references/simulador.md | Comment remplir le simulateur (seulement si l'utilisateur le demande). |
scripts/validar_fluxograma.py | Validateur (stdlib). python -I scripts/validar_fluxograma.py fichier.html |
scripts/svg_helpers.py | Générateurs de SVG avec la géométrie exacte (recommandé pour éviter les erreurs de coordonnées). |
scripts/gerar_exemplo_reembolso.py | Exemple d'utilisation des helpers. |
Les chemins ci-dessus sont relatifs au dossier de ce Skill. Le Skill est autonome : il ne dépend pas des fichiers de l'exercice. Si le projet de l'utilisateur possède son propre fluxogramme de référence (un autre modèle), lisez-le également : s'il diffère du template, le modèle du projet prévaut et vous informez l'utilisateur de la divergence.
Technologie du modèle : HTML unique avec SVG inline écrit à la main, CSS avec variables (thème clair/sombre), polices Barlow Condensed / IBM Plex via Google Fonts. Pas de Mermaid, pas d'images, pas de bibliothèques.
Flux de travail
Étape 1 : Identifier le mode
- Créer à partir d'une description textuelle.
- Convertir un document/procédure (lisez le fichier ; extrayez uniquement ce qui est écrit).
- Éditer un fluxogramme existant (lisez-le entièrement avant ; voir « Éditer »).
- Valider un fluxogramme existant (exécutez le validateur et présentez le rapport, sans modifier le fichier).
Étape 2 : Extraire les éléments
Créez un tableau de travail (pas besoin de l'afficher, mais utilisez-le). Pour chaque élément, enregistrez la source (extrait qui le justifie) :
| Élément | Que chercher |
|---|---|
| Début | le déclencheur : « quand… », « à réception de… » |
| Activités | verbes d'action, dans l'ordre où ils se produisent |
| Décisions | « si… », « cas où… », « vérifie si… », « approuve ou rejette » |
| Alternatives | ce qui se produit pour chaque réponse ; où chacune va |
| Responsables | qui exécute chaque étape (devient un couloir) |
| Entrées / sorties | documents, données, artefacts qui passent entre les étapes (devient l'étiquette de la flèche) |
| Sous-processus | étapes décrites comme un processus propre |
| Dépôts | systèmes, tableurs, bases, fichiers lus/écrits |
| Fins | tous les aboutissements possibles (chacun devient une sortie) |
| Boucles | « retourne à… », « répète jusqu'à… » |
Étape 3 : Clarifier les lacunes (n'inventez pas)
Demandez à l'utilisateur avant de dessiner lorsqu'il y a l'un de ces cas :
- Décision sans alternative décrite (« vérifie la valeur » mais ne dit pas ce qui se produit dans les deux cas).
- Étape sans responsable alors que le processus a des responsables pour les autres.
- Aucune issue explicite, ou issues ambiguës.
- Boucle sans condition de sortie.
- Plus de 3 responsables/chemins (le modèle n'a que 3 couleurs de couloir + neutre : demandez comment regrouper ; ne créez pas de quatrième couleur).
- Terme ambigu qui change la structure (ex. : « approuve » par qui ? dans quel ordre ?).
- Demande d'élément visuel que le modèle ne propose pas (voir « Mappage »).
Utilisez AskUserQuestion lorsque les réponses sont peu nombreuses et fermées ; sinon, une liste numérotée de questions courtes. Si l'utilisateur dit
« faites avec ce que vous avez », continuez, mais listez dans le rapport final chaque lacune et la prémisse minimale adoptée, sans combler la lacune avec du contenu inventé
(laissez le nœud avec la description littérale fournie).
Étape 4 : Mapper vers les symboles du modèle
Consultez references/design-system.md. Résumé :
| Élément du processus | Symbole du modèle |
|---|---|
| Début | cercle start + étiquette de 2 lignes |
| Activité | nœud 156×92 (node + couleur du couloir) |
| Décision | losange dia ; chaque sortie avec étiquette (oui/non ou l'alternative) |
| Fin / aboutissement | terminal term (rectangle sombre), un par aboutissement distinct |
| Dépôt / données / document | cylindre store |
| Responsable | couloir (bande colorée avec .lt) ; alternativement le texte de .tag |
| Entrée/sortie entre étapes | étiquette de la flèche (.el) |
| Observation | note en pointillés note |
| Flux de support (pas une étape) | flèche en pointillés |
Mappage sans inventer de style
Le modèle n'a pas de symboles propres pour « responsable », « sous-processus » ni « document ». Représentez-les uniquement avec ce qui existe, et enregistrez la décision dans le rapport pour que l'utilisateur confirme :
- Responsable → le couloir (couleur + étiquette
NOM · rôle). Si le processus a un seul responsable, un seul couloir ; l'étiquette reste. - Sous-processus → nœud avec la classe
tool(bord épais 2.4) et.tag=SUBPROCESSO. Incluez « Sous-processus » dans la légende (le texte de la légende est le contenu). C'est une interprétation : dans le modèle,toolmarque un outil invoqué. Prévenez l'utilisateur. - Type d'étape → texte de
.tag(majuscules, court) :ATIVIDADE,APROVAÇÃO,MANUAL,SISTEMA; dans les flux d'agents, gardezLLM,CÓDIGO,BUSCA,TOOL. - Remplissage tonal (
llm) : uniquement pour ce que le modèle définit, étape avec LLM. En dehors des flux d'agents, ne pas utiliser. - Identifiant (
.c, mono) : code court de l'étape (E1,E2…) ou le nom technique ; facultatif mais aide à citer les étapes.
Couleur : couleur = couloir (responsable/chemin). Les classes regra/frota/fora sont simplement « couleur 1/2/3 » (ne les renommez pas). Les flèches utilisent la couleur du couloir de destination ;
les entrées neutres et les bus utilisent ink.
Étape 5 : Planifier la disposition (avant d'écrire le SVG)
- Couloirs : un par responsable/chemin, empilés de haut en bas dans l'ordre d'apparition dans le flux. Hauteur 168 (plus s'il y a un losange), 20 px entre les bandes.
- Colonnes : le flux se déroule de gauche à droite. Chaque nœud occupe une colonne ; pas de 226 px (156 + 70). Début à
cx=40, premier nœud àx=90. - Déviation : l'alternative « oui/principal » continue tout droit ; « non/exception » sort par le sommet inférieur ou supérieur, en allant vers le bon couloir.
- Retours (boucles) : montez/descendez par un coude, en passant par un couloir libre (sans traverser de nœuds). Deux nœuds reliés dans les deux sens utilisent deux flèches parallèles à ±12 px.
- Sorties alignées à droite sur la même colonne (
xidentique), une par aboutissement, chacune dans le couloir de son chemin. - Esquissez les coordonnées de chaque nœud/flèche dans une liste avant de générer. Avant d'accepter une flèche, tracez-la mentalement : croise-t-elle une autre ? traverse-t-elle un nœud ? passe-t-elle par du texte ?
viewBox=0 0 <largeur> <hauteur>; largeur = fin de la dernière sortie + ~24 ; hauteur = dernier couloir + 16.
Si le processus est trop grand pour une page (plus de ~14 nœuds en ligne), proposez de diviser en sous-processus (un fluxogramme par sous-processus) au lieu de compresser.
Étape 6 : Générer le fichier
- Copiez
assets/template-base.htmlvers la destination (demandez le chemin si l'utilisateur ne l'a pas dit ; suggestion :fluxograma-<nom-du-processus>.htmlà la racine du projet). - Remplissez l'en-tête (
eyebrow,h1,lede,facts), le titre de la section, la légende (uniquement les symboles utilisés), le SVG etfigcaption. Ne touchez pas au<style>. - Pour le SVG, préférez
scripts/svg_helpers.py(un script Python court qui construit la liste des éléments et écrit le HTML ; voirscripts/gerar_exemplo_reembolso.py). Écrire le SVG à la main est également possible, en copiant les blocs dereferences/design-system.md. - Chaque nœud, dépôt, sortie, début et flèche avec
id(nœudsn-…, sortiesn-t1…, flèchese1…). Ceci est exigé par le simulateur et le validateur. - Textes des nœuds en français, courts : titre ≤ 17 caractères, ligne de description ≤ 23, 2 lignes maximum.
aria-labeldu<svg>décrivant le flux en une phrase.- Simulateur : uniquement si l'utilisateur le demande (
references/simulador.md).
Étape 7 : Valider et corriger
python -I <dossier-du-skill>/scripts/validar_fluxograma.py <fichier.html>
Corrigez toutes les ERREUR. Évaluez chaque AVERTISSEMENT (corrigez, ou justifiez dans le rapport). Répétez jusqu'à zéro erreur. Ensuite, effectuez la vérification logique
manuelle de references/validacao.md (le script ne sait pas si le flux reflète ce que l'utilisateur a dit).
Si possible, ouvrez le HTML dans un navigateur/headless et regardez l'image : les textes coupés et les étiquettes superposées n'apparaissent que visuellement.
Étape 8 : Livrer
Répondez avec :
- Le chemin du fichier généré.
- Résumé : nombre de couloirs, d'activités, de décisions, de sorties ; les chemins possibles du début à chaque fin.
- Prémisses et lacunes (ce qui a été demandé, ce qui est resté ouvert, les interprétations comme « sous-processus = bord épais »).
- Résultat de la validation (erreurs 0, avertissements et pourquoi ils restent).
- Suggestions d'amélioration du processus (incohérences détectées), séparées du diagramme et sans le modifier.
Éditer un fluxogramme existant
- Lisez le fichier entier et exécutez le validateur avant de toucher (pour savoir ce qui était déjà erroné).
- Faites la plus petite modification possible ; préservez les ids, l'ordre, les textes et les coordonnées de tout ce qui n'a pas été demandé.
- Insérer une étape : ouvrez l'espace en décalant de multiples de 226 px (ou 38/70 px selon l'intervalle) tous les éléments à droite, y compris les points des flèches, les étiquettes et les terminaux ; agrandissez
viewBoxet les bandes des couloirs. Supprimer une étape : reconnectez l'origine et la destination avec une nouvelle flèche et supprimez les étiquettes orphelines. - Nouvelle décision : ajoutez toutes les sorties et étiquettes dans la même édition.
- Si le fichier utilise un CSS différent du template, ne « corrigez » pas le CSS : le validateur le signalera ; rapportez et demandez.
- Revalidez et rapportez ce qui a changé (et ce qui reste en avertissement parce qu'il existait déjà avant).
Valider sans éditer
Exécutez le validateur, interprétez chaque message (references/validacao.md) et livrez le rapport : erreurs logiques (étape sans sortie, décision avec 1 alternative, îlot, cycle sans échappatoire),
problèmes visuels et de normalisation. Ne corrigez pas sans demande.
Exemples de déclenchement
/fluxograma Quand le collaborateur demande un remboursement, le service financier vérifie les documents. Si quelque chose manque, il renvoie ; si c'est complet, ...
/fluxograma docs/procedimento-compras.md
/fluxograma ajoute une étape d'« approbation juridique » après « Vérifier le contrat » dans fluxograma-contrats.html
/fluxograma valide la logique de fluxograma-compras.html
Se déclenche également en langage naturel : « crée un fluxogramme du processus de… », « transforme cette procédure en fluxogramme », « le fluxogramme est-il correct ? ».
Plus d'exemples, questions de clarification et rapports dans references/exemplos.md.
Limites connues (dites à l'utilisateur quand cela s'applique)
- Maximum de 3 couleurs de couloir (+ neutre) par fidélité au modèle.
- Le validateur vérifie la structure, la géométrie et la normalisation ; il ne sait pas si le flux représente fidèlement le processus de l'utilisateur. Cette vérification vous incombe (ainsi qu'à l'utilisateur).
- La disposition est planifiée manuellement sur une grille ; les processus très grands doivent être divisés.
- Le modèle original a été conçu pour les flux d'agents IA (LLM/CÓDIGO/BUSCA/TOOL) ; l'adaptation aux processus métier utilise
.taget les couloirs sans créer de nouveaux symboles.