architecture-decisions

Documenter, évaluer et gérer le cycle de vie des Architecture Decision Records (ADRs) — mémoire institutionnelle des choix architecturaux avec analyse de compromis.

Quand l’utiliser

Contrat d’entrée

Contrat de sortie

Invariants

Cycle de vie :

Proposed → Accepted   → Deprecated
         ↘ Rejected   → Superseded by ADR-{NNN}

Forces universelles à évaluer :

Force Question
Simplicité Est-ce que cela rend le système plus simple à comprendre et à modifier ?
Cohérence Est-ce que cela s’inscrit dans les patterns déjà établis dans la base de code ?
Performance Est-ce que cela satisfait les exigences de performance sans over-engineering ?
Testabilité Est-ce que cela facilite ou complique les tests automatisés ?
Évolutivité Est-ce que cela simplifie ou contraint les évolutions futures ?

Pourquoi cette forme

Les ADRs réduisent le coût de la dette architecturale en rendant explicite le raisonnement derrière chaque choix structurel. Sans eux, les équipes refont les mêmes débats avec les mêmes arguments — sans les contraintes originales qui les ont rendus nécessaires.

« Every pattern has a context, a problem, and a solution. Without the context, a pattern is a hammer looking for nails. » — Evans, E., Domain-Driven Design, 2003.

Customisation autorisée

Voir aussi