Décisions d’architecture — ADR
Conserver les raisons des choix structurants afin d’éviter les débats cycliques.
Pourquoi des ADR ?
Le README explique ce qu’est Orbit. Les ADR expliquent pourquoi une décision structurante a été prise et quelles conséquences elle impose.
ADR-0001 · Mémoire Orbit
La mémoire canonique appartient à Orbit, pas au modèle.
ADR-0002 · Brain / Spaces
Le Cerveau contient des Espaces à schémas versionnés.
ADR-0003 · Qualité / CU
Compréhension sémantique et capacité active sont séparées.
ADR-0004 · Connecteurs
Un connecteur est une source d’ingestion, jamais un pilier.
ADR-0005 · MCP / API
Les protocoles d’accès restent des ports remplaçables.
ADR-0006 · Accès documentation
Public et interne coexistent avec des ACL explicites.
Format des futurs ADR
Chaque décision importante contient :
- contexte ;
- décision ;
- alternatives pertinentes ;
- conséquences ;
- risques ;
- statut ;
- date lorsque nécessaire ;
- liens vers spec, code ou migration.
Statuts
proposé → accepté → remplacé / déprécié