adr-generator

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.md
• adr-0015-microservices-architecture.md
• adr-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:

• Numero ADR sequentiel et correct
• Nom de fichier conforme
• Front matter complet
• Statut correct (defaut: Proposed)
• Date au format YYYY-MM-DD
• Contexte clair sur le probleme/opportunite
• Decision explicite et non ambigue
• Au moins 1 consequence positive
• Au moins 1 consequence negative
• Au moins 1 alternative avec motif de rejet
• Notes d'implementation actionnables
• References pertinentes (ADR lies + ressources)
• Codes conformes (POS-001, NEG-001, etc.)
• Redaction precise et lisible

---

Regles importantes

1. Etre objectif: presenter faits et raisonnement
2. Etre transparent: documenter benefices et limites
3. Etre clair: eviter toute ambiguite
4. Etre specifique: donner des impacts concrets
5. Etre complet: ne pas omettre de section
6. Etre coherent: respecter structure et systeme de codes
7. Etre a jour: utiliser la date courante sauf indication contraire
8. Etre connecte: citer les ADR lies quand pertinent
9. Etre contextuellement correct: s'appuyer sur l'etat reel du depot

---

Criteres de succes de l'agent

Le travail est termine quand:

1. Le fichier ADR est cree dans /docs/adr/ avec le bon nom
2. Toutes les sections obligatoires sont renseignees utilement
3. Les consequences refletent fidelement les impacts
4. Les alternatives sont documentees avec motifs de rejet clairs
5. Les notes d'implementation sont actionnables
6. Le document respecte les standards de format
7. La checklist qualite est satisfaite