Rôle du skill
Ce skill définit le processus complet de rédaction de spécifications fonctionnelles pour le projet Carbon, un ERP/MES/QMS open source pour la fabrication. Il s'active dès qu'une évolution touche plusieurs modules, modifie le schéma de données ou introduit un nouveau comportement transversal — et reste inactif pour les petits correctifs ou les refactorisations à un seul fichier.
Principe central : l'interview avant le document
Le workflow imposé par ce skill est délibérément séquentiel : Claude commence par explorer le contexte du codebase Carbon, effectue une recherche sur les pratiques ERP concurrentes (SAP, NetSuite, etc.), puis identifie toutes les questions ouvertes avant d'écrire une seule ligne de spec. Le fichier .ai/specs/{YYYY-MM-DD}-{slug}.md n'est créé qu'une fois chaque question résolue avec l'utilisateur. Ce séquencement évite le cycle coûteux « écrire autour d'hypothèses → remanier après les vraies réponses ».
Structure en huit étapes
Le skill organise le travail en huit étapes : cadrage de la demande, lecture du contexte Carbon (specs précédentes, leçons apprises, conventions de modules), recherche concurrentielle via /research, formulation des décisions de design et des questions ouvertes, interview utilisateur via /grill, rédaction de la spec à partir du template officiel, traitement des questions découvertes à l'écriture, et finalisation avec changelog. Une table de sept heuristiques (multi-tenancy, forme des services, RLS, permissions, formulaires, layout de module, compatibilité ascendante) sert de grille de contrôle pour chaque entité nouvelle ou modifiée.
Utilisation dans le repo Carbon
Dans l'arborescence du projet, ce skill fait partie du répertoire .ai/skills/ aux côtés d'autres skills complémentaires (/grill, /research, /plan, /feature). Il lit ses règles depuis .ai/rules/, ses conventions depuis .ai/docs/module-conventions.md, et produit ses artefacts dans .ai/specs/ et .ai/research/. Un mode autonome (boucles headless sans humain disponible) est prévu : les décisions prises de façon autonome sont explicitement marquées comme telles pour revue humaine lors de la pull request.