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 :
Installation
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://github.com/addyosmani/agent-skills/blob/main/skills/documentation-and-adrs/SKILL.md 1. Récupère le fichier SKILL.md du skill addyosmani-documentation-and-adrs depuis le dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 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.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création 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 une création avant de l’installer.