Rédiger un Architecture Decision Record (ADR) au format Nygard

Ce prompt documente une décision d'architecture dans un ADR court, au format proposé par Michael Nygard : titre, statut, contexte, décision, conséquences. Il vous interroge d'abord sur les forces en présence et les options écartées, puis rédige un texte prêt à enregistrer dans le dépôt. Les conséquences négatives sont cherchées, pas oubliées.

Développement

Technologie

Avancé

Tous modèles

#ADR

#architecture logicielle

#documentation

#décision technique

#tech lead

Mis à jour le 07/10/2026

Créé par Sébastien GrillotLinkedIn

Recommandations pour de meilleurs résultats

Activez le mode raisonnement

Ce prompt donne de meilleurs résultats quand l'IA réfléchit avant de répondre. Dans ChatGPT, sélectionnez Réfléchir, ou le niveau Moyen ou Élevé du curseur Réflexion avec une offre payante. Dans Claude, montez le niveau d'effort depuis le menu du modèle, à côté du bouton d'envoi. Dans Gemini, choisissez le raisonnement étendu quand il est proposé.

Notes d'utilisation

À utiliser dès qu'une décision touche la structure, les dépendances, les interfaces ou les caractéristiques non fonctionnelles d'un système, c'est-à-dire le périmètre que Michael Nygard donne aux ADR dans « Documenting Architecture Decisions » (2011). Le format suit le sien ; la rubrique « options écartées » est un ajout pratique. Le prompt n'invente aucun chiffre de performance ni aucun coût : vérifiez chaque affirmation marquée « à vérifier » avant de passer le statut à « accepté ». Ne collez pas de schéma d'infrastructure contenant adresses internes ou identifiants.

Contenu du prompt

Cliquez sur les zones [en surbrillance] pour les personnaliser

# Rédiger un Architecture Decision Record (ADR) Tu es architecte logiciel. Tu m'aides à documenter une décision d'architecture au format proposé par Michael Nygard : titre, statut, contexte, décision, conséquences. La décision porte sur : . ## Avant de rédiger Pose-moi tes questions en une seule liste, puis attends mes réponses. Elles portent sur : - les forces en présence : contraintes techniques, délais, compétences de l'équipe, budget, exigences de sécurité ou de conformité ; - les options envisagées, y compris « ne rien changer » ; - les critères qui ont fait pencher la balance ; - qui décide, et si la décision est seulement proposée ou déjà acceptée. ## Règles - Tu n'inventes aucun chiffre de performance, aucun coût, aucune limite d'outil. Une affirmation technique qui ne vient pas de moi porte la mention « à vérifier ». - Le contexte décrit les forces de façon neutre, y compris celles qui s'opposent. - Les conséquences listent le positif, le négatif et le neutre. Si tu ne trouves aucune conséquence négative, cherche encore, puis dis-le explicitement. - Un ADR décrit une seule décision. Si mes réponses en contiennent plusieurs, propose de les séparer. ## Format de sortie (Markdown, prêt à enregistrer dans le dépôt) - Titre : « ADR : » suivi d'un groupe nominal court. - Statut : proposé, accepté, déprécié, ou remplacé par un autre ADR (à citer). - Contexte : les forces en présence. - Décision : en phrases complètes, à la voix active (« Nous allons… »). - Conséquences : positives, négatives, neutres. - Options écartées : une ligne chacune, avec la raison. ## Auto-vérification avant de répondre - Un développeur qui arrive dans un an comprend pourquoi cette décision a été prise, sans avoir assisté aux discussions. - Chaque affirmation technique vient de mes réponses ou porte la mention « à vérifier ». - Au moins une conséquence négative est identifiée, ou son absence est justifiée.

Comment utiliser ce prompt

Personnalisez le prompt

Remplissez les champs de personnalisation ci-dessus pour adapter le prompt à votre contexte

Copiez ou ouvrez dans votre IA

Utilisez les boutons pour copier le prompt personnalisé ou l'ouvrir directement dans ChatGPT, Claude ou Gemini

Ajoutez votre contenu spécifique

Complétez avec les éléments spécifiques à votre projet si nécessaire

Un bug ? Une question ?

Contactez directement Sébastien Grillot, l'auteur de ce contenu, pour signaler un problème ou poser vos questions.

Contacter sur LinkedIn

Les questions qui vous ont menés iciQuestions génériques

Comment utiliser l'IA pour mon marketing ?Quels outils d'automatisation choisir ?Comment optimiser mes processus digitaux ?Quelle stratégie digitale adopter ?

Questions génériques - des questions spécifiques amélioreront le référencement