Compétence : Créer un ADR
Objectif
Enregistrer des décisions d'architecture durables afin que les futurs humains et agents ne les redécouvrent pas ou ne les contredisent pas.
Entrées
- Sujet de décision.
- Contexte et contraintes.
- Options envisagées.
- Décision recommandée ou sélectionnée.
Lectures obligatoires
docs/10-architecture/ARCHITECTURE.mddocs/10-architecture/FILE_WRITE_POLICY.mddocs/20-security/SECURITY_MODEL.md- ADR existants pertinents dans
docs/adrs/
Fichiers de sortie
docs/adrs/ADR-####-<slug>.md
Processus
- Déterminer si le changement nécessite un ADR.
- Trouver le prochain numéro d'ADR sans réutiliser les numéros existants.
- Rédiger le contexte, la décision, les alternatives, les conséquences et les documents connexes.
- Marquer le statut comme « Proposé » sauf si l'humain a accepté la décision.
- Lier aux PRD, documents d'architecture, documents de fonctionnalités et documents de sécurité concernés.
Conditions d'arrêt
Arrêter et demander une décision humaine si :
- La décision modifie la posture de sécurité, le comportement réseau, la télémétrie, les écritures de fichiers, l'authentification, les secrets, le cloud ou le MCP d'exécution.
- La décision demandée entre en conflit avec un ADR accepté.
- La décision n'est pas encore prise et doit rester une proposition.
Barre de qualité
- L'ADR explique pourquoi la décision existe, pas seulement ce qui a changé.
- Les alternatives et les conséquences sont honnêtes.
- Le statut est clair.
- Les documents connexes sont liés.