Décisions (ADR)¶
Une ADR (Architecture Decision Record) documente une décision structurante : son contexte, les options envisagées, la décision prise, ses conséquences. Une fois actée, une ADR ne se modifie pas — si la décision évolue, une nouvelle ADR la supersede.
Ce kit utilise le format MADR léger : titre, statut, contexte, décision, conséquences. Pas de template SAFe, pas d'options en 10 axes — le minimum pour rendre la décision lisible dans trois ans.
Les 11 ADR¶
| N° | Titre | Statut | Lien |
|---|---|---|---|
| 0001 | Distribution via submodule git | Accepté | Lire |
| 0002 | Prompts Copilot plutôt que serveur MCP | Accepté | Lire |
| 0003 | PowerShell pour les hooks | Accepté | Lire |
| 0004 | schema.js comme source de vérité |
Accepté | Lire |
| 0005 | LIVING/COLD comme invariant central | Accepté | Lire |
| 0006 | safeResolve en mode NEEDS-REVIEW | Accepté | Lire |
| 0007 | MkDocs Material pour la living doc | Accepté | Lire |
| 0008 | Déploiement IONOS mutualisé via SFTP + GitHub Actions | Accepté | Lire |
| 0009 | Intégration Nick Tune dans sdeg-kernel v3 (PRD, harness tâches, rétrospective) | Accepté | Lire |
| 0010 | Schéma frontmatter pour la métacognition gate-aware | Accepté | Lire |
| 0011 | Phase narrative pre-G1 (Domain Storytelling, Event Storming, champ recommends) |
Accepté | Lire |
Template MADR léger¶
Pour rédiger une nouvelle ADR, copier cette structure :
---
title: "NNNN — <Titre court>"
status: Proposé | Accepté | Remplacé par ADR-XXXX | Obsolète
date: AAAA-MM-JJ
---
# ADR NNNN — <Titre>
## Contexte
<Quelle tension ou quel problème a provoqué cette décision ?>
## Options envisagées
- <Option 1>
- <Option 2>
- <Option 3>
## Décision
<Ce qui a été retenu, en une à trois phrases.>
## Conséquences
- **Positives** : …
- **Négatives** : …
- **Neutres** : …
## Références
- Lien vers les vagues concernées
- Lien vers les skills ou portes affectés
Règles de vie des ADR¶
- Une ADR se numérote une seule fois. Si elle est remplacée, garder le numéro et marquer « Remplacé par ADR-XXXX ». Ne pas supprimer.
- Une décision sans ADR est une décision fragile. Si une question revient plusieurs fois, c'est qu'elle mérite une ADR.
- Une ADR trop longue est un symptôme : soit la décision est mal cadrée, soit on mélange plusieurs décisions. Fragmenter.
- Les ADR sont liées aux vagues : chaque nouvelle vague peut remplir des ADR, mais aussi en remplacer d'anciennes.
Voir aussi : Journal des vagues · Vision.