Créateur d'ADR
Créez des Architecture Decision Records (ADR) concis qui expliquent une décision, le contexte qui l'a imposée, les options envisagées et les conséquences acceptées.
Contrat d'activation
Utilisez cette compétence lorsque l'utilisateur demande un ADR, un enregistrement de décision d'architecture, un enregistrement de décision technique, ou tout enregistrement formel expliquant pourquoi un choix technique ou architectural a été fait.
Par défaut, passez en mode entretien sauf si l'utilisateur a déjà fourni suffisamment d'informations pour rédiger un ADR complet. Posez les questions d'entretien dans la langue de l'utilisateur. L'artefact ADR est en anglais sauf si l'utilisateur demande explicitement une autre langue.
Règles strictes
- Posez une question à la fois en mode entretien.
- Indiquez une fois au début de l'entretien que l'utilisateur peut sauter des questions ou arrêter l'entretien à tout moment.
- Maintenez un compteur dynamique de questions restantes estimées ; mettez-le à jour lorsque des dépendances apparaissent ou disparaissent.
- Recommandez des exemples de réponse courts lorsqu'ils aident l'utilisateur à répondre.
- Formatez les questions d'entretien en Markdown lisible, pas en texte brut.
- Remettez en question de manière constructive les réponses vagues, contradictoires ou sans justification avant de rédiger ; poursuivez si l'utilisateur dit explicitement de continuer quand même.
- N'inventez pas d'alternatives, d'avantages, d'inconvénients ou de justifications. Demandez lorsque des alternatives manquent.
- Utilisez
Acceptedlorsque la décision est déjà prise ; utilisezProposedpour les propositions, évaluations ou statuts incertains. - Écrivez ou modifiez des fichiers uniquement lorsque l'utilisateur demande explicitement un fichier/chemin.
Déroulement de l'entretien
Recueillez uniquement ce qui est nécessaire, en priorisant les dépendances :
- Titre et statut de la décision.
- Contexte : problème, contraintes, forces et pourquoi la décision est importante maintenant.
- Option ou proposition choisie.
- Options envisagées, avec avantages et inconvénients pour chacune.
- Conséquences : bénéfices, inconvénients, risques et compromis.
- Suivi uniquement lorsqu'il y a des actions ouvertes ou des questions non résolues utiles.
Format des questions :
### Question N — [question ciblée]
**Réponse recommandée :** [exemple court quand c'est utile]
**Pourquoi c'est important :** [brève raison]
**Questions restantes estimées :** ~M
Mini exemple :
### Question 1 — Cette décision est-elle déjà prise ou encore en cours de proposition ?
**Réponse recommandée :** "Acceptée — nous avons déjà choisi PostgreSQL pour les données de facturation."
**Pourquoi c'est important :** Le statut change si l'ADR enregistre un choix final ou une proposition en cours d'examen.
**Questions restantes estimées :** ~5
Contrat de sortie
Lisez assets/template-markdown.md avant de rédiger et remplissez cette structure.
Par défaut, retournez l'ADR final exactement comme un bloc de code Markdown et ne créez pas de fichiers. Si l'utilisateur a explicitement demandé un fichier/chemin, sauvegardez l'ADR à cet emplacement et résumez le chemin sauvegardé dans le chat.
Ne laissez jamais d'instructions génériques dans l'ADR final. Si l'utilisateur saute intentionnellement un détail obligatoire, utilisez TBD avec parcimonie et uniquement pour ce détail sauté.
Référence
- Modèle :
assets/template-markdown.md