Documents et données · FICHE DU SKILL

create-architectural-decision-record

Des ADR structurés avec contexte, conséquences, solutions rejetées et notes d’implémentation.

Le meilleur usage

Équipes d’architecture qui documentent des choix techniques importants

Ce qu’il apporte

Recueillir les informations nécessaires + Rédiger un ADR standard

Limite principale

Un modèle fixe ne garantit pas que les éléments justifiant la décision soient complets ou exacts.

Premier risque

Décision non examinée présentée comme définitive. Les ADR générés ont par défaut le statut Proposed et peuvent contenir des parties prenantes ou justifications déduites. Exigez la revue du responsable avant acceptation et vérifiez le numéro séquentiel suivant avant l’écriture.

DATE ET PÉRIMÈTRE DES PREUVES

Trois vérifications distinctes

Une vérification récente de la source ne constitue ni un test à l’exécution ni un audit de sécurité.

Source amontVérifiée le 2026-09-24

Révision épinglée · 1f564408

Ouvrir la révision épinglée ↗
Fiche SkillSignalMétadonnées éditoriales

Mise à jour le 2026-09-24

Exécution et sécuritéNon vérifiées indépendamment

La revue de la source ne certifie ni le comportement ni la sécurité.

EN CLAIR

À quoi sert ce skill ?

Create Architectural Decision Record est un modèle GitHub Awesome Copilot destiné aux décisions d’architecture durables. Il consigne le contexte, la décision retenue, ses conséquences positives et négatives, les options rejetées, les notes de mise en œuvre, les parties prenantes et les références selon une structure Markdown prévisible.

Ce qu’il permet
  • Recueillir les informations nécessairesConfirmez le contexte, la décision, les options et les parties prenantes.
  • Rédiger un ADR standardGénérez un en-tête numéroté et des sections de conséquences codifiées.
  • Conserver les options rejetéesExpliquez pourquoi les options n’ont pas été retenues et ce qui pourrait changer ultérieurement.
Ses points forts
  • Produit des décisions prévisibles et lisibles par machine.
  • Exige de consigner les avantages et compromis au lieu de documenter uniquement l’option retenue.
Retour communautaireAucun avis vérifié

Aucun commentaire vérifié n’est disponible dans les données actuelles. Consultez la source indiquée pour les discussions récentes.

Lire la source ↗

INSTALLER SELON L’AGENT

Choisir votre agent

Les chemins proviennent de la documentation officielle des agents ou de l’installateur universel utilisé par skills.sh. La compatibilité dépend toujours de la fiche du skill.

Natif

La fiche actuelle de ce skill nomme explicitement cet agent. Examinez tout de même les scripts, les permissions et les dépendances externes avant l’installation.

Installation dans le projet (recommandée)
npx skills add github/awesome-copilot --skill create-architectural-decision-record --agent github-copilot
Installation personnelle
npx skills add github/awesome-copilot --skill create-architectural-decision-record --agent github-copilot -g

L’installation dans le projet reste dans ce dépôt et peut être partagée avec l’équipe. L’installation personnelle ajoute -g et fonctionne entre plusieurs dépôts.

Voir les chemins d’installation
Chemin du projet.agents/skills/create-architectural-decision-record/
Chemin personnel~/.copilot/skills/create-architectural-decision-record/
Documentation officielle de l’agent

Copilot accepte aussi .github/skills et .claude/skills dans le projet. Examinez les skills non fiables avant d’activer leurs scripts.

Voir la source du chemin ↗

PROCESSUS TYPIQUE

Des usages concrets

01

Recueillir les informations nécessaires

Confirmez le contexte, la décision, les options et les parties prenantes.

02

Rédiger un ADR standard

Générez un en-tête numéroté et des sections de conséquences codifiées.

03

Conserver les options rejetées

Expliquez pourquoi les options n’ont pas été retenues et ce qui pourrait changer ultérieurement.

AVANTAGES ET LIMITES

Ce qu’il apporte et ses limites

Points forts

  1. Produit des décisions prévisibles et lisibles par machine.
  2. Exige de consigner les avantages et compromis au lieu de documenter uniquement l’option retenue.

Limites

  1. Un modèle fixe ne garantit pas que les éléments justifiant la décision soient complets ou exacts.
  2. Le processus crée des ADR au statut Proposed, mais ne gère ni leur approbation, ni leur remplacement, ni leur gouvernance.

PUBLIC CONCERNÉ

Pour qui ?

→

Équipes d’architecture qui documentent des choix techniques importants

→

Dépôts qui ont besoin d’un historique de décisions consultable

AVANT UTILISATION

Risques à examiner

Moyen

Décision non examinée présentée comme définitive

Les ADR générés ont par défaut le statut Proposed et peuvent contenir des parties prenantes ou justifications déduites. Exigez la revue du responsable avant acceptation et vérifiez le numéro séquentiel suivant avant l’écriture.

SÉCURITÉ

Comprendre les permissions

  • Évitez d’intégrer des identifiants, schémas d’architecture privés ou détails exploitables dans des ADR largement diffusés.
  • Appliquez les règles de revue et de responsabilité du dépôt avant de faire passer le statut à Accepted.

Aucune certification de sécurité. Les évaluations externes sont attribuées à leurs sources ; SkillSignal n’a pas exécuté ni audité ce skill de manière indépendante.

DANS LE PAQUET

Fichiers répertoriés

SKILL.mdContenu du paquet amontLien vers la source

MOTS-CLÉS

ADRarchitecturedocumentation

Fiche éditoriale originale de SkillSignal fondée sur le commit d7e4ad98 de GitHub Awesome Copilot, vérifiée le 2026-09-23 ; elle n’a pas été exécutée ni certifiée sur le plan de la sécurité de manière indépendante.