| 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. |
ADR Generator Skill
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.
Workflow principal
1. Collecter les informations requises
Avant de rediger un ADR, collecter les entrees suivantes depuis l'utilisateur ou le contexte de la conversation:
- Titre de la decision: nom clair et concis
- Contexte: probleme, contraintes techniques, exigences metier
- Decision: solution retenue et justification
- Alternatives: options considerees et raisons de rejet
- Parties prenantes: personnes ou equipes impliquees/impactees
Validation des entrees: si une information obligatoire manque, demander les elements manquants avant de continuer.
2. Determiner le numero ADR
- Verifier le dossier
/docs/adr/ pour les ADR existants
- Determiner le prochain numero sequentiel sur 4 chiffres (0001, 0002, etc.)
- Si le dossier n'existe pas, commencer a 0001
3. Generer le document ADR en Markdown
Creer 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
Structure ADR obligatoire (template)
Le format ADR obligatoire est defini dans ./.agents/skills/adr-generator/adr-template.md.
Regles d'utilisation:
- Charger le template depuis
adr-template.md avant generation
- Respecter integralement les sections, codes et conventions du template
- En cas d'evolution du format, modifier uniquement
adr-template.md et ne pas ajouter de template inline dans SKILL.md
Nommage et emplacement des fichiers
Convention de nommage
adr-NNNN-[slug-titre].md
Exemples:
adr-0001-database-selection.mdadr-0015-microservices-architecture.mdadr-0042-authentication-strategy.md
Emplacement
Tous les ADR doivent etre enregistres dans /docs/adr/.
Regles de slug
- Convertir le titre en minuscules
- Remplacer les espaces par des tirets
- Supprimer les caracteres speciaux
- Garder un slug concis (idealement 3 a 5 mots)
Checklist qualite
Avant finalisation, verifier:
Regles importantes
- Etre objectif: presenter faits et raisonnement
- Etre transparent: documenter benefices et limites
- Etre clair: eviter toute ambiguite
- Etre specifique: donner des impacts concrets
- Etre complet: ne pas omettre de section
- Etre coherent: respecter structure et systeme de codes
- Etre a jour: utiliser la date courante sauf indication contraire
- Etre connecte: citer les ADR lies quand pertinent
- Etre contextuellement correct: s'appuyer sur l'etat reel du depot
Criteres de succes de l'agent
Le travail est termine quand:
- Le fichier ADR est cree dans
/docs/adr/ avec le bon nom
- Toutes les sections obligatoires sont renseignees utilement
- Les consequences refletent fidelement les impacts
- Les alternatives sont documentees avec motifs de rejet clairs
- Les notes d'implementation sont actionnables
- Le document respecte les standards de format
- La checklist qualite est satisfaite
