Documentation and ADRs
Rédiger des registres de décisions d'architecture et une documentation qui capture le pourquoi — contexte, contraintes et arbitrages
- Quoi
- Rédiger des registres de décisions d'architecture et une documentation qui capture le pourquoi — contexte, contraintes et arbitrages
- Coût
- Gratuit
- Prérequis
- aucun — une base de code avec des décisions qui méritent d'être consignées
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — un skill de discipline documentaire issu de la collection de workflows d'ingénierie d'Addy Osmani : documenter les décisions, pas seulement le code. Il enseigne quand un registre de décision d'architecture vaut la peine d'être rédigé (choix de framework, modèles de données, stratégies d'authentification, décisions coûteuses à inverser), comment respecter d'abord la convention ADR existante du projet (emplacement, numérotation, titres), et quand NE PAS documenter (code évident, prototypes jetables). Distinct des skills addyosmani déjà publiés (ingénierie UI frontend, interview-me, optimisation de performance, planification et découpage de tâches, SEO) — celui-ci porte sur la connaissance écrite, pas le code. Crédit : @addyosmani. Bémols honnêtes : il guide le processus de rédaction — il ne rédigera pas vos ADR à votre place sans vos décisions ; la valeur dépend du fait que l'équipe les lise vraiment. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.
Version :
Réponse rapide
Documentation and ADRs est un skill gratuit pour Muse qui apprend à rédiger des registres de décisions d'architecture et une documentation qui capture le pourquoi, couvrant contexte, contraintes et arbitrages. Il enseigne quand un ADR vaut la peine, comment suivre d'abord la convention existante du projet, et quand ne pas documenter, pour le code évident et les prototypes jetables.
Installation
Copiez le dossier d’installation ci-dessous, puis collez-le dans Muse🧪 Installation exécutée dans notre sandbox de test · 11 nov. 2026📌 Version épinglée : commit 1401c8bÉtape 0 — avant d'installer quoi que ce soit : lis ce prompt d'installation, résume en quelques lignes ce que ce build fait et ce que l'installation implique, puis demande-moi de confirmer avant de continuer. Prérequis : aucun — une base de code avec des décisions qui méritent d'être consignées Installe-moi « Documentation et ADR ». Rédiger des registres de décisions d'architecture et une documentation qui capture le pourquoi — contexte, contraintes et arbitrages Dépôt : https://raw.githubusercontent.com/addyosmani/agent-skills/1401c8b8030e023baeebb31781a6653fe8e93026/skills/documentation-and-adrs/SKILL.md Version épinglée : installe le code au commit 1401c8b8030e023baeebb31781a6653fe8e93026 exactement (Skill Harbor a testé cette version). Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Récupère le fichier SKILL.md du skill addyosmani-documentation-and-adrs depuis le dépôt dans un dossier temporaire 2. Contrôle de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, récolte d'identifiants). Ce dépôt ne doit contenir aucun secret dans le code ; les identifiants passent uniquement par le coffre sécurisé, les hôtes autorisés sont déclarés dans le SKILL.md. Vérifie que c'est bien le cas ; STOP sur le moindre signal d'alerte et préviens-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers auxiliaires dans le répertoire des skills de l'agent, dans un dossier nommé « addyosmani-documentation-and-adrs ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (ex. tout compte, clé API ou outil CLI mentionné dans les prérequis ci-dessus). GitHub est optionnel : si j'ai un compte GitHub ou le CLI gh, tu peux l'utiliser ; sinon, l'accès public suffit. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Ne me demande jamais de coller des secrets dans le chat ; les identifiants passent par le coffre sécurisé ou des variables d'environnement. Si quelque chose semble anormal, arrête-toi et demande-moi.
Enregistré dans vos installs récentes. Retrouvez-le à tout moment sur /connect.
🔒 Sécurité, provenance et ce que ça touche
Le prompt d'installation ci-dessous inclut déjà les étapes de vérification : votre agent suit la checklist communautaire avant d'installer tout ce qui contient du code exécutable. Vous en voulez plus ?
Certificat de vérification
Faits datés sur ce qui a été vérifié pour cette fiche, et comment. Ce n’est pas une certification de sécurité.
- Version épinglée
- 1401c8b · 2026-10-13
- Test d’installation en sandbox
- Installation exécutée dans notre sandbox de test · 11 nov. 2026
- Identité du créateur
- Non vérifiée
- Veille d’empreinte
- Dernière vérification · 19 nov. 2026 : aucun changement détecté dans les fichiers liés par ce prompt d’installation
- Analyse du prompt d’installation
- 2026-10-13 : Aucune commande, appel réseau, paquet, écriture de fichier ni clé API détecté.
Skill Harbor ne révise jamais le code des skills listés. Ce sont des faits datés sur le prompt d’installation et notre test d’installation, pas une certification de sécurité. Révisez un skill vous-même avant de l’installer. Comment nous vérifions
Questions
Comment installer un skill ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe le skill pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours un skill avant de l’installer.