juanmackie/juanskills

Architecte de Diagrammes ASCII

Une compétence spécialisée pour générer des diagrammes et organigrammes ASCII de haute utilité, indépendants de tout outil, dans les commentaires de code ou la documentation, suivant le « Design Space of ASCII Drawings » (Hayatpur et al., 2024).

Instructions de Déclenchement

Utilisez cette compétence lorsque l'utilisateur demande de :

• « visualiser, »
• « diagrammer, »
• « organigrammer, » ou
• « cartographier »

un processus, une structure de données ou une architecture système à l'aide de texte brut.

Activez-la lors de l'explication de code où une représentation visuelle de la logique ou de la disposition mémoire améliorerait la clarté.

Principes Fondamentaux

Indépendance des Outils

Assurez-vous que le diagramme est strictement monospace et lisible dans n'importe quel éditeur de texte basique (IDE, Terminal, Git).

Proximité de l'Information

Le diagramme doit agir comme une « carte visuelle » placée directement au-dessus ou à côté de la logique qu'il décrit.

Notation Structurée

Utilisez des jeux de caractères cohérents (+, -, |, v, >) pour définir les limites et le flux.

Le Workflow de l'Espace de Conception

Basé sur la recherche de Hayatpur et al., définissez les dimensions suivantes en interne avant de produire le rendu :

1. Identification du Contenu

Déterminez ce qui est représenté :

• Architecture Système : Composants de haut niveau et réseau.
• Structures de Données : Dispositions mémoire, listes chaînées ou nœuds d'arbres.
• Comportement Dynamique : Logique étape par étape ou transitions d'états.

2. Disposition et Connectivité

• Boîte-et-Ligne : Utilisez +---+ pour les entités et | ou - pour les connexions.
• Direction du Flux : Standardisez du haut vers le bas ou de gauche à droite.
• Alignement : Assurez-vous que tous les traits verticaux (|) sont parfaitement alignés pour maintenir la forme de « boîte ».

Directives d'Implémentation

La Norme « Boîte »

Utilisez toujours une limite à 3 niveaux pour les entités afin de les rendre visuellement distinctes :

+-----------------------+
|      NOM DE L'ENTITÉ  |
+-----------------------+

La Norme « Connecteur »

Utilisez des pointes de flèche explicites pour montrer la directionnalité. N'utilisez pas de lignes ambiguës.

• Vertical : | suivi de v
• Horizontal : --- suivi de >

Annotations

Placez du texte descriptif court à côté des connecteurs pour expliquer la transition ou la logique (p. ex., "si x > 0" ou "Appel API").

Exemple de Workflow : Demande Système

Entrée : « Montre-moi comment un Répartiteur de Charge distribue le trafic à trois serveurs. »

Sortie :

          [ DEMANDE CLIENT ]
                  |
                  v
       +-----------------------+
       |   RÉPARTITEUR DE CHARGE |
       +----------+------------+
                  |
        +---------+---------+
        |         |         |
        v         v         v
    +-------+ +-------+ +-------+
    | SRV 1 | | SRV 2 | | SRV 3 |
    +-------+ +-------+ +-------+

Contraintes

1. N'utilisez pas de caractères Unicode non standard (comme ┌ ou ┐) sauf demande explicite, car ils peuvent ne pas fonctionner dans certains environnements de terminal ou éditeurs hérités.
2. Maintenez le Monospace : Chaque ligne doit être vérifiée pour la cohérence de la largeur des caractères.
3. Évitez la Complexité : Si un diagramme nécessite plus de 80 caractères de largeur, divisez-le en « Sous-Modules » pour garantir qu'il tient dans les fenêtres IDE standard.