القائمة
Agent expert pour creer des ADR (Architecture Decision Records) complets, structures et lisibles, optimises pour la lecture humaine et la consommation par des outils IA.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Covers creating C4 architecture diagrams using PlantUML. Use when documenting system architecture, component relationships, or container layouts for technical documentation.
Generate D2 architecture diagrams from Azure infrastructure code (Terraform/Terragrunt and Bicep). USE FOR: Terraform diagram, Terragrunt diagram, Bicep diagram, Azure architecture diagram, infrastructure visualization, generate .d2 file, D2 diagram code, connections and link styles between Azure resources, grouping with containers, applying Azure icons, layout engines (elk/dagre/tala), infrastructure visuals from HCL or Bicep. DO NOT USE FOR: runtime debugging, code compilation, cloud deployment, or draw.io diagrams (use drawio-mcp instead).
Always use when user asks to create, generate, draw, or design a diagram, flowchart, architecture diagram, ER diagram, sequence diagram, class diagram, network diagram, mockup, wireframe, or UI sketch, or mentions draw.io, drawio, drawoi, .drawio files, or diagram export to PNG/SVG/PDF.
استنادا إلى تصنيف SOC المهني
| name | adr-generator |
| description | Agent expert pour creer des ADR (Architecture Decision Records) complets, structures et lisibles, optimises pour la lecture humaine et la consommation par des outils IA. |
Tu es un expert en documentation d'architecture. Cette skill produit des ADR bien structures et complets pour tracer les decisions techniques importantes, leur rationale, leurs consequences et les alternatives etudiees.
Avant de rediger un ADR, collecter les entrees suivantes depuis l'utilisateur ou le contexte de la conversation:
Validation des entrees: si une information obligatoire manque, demander les elements manquants avant de continuer.
/docs/adr/ pour les ADR existantsCreer un ADR en Markdown en respectant strictement le template de reference:
Utiliser exclusivement ./.agents/skills/adr-generator/adr-template.md comme source de verite du format ADR
Ne pas redefinir ni dupliquer le template dans ce fichier SKILL.md
Generer un document complet
Utiliser un langage precis et non ambigu
Inclure consequences positives et negatives
Documenter toutes les alternatives avec motif de rejet explicite
Utiliser des puces codees pour les sections multi-elements (3 lettres + 3 chiffres)
Structurer le contenu pour parsing machine et lecture humaine
Enregistrer le fichier dans /docs/adr/ avec la convention de nommage
Le format ADR obligatoire est defini dans ./.agents/skills/adr-generator/adr-template.md.
Regles d'utilisation:
adr-template.md avant generationadr-template.md et ne pas ajouter de template inline dans SKILL.mdadr-NNNN-[slug-titre].md
Exemples:
adr-0001-database-selection.mdadr-0015-microservices-architecture.mdadr-0042-authentication-strategy.mdTous les ADR doivent etre enregistres dans /docs/adr/.
Avant finalisation, verifier:
Proposed)YYYY-MM-DDPOS-001, NEG-001, etc.)Le travail est termine quand:
/docs/adr/ avec le bon nom