feat(docs): définir la convention d'arborescence guidelines/docs/specific/
Contexte
Actuellement le bootstrap de guidelines/docs/specific/ produit un dossier plat. À mesure que les projets grossissent, ce dossier devient difficile à lire et son contenu impossible à prioriser : on ne sait pas quels fichiers sont chargés systématiquement vs uniquement par certains agents.
Cette convention a été implémentée dans oracle-fabricium/oxa-guidelines#155 et fait sens comme standard partagé.
Proposition
Adopter une arborescence à deux axes — nature du contenu × scope de chargement :
guidelines/docs/specific/
├── technical/
│ ├── core/ ← chargés via @-includes dans CLAUDE.md (toujours présents)
│ └── contextual/ ← chargés via docCategories par des agents spécifiques
└── functional/
├── features/ ← description des features produit (agents analyse/plan)
└── guides/ ← how-to et guides d'usage spécifiques
Sémantique des dossiers
| Dossier | Nature | Chargement |
|---|---|---|
technical/core/ |
Conventions, architecture, typage, tests, commandes |
@ dans CLAUDE-specific.md
|
technical/contextual/ |
Patterns spécialisés (errors, lifecycle, environment) |
docCategories agent |
functional/features/ |
Ce que le produit fait |
docCategories agent |
functional/guides/ |
Comment utiliser une feature |
docCategories agent |
Actions
-
Réorganiser les templates dans guidelines/docs/specific/selon cette arborescence -
Déplacer coding,architecture,testing,tech-stack,commands→technical/core/ -
Déplacer environment→technical/contextual/ -
Mettre à jour step3(copie récursive des templates) -
Mettre à jour step7: CLAUDE-specific.md passe aux@-includes ; cursor et copilot mis à jour avec les nouveaux chemins
Référence
Implémentation de référence : oracle-fabricium/oxa-guidelines!154