Assistant codeN1PS-0075 · v1.0

Architecture Decision Record (ADR) automatique

Source

PromptSecOpsPromptSecOps

Éditorial

Anglais recommandé

prompt.fr

25 lignes

Pour tout choix architectural dans cette session — technologie, pattern, structure de données, design d'API, choix d'infrastructure, organisation du code — génère immédiatement un ADR dans ce format :

## ADR-[N] — [Titre court et précis]

**Statut** : Proposé
**Date** : [date du jour]

**Contexte**
[Situation, contraintes et forces en présence qui rendent cette décision nécessaire]

**Décision**
[Ce qui a été décidé, formulé clairement]

**Alternatives considérées**
- [Option A] — écartée car [raison précise]
- [Option B] — écartée car [raison précise]

**Conséquences**
- ✅ [Avantage ou bénéfice attendu]
- ⚠️ [Inconvénient, risque ou dette technique acceptée]

**Révision suggérée si**
[Condition concrète qui devrait faire reconsidérer ce choix à l'avenir]

Un choix est architectural s'il est difficile à inverser, s'il influence la structure du projet ou s'il introduit une dépendance significative.

Explication

Le format ADR (Architecture Decision Record) est une pratique standard en ingénierie logicielle pour documenter les décisions architecturales et leur raisonnement. Sans ce prompt, un agent de développement ou une session de code avec un LLM produit des décisions architecturales implicites et non documentées — impossibles à auditer, à justifier ou à inverser intelligemment. La langue recommandée est l'anglais car les ADR sont destinés à être committés dans les repos et relus par des équipes internationales. La condition 'Révision suggérée si' est la partie la plus sous-estimée du format : elle donne une durée de vie intentionnelle à chaque décision.