adr-skill : gestion des ADRs pour agents de code
Ce skill est une implémentation complète et fonctionnelle destinée à Claude pour créer, consulter, mettre à jour et gérer des Architecture Decision Records (ADRs) dans un repository de code. Il fait partie du repo vercel/ai, le SDK TypeScript open-source d'Anthropic et Vercel pour construire des applications et agents alimentés par l'IA.
Philosophie centrale
La particularité de ce skill est son orientation agent-first : les ADRs produits sont conçus comme des spécifications exécutables. Un humain approuve la décision, un agent l'implémente. Chaque ADR doit être autosuffisant — contraintes mesurables, plan d'implémentation précis (fichiers à toucher, patterns à suivre, tests à écrire), critères de vérification sous forme de cases à cocher. Aucune connaissance tribale implicite n'est tolérée.
Un workflow en quatre phases
Le skill structure la création d'un ADR en quatre phases non optionnelles : Phase 0 (scan du codebase pour trouver les ADRs existants et le contexte technique), Phase 1 (interview Socratique one-by-one pour capturer l'intention, avec une gate de confirmation avant de passer à la suite), Phase 2 (rédaction de l'ADR à partir d'un template adapté et génération du fichier via scripts), et Phase 3 (revue contre une checklist d'agent-readiness incluse dans le skill). Des scripts utilitaires (new_adr.js, set_adr_status.js, bootstrap_adr.js) et des templates (adr-simple.md, adr-madr.md) sont fournis dans le dossier du skill.
Utilisation dans un projet
Pour exploiter ce skill, il suffit de le référencer dans la configuration Claude de votre projet. Claude pourra alors proposer proactivement la création d'ADRs lorsqu'il détecte une situation qui le justifie (nouvelle dépendance, nouveau pattern architectural, choix entre alternatives non triviales), consulter les ADRs existants avant d'implémenter des changements, ou gérer le cycle de vie complet d'un ADR (acceptation, dépréciation, supersession, mise à jour de l'index).