ADR — Architecture Decision Record

Template utilisé par l'Architect pour documenter les décisions architecturales.

Output

docs/plans/{feature-name}.md

Structure

Contexte

Pourquoi cette décision est nécessaire. Quel problème architectural doit être résolu ?

Options considérées

Pour chaque option :

### Option A — [Nom]

**Description :** Explication concise.

- ✅ Avantage 1
- ✅ Avantage 2
- ❌ Inconvénient 1
- ❌ Inconvénient 2

Décision

## Décision

**Option retenue :** Option B

**Justification :** Explication de pourquoi cette option est la meilleure
dans le contexte actuel, avec les contraintes identifiées.

Conséquences

## Conséquences

### Impacts positifs
- Impact 1

### Impacts négatifs
- Compromis accepté 1

### Actions requises
- [ ] Action 1
- [ ] Action 2

Bonnes pratiques

• Documenter le pourquoi, pas juste le quoi
• Lister toutes les options envisagées, même rejetées
• Être honnête sur les inconvénients de l'option choisie
• Dater la décision — le contexte peut changer