ADRs (Architecture Decision Records) document architectural choices: why PostgreSQL over MongoDB, why Kafka over RabbitMQ, why this authentication pattern. Well written, they save years of "why did we choose that again?" and facilitate onboarding. AI enables you to produce them quickly with rigor. This guide presents the workflow.
What problem we're solving, what constraints (performance, team, budget, time-to-market), what options were considered, who decides and who is impacted.
At least 3 serious options with their characteristics. AI helps structure (don't forget the obvious or invent unrealistic ones).
Criteria depending on context: performance, scalability, learning curve, ecosystem, cost, maturity, lock-in. Score each option.
Decision chosen + clear reasons. Especially: positive AND negative consequences, success conditions, signals that would justify revisiting.
Markdown format in /docs/adr/. Numbered and dated. Remains consultable long after the protagonists have left the team.

Claude Opus 4.5 : modèle premium d’Anthropic pour code, agents et tâches complexes en entreprise.
Why : Le meilleur reasoning sur les choix techniques complexes nécessitant la pesée multi-critères et l'anticipation des conséquences.

Assistant conversationnel d’Anthropic axé sécurité et contexte long. Excellent pour rédaction, analyse, résumés, code et agents. Interface claire, bons résultats en français.
Why : Excellence sur la rédaction structurée et rigoureuse des ADR. Format Michael Nygard ou variante au choix.

Assistant de recherche IA qui fournit des réponses sourcées et vérifiables en temps réel.
Why : Pour benchmarker en temps réel avec sources fraîches (versions actuelles, retours d'expérience, comparaisons à jour).