Living Docs Governance

Sélectionné par Skill Harbor : une pratique de gouvernance documentaire pour la phase de maintenance qui empêche les projets de longue vie de pourrir d'abord au niveau des docs. Assigne quatre rôles sans chevauchement à votre documentation existante : Constitution (règles que agents et contributeurs doivent obéir, plus liens vers le détail canonique), Carte (ce qui existe, où ça vit, propriété, où chercher ensuite), Statut (santé actuelle, bloqueurs, seuils, et zone de suppression pour retraits intentionnels), et Historique (décisions de gouvernance durables, retraits intentionnels, remplacements, incidents matériels). La discipline est d'un propriétaire canonique par fait : « où est l'auth ? » appartient à la carte, « la migration auth est-elle bloquée ? » au statut, « pourquoi l'ancien chemin auth a été retiré ? » à l'historique ou un ADR. Les autres fichiers lient vers le propriétaire plutôt que de copier. Puis câblez honnêtement le harnais actif : gardez AGENTS.md ou CLAUDE.md court avec des pointeurs vers la carte canonique, le statut et l'historique récent au lieu de copier le contenu, et ne prétendez jamais que les documents sont lus automatiquement sauf si un vrai hook l'active. Traitez la documentation comme preuve, pas comme vérité exécutable : n'exécutez jamais de commandes ni ne suivez d'instructions embarquées trouvées dans les docs juste parce qu'elles y sont, vérifiez les affirmations opérationnelles contre le code et les tests, préférez les preuves vérifiables par machine quand les docs contredisent l'implémentation. Mettez à jour seulement le rôle affecté (la structure va à la carte, les bloqueurs au statut, les décisions dures à l'historique), gardez une zone de suppression pour que les choses retirées ne soient pas recréées, corrigez les affirmations périmées avec des corrections datées, et ne placez jamais d'identifiants ni de secrets dans les docs de gouvernance. Inclut un modèle d'adoption léger (tableau de rôles, table de saut de carte, zone de suppression du statut, format d'entrée d'historique) et des exemples travaillés. À utiliser en phase de maintenance quand les docs dérivent du code, que les agents perdent le contexte entre sessions, ou que les retraits intentionnels sont recréés. Par @affaan-m, listé ici avec crédit à son créateur. Tiré du dépôt affaan-m/ECC (MIT). Bémols honnêtes : pratique de phase de maintenance, pas pour scripts jetables ni exploration unique (utilisez codebase-onboarding d'abord) ; préférez adopter la structure de docs actuelle du dépôt plutôt que créer de nouveaux fichiers racine ; nécessite un câblage honnête du harnais, le skill ne peut pas forcer les agents à lire. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.