📋 ADR (Architecture Decision Records)

Formaliser en 30-60 minutes un ADR rigoureux pour chaque choix structurant, qui prendrait 2-3 heures à rédiger from scratch.

Les ADR (Architecture Decision Records) documentent les choix structurants : pourquoi PostgreSQL plutôt que MongoDB, pourquoi Kafka plutôt que RabbitMQ, pourquoi tel pattern d'authentification. Bien rédigés, ils sauvent des années de "pourquoi on a choisi ça déjà ?" et facilitent l'onboarding. L'IA permet de les produire rapidement avec rigueur. Ce guide présente le workflow.

Workflow étape par étape
1
Décrire le contexte de la décision

Quel problème on résout, quelles contraintes (perf, équipe, budget, time-to-market), quelles options ont été considérées, qui décide et qui est impacté.

2
Lister les options envisagées

Au moins 3 options sérieuses avec leurs caractéristiques. L'IA aide à structurer (pas oublier les évidences ni inventer les irréalistes).

3
Comparer sur des critères pertinents

Critères selon le contexte : performance, scalabilité, courbe d'apprentissage, écosystème, coût, maturité, lock-in. Score chaque option.

4
Décider et documenter le pourquoi

Décision retenue + raisons claires. Surtout : conséquences positives ET négatives, conditions de succès, signaux qui justifieraient de revisiter.

5
Versionner dans le repo

Format markdown dans /docs/adr/. Numéroté et daté. Reste consultable longtemps après que les protagonistes ont quitté l'équipe.

Prompts copiables
ADR complet sur un choix technique
Tu es architecte logiciel senior. Formalise un ADR pour cette décision :nn**Contexte** : [PROBLÈME À RÉSOUDRE]n**Contraintes** : [PERF, ÉQUIPE, BUDGET, TIMING]n**Options envisagées** : [LISTE 3-5 OPTIONS]n**Décision retenue** : [OPTION CHOISIE]n**Stack actuelle** : [CONTEXTE TECH]nnProduis un ADR au format Michael Nygard :nn## Statusn[Proposed / Accepted / Deprecated / Superseded by X]nn## Contextn[3-5 paragraphes : problème, contraintes, ce qui a déclenché la réflexion]nn## Options Consideredn### Option 1 : [NOM]n- Prosn- Consn- Coûts (apprentissage, dette, infrastructure)nn### Option 2 : [NOM]n[idem]nn## Decisionn[Option retenue + raisons claires]nn## Consequencesn### Positiven[3-5 conséquences positives attendues]nn### Negativen[2-4 conséquences négatives ou compromis assumés]nn## Conditions to Revisitn[Signaux qui justifieraient de re-questionner cette décision dans 12-24 mois]nnMarque [À VÉRIFIER] tout chiffre incertain (perf, coûts).
Comparatif technologies multi-critères
Pour ce choix : [TYPE DE TECH — ex : message broker, base de données, framework frontend]nn**Contexte** : [DÉTAILS]n**Contraintes** : [LISTE]nnCompare ces options sur des critères structurants :nn[OPTION 1] vs [OPTION 2] vs [OPTION 3]nnCritères :n1. **Performance** (latence, throughput, ressources)n2. **Scalabilité** (horizontale, verticale, limites)n3. **Maturité et écosystème** (versions stables, communauté, documentation)n4. **Courbe d'apprentissage** (équipe actuelle, recrutement)n5. **Lock-in et portabilité**n6. **Coût total** (licence, infrastructure, opérations)n7. **Sécurité et conformité**nnFormat : tableau comparatif avec scoring /10 par critère, puis recommandation argumentée.
Audit d'un ADR existant
Audite cet ADR :nn[ADR]nnProduis :n1. **Forces** : ce qui est bien fait (rigueur, clarté, exhaustivité)n2. **Faiblesses** : ce qui manque (options manquantes, conséquences négatives sous-estimées, pas de plan B)n3. **Mises à jour nécessaires** : étant donné l'évolution depuis la rédaction, qu'est-ce qui a changé dans le paysage techn4. **Recommandation** : ADR encore valide / à actualiser / à reconsidérernnReste constructif et factuel.
Outils recommandés
Claude Opus 4.5
Claude Opus 4.5
★ 4.9 (92) · 20 USD/mois

Claude Opus 4.5 : modèle premium d’Anthropic pour code, agents et tâches complexes en entreprise.

Pourquoi : Le meilleur reasoning sur les choix techniques complexes nécessitant la pesée multi-critères et l'anticipation des conséquences.

Claude AI
Claude AI
★ 4.9 (55) · Gratuit

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.

Pourquoi : Excellence sur la rédaction structurée et rigoureuse des ADR. Format Michael Nygard ou variante au choix.

Perplexity AI
Perplexity AI
★ 4.9 (211) · 20 USD/mois

Assistant de recherche IA qui fournit des réponses sourcées et vérifiables en temps réel.

Pourquoi : Pour benchmarker en temps réel avec sources fraîches (versions actuelles, retours d'expérience, comparaisons à jour).

ROI estimé
Temps gagné
70% sur la rédaction (30-60 min vs 2-3h)
Gain qualité
ADR systématiquement rigoureux, conséquences négatives explicitées
Coût
20-30€/mois
← Retour au guide Architecte logiciel
Ce site est enregistré sur wpml.org en tant que site de développement. Passez à un site de production en utilisant la clé remove this banner.