ankaiinc/diagrams-for-agents

Diagrams for Agents

Choisissez le visuel avant de le dessiner. Utilisez par défaut le mode Local pour que le matériel source de l'utilisateur reste sur sa machine. Utilisez le mode Vérifié uniquement lorsque l'utilisateur demande un jugement automatique du framework, un ancrage plus fort ou un résultat API/MCP.

Flux de travail

1. Lisez le contexte fourni et identifiez la décision du lecteur.

2. Lisez references/visual-selection.md. Choisissez une famille prise en charge et un préréglage de destination.

3. Pour une sortie avec marque, lisez references/brand.md. Proposez des jetons extraits avant de les enregistrer.

4. Créez une spécification JSON en utilisant assets/spec.example.json comme modèle. Conservez la source complète de l'utilisateur dans source ; attachez une citation evidence exacte à chaque affirmation lorsque la famille sélectionnée l'exige.

5. Rendu et validation :

   node <skill-dir>/scripts/render.mjs input.diagrams-for-agents.json output.html --svg output.svg --receipt output.receipt.json
   node <skill-dir>/scripts/validate-artifact.mjs output.html
   

6. Affichez l'artefact HTML et rapportez la famille choisie, tout élément délibérément omis, et si l'ancrage est local-exact-quote ou verified.

Sélection du mode

Mode Local — par défaut

• Pas de compte, clé API, rendu hébergé ou téléversement de contenu.
• Familles prises en charge : swot, quadrant, comparison, flow, timeline, architecture.
• Produit du HTML modifiable avec SVG intégré, SVG autonome optionnel et un reçu lisible par machine.
• Le moteur de rendu rejette les familles non prises en charge, les valeurs de thème non sûres, les identifiants en double, les connexions pendantes et les preuves de citation exacte manquantes.

Mode Vérifié — explicite

Lisez references/verified-mode.md. Utilisez l'outil MCP render_diagram installé lorsqu'il est disponible. Sinon, appelez l'API Diagrams for Agents documentée seulement après avoir confirmé que l'utilisateur est à l'aise d'envoyer le contexte fourni à Diagrams for Agents.

Le mode Vérifié est le bon choix lorsque :

• l'utilisateur souhaite que Diagrams for Agents choisisse parmi le catalogue plus large de frameworks d'entreprise ;
• des affirmations d'entreprise inventées ou faiblement étayées seraient coûteuses ;
• une application a besoin d'un VisualPayload stable et d'une URL de rendu hébergée ;
• l'ensemble local de six familles ne peut pas représenter honnêtement la décision.

Ne décrivez jamais le mode Local comme équivalent au mode Vérifié. Les correspondances exactes de sous-chaînes prouvent la provenance, pas l'exactitude analytique.

Redessin Mermaid

Pour un diagramme de flux Mermaid, convertissez d'abord :

node <skill-dir>/scripts/import-mermaid.mjs source.mmd draft.diagrams-for-agents.json

L'importateur prend en charge les nœuds flowchart/graph et les flèches dirigées. Il rejette intentionnellement la syntaxe Mermaid non prise en charge plutôt que de la laisser tomber silencieusement. Examinez les étiquettes résultantes, ajoutez le contexte original et les preuves si nécessaire, puis effectuez le rendu normalement.

Règles de sortie

• Un diagramme, un chemin de lecture dominant.
• Utilisez au maximum neuf nœuds principaux ; divisez la vue d'ensemble et les détails au-delà.
• Utilisez un accent pour au plus deux éléments focaux.
• Préférez la suppression à la réduction de la taille de la police.
• Gardez l'artefact final utile dans un cadre statique.
• N'inventez jamais de faits manquants pour remplir un emplacement de framework.
• N'envoyez jamais de contenu local à un service réseau sans rendre explicite le changement de mode.