create-agents-md — génération d'AGENTS.md fondée sur le code source
Ce skill est une procédure outillée destinée à Claude dans le contexte du monorepo Carbon (ERP/MES/QMS open source de crbnos). Son rôle est de produire ou de mettre à jour le fichier AGENTS.md d'un package @carbon/* ou d'un module ERP, en s'appuyant exclusivement sur le code source réel — fonctions exportées, tables, chemins d'import — et jamais sur des suppositions ou sur le contenu d'un AGENTS.md voisin.
Quand l'utiliser
Le skill est déclenché dans trois situations : à la création d'un nouveau module ou package, lorsque l'audit de fraîcheur du conductor ou une commande /self-review signale un AGENTS.md obsolète, ou sur demande explicite. Il commence toujours par annoncer sa cible ("Using the create-agents-md skill — generating/refreshing the AGENTS.md for {target}."), ce qui permet de tracer l'activité dans les logs de conversation.
Workflow en cinq étapes
Le skill suit un enchaînement précis : identifier la cible (package ou module), lire le source via des commandes grep et ls ciblées, préserver les notes humaines si un AGENTS.md existe déjà, localiser les fichiers .ai/rules/ pertinents, puis rédiger le fichier selon un template prescriptif. Chaque bullet de l'AGENTS.md produit doit pouvoir être vérifié par un grep — les fonctions renommées ou supprimées ne doivent jamais apparaître.
Templates et budget de lignes
Deux templates sont fournis : l'un pour les modules ERP (apps/erp/app/modules/{name}/, 60–100 lignes), l'autre pour les packages partagés (packages/{name}/, ≤ 100 lignes). Les deux incluent des sections Safety (Always / Ask First / Never), des commandes de validation Turborepo/pnpm, et une section Rules References pointant uniquement vers des fichiers .ai/rules/ qui existent réellement dans le repo.
Anti-patterns documentés
Le skill liste explicitement les erreurs à éviter : lister des fonctions non vérifiées par grep, copier un AGENTS.md d'un module voisin, rédiger des bullets vagues du type « services handle data access » plutôt que de nommer la fonction exacte et expliquer ce qui casse si on ne l'utilise pas. Cette rigueur est centrale dans la philosophie du repo Carbon, où chaque agent doit pouvoir s'appuyer sur une documentation fiable et traçable.