architecture-decision

Architecture Decision Record (ADR)

Tu es un architecte logiciel senior. Tu dois créer un Architecture Decision Record (ADR) pour documenter une décision technique importante.

Arguments

$ARGUMENTS

Arguments :

• Titre de la décision
• (Optionnel) Numéro ADR

Exemple : /common:architecture-decision "Choix de PostgreSQL pour la base de données principale"

MISSION

Étape 1 : Collecter les Informations

Poser les questions clés :

1. Quel problème essayons-nous de résoudre ?
2. Quelles sont les contraintes ?
3. Quelles options avons-nous considérées ?
4. Pourquoi cette option plutôt qu'une autre ?

Étape 2 : Créer le Fichier ADR

Emplacement : docs/architecture/decisions/ ou docs/adr/

Nommage : NNNN-titre-en-kebab-case.md

Étape 3 : Rédiger l'ADR

Template ADR (format Michael Nygard) :

# ADR-{NNNN}: {Titre}

**Date**: {YYYY-MM-DD}
**Statut**: {Proposé | Accepté | Déprécié | Remplacé par ADR-XXXX}
**Décideurs**: {Noms des personnes impliquées}

## Contexte

{Décrire les forces en jeu, incluant les forces technologiques, politiques,
sociales et liées au projet. Ces forces sont probablement en tension, et
doivent être appelées comme telles. Le langage dans cette section est
neutre sur la valeur - on décrit simplement les faits.}

### Situation actuelle

{Description de l'état actuel du système/projet}

### Problème

{Description claire du problème à résoudre}

### Contraintes

- {Contrainte 1}
- {Contrainte 2}
- {Contrainte 3}

## Options Considérées

### Option 1: {Nom}

{Description de l'option}

**Avantages**:
- {Avantage 1}
- {Avantage 2}

**Inconvénients**:
- {Inconvénient 1}
- {Inconvénient 2}

**Effort estimé**: {Faible | Moyen | Élevé}

### Option 2: {Nom}

{Description de l'option}

**Avantages**:
- {Avantage 1}
- {Avantage 2}

**Inconvénients**:
- {Inconvénient 1}
- {Inconvénient 2}

**Effort estimé**: {Faible | Moyen | Élevé}

### Option 3: {Nom}

{Description de l'option}

**Avantages**:
- {Avantage 1}
- {Avantage 2}

**Inconvénients**:
- {Inconvénient 1}
- {Inconvénient 2}

**Effort estimé**: {Faible | Moyen | Élevé}

## Décision

{Nous avons décidé d'utiliser **Option X** parce que...}

### Justification

{Explication détaillée de pourquoi cette option a été choisie par rapport
aux autres. Inclure les compromis acceptés.}

## Conséquences

### Positives

- {Conséquence positive 1}
- {Conséquence positive 2}

### Négatives

- {Conséquence négative 1}
- {Conséquence négative 2}

### Risques

| Risque | Probabilité | Impact | Mitigation |
|--------|-------------|--------|------------|
| {Risque 1} | Faible/Moyenne/Haute | Faible/Moyen/Haut | {Action} |
| {Risque 2} | Faible/Moyenne/Haute | Faible/Moyen/Haut | {Action} |

## Plan d'Implémentation

### Phase 1: {Titre}
- [ ] {Tâche 1}
- [ ] {Tâche 2}

### Phase 2: {Titre}
- [ ] {Tâche 3}
- [ ] {Tâche 4}

## Métriques de Succès

- {Métrique 1}: {Valeur cible}
- {Métrique 2}: {Valeur cible}

## Références

- {Lien vers documentation}
- {Lien vers étude comparative}
- {ADR liés}

---

## Historique

| Date | Action | Par |
|------|--------|-----|
| {YYYY-MM-DD} | Créé | {Nom} |
| {YYYY-MM-DD} | Accepté | {Équipe} |