Skip to content

docs(guidelines): #12 amorcer guidelines/steps/ et documenter {{step: name}}

Mathéo ALLARD requested to merge docs/12-guidelines-steps-readme into main

Résumé

  • guidelines/steps/.gitkeep : amorce le dossier, jusqu'ici absent du repo malgré son usage par scripts/lib/step-references.js (même logique que guidelines/agents/shared/ et guidelines/docs/shared/ : dossier vide versionné).
  • guidelines/steps/README.md : documentation générique du mécanisme {{step: name}} — syntaxe, structure attendue par step ({nom}/{nom}.md + metadata.json), résolution projet vs shared, comportement par outil cible (skill séparé pour Claude, inline pour les autres), et comment un fork peuple ce dossier pour ses projets consommateurs. Aucune référence oxa/oracle-fabricium : contenu entièrement générique, renvoie vers scripts/README.md pour le détail du pipeline.

Pas de step d'exemple réel : generateClaudeStepSkills génère un skill Claude pour chaque dossier présent dans guidelines/steps/, même non référencé — un vrai dossier d'exemple polluerait donc le skill Claude de tous les projets consommateurs. L'exemple attendu est documenté en bloc de code dans le README à la place.

Closes #12 (closed)

Vérifications

  • npm test — 236/236 tests OK
  • npm run lint — OK
  • node scripts/check-structure.js — 9/9 règles OK
  • Relecture manuelle : aucune mention oxa/oracle-fabricium dans le README

Merge request reports

Loading