40 lines
3.9 KiB
Markdown
40 lines
3.9 KiB
Markdown
|
# 36 — Charte de nommage : fiches, tickets, bases, outils (adoptée par l'utilisateur le 2026-10-15, lot NOM1)
|
||
|
|
|
||
|
|
- **Date :** 2026-10-15 | **Lot :** NOM1 (fiche NOM1-DOC) | **Entrée journal :** à verser par la DOC de clôture (aucun CHG réservé à ce jour pour ce doc) | **Décision de l'utilisateur :** « écrit la maintenant » (session Big Boss) ; charte et textes de skills « Approuvé tel quel » (2026-10-15) ; bases d'OPT : « Laisser en place » (2026-10-15)
|
||
|
|
- **Modèle :** Claude Sonnet 5.5 (`lp-writer`, N2)
|
||
|
|
- **Sources :** `Docs/Migration/etat/` (arborescence), `etat/OPT/OPT0/OPT0-TACHES.md`, `etat/OPT/BC/`, `etat/OB/OBA/OBA-T5-EVAL.md`, `Tools/LISEZMOI.md`, `etat/REPO/NUMEROS.md`
|
||
|
|
- **Public :** agents, pilotage
|
||
|
|
|
||
|
|
## 1. Constat
|
||
|
|
|
||
|
|
**Ce qui marche (à garder tel quel).**
|
||
|
|
- Livrables : `etat\<projet>\<lot>\<LOT>-<fiche>-<TYPE>.md`, avec le gabarit de rôle de `lp-doc/gabarits.md`.
|
||
|
|
- Numéros CHG, ERR et DOC réservés par `Tools\Numero.ps1` dans `etat\REPO\NUMEROS.md`, jamais « dernier + 1 ».
|
||
|
|
- Préfixes `lp-` (agents et skills du projet) et `sk-` (skills de méthode).
|
||
|
|
- Titres de session « niveau · lot ».
|
||
|
|
|
||
|
|
**Ce qui est flou.**
|
||
|
|
- **La lettre R a quatre sens** : tickets du gardien (`AMEL1-R10`), recherches (`R1` à `R11` de `etat\OPT\BC\`), recommandations d'audit (`R20` à `R24` d'`etat\OB\OBA\OBA-T5-EVAL.md`), et « R4 » d'OPT0 n'est pas « R4 » d'AMEL1.
|
||
|
|
- **Ids de fiche improvisés** : `A1`, `B2`, `C1`, `K0`, `K1`, `R10` dans `etat\OPT\OPT0\OPT0-TACHES.md`, sans règle de lettre ni d'ordre.
|
||
|
|
- **Profondeur inégale** : `etat\OPT\BC`, `OPT\DOC`, `OPT\REFAC` ne sont pas des lots, mais des bases ou des thèmes au même niveau que `OPT\OPT0`.
|
||
|
|
- **Outils de `Tools\` en deux langues** : `Numero.ps1`, `Corbeille.ps1`, `Traces.ps1` (français) à côté de `Snapshot.ps1`, `FileCheck.ps1`, `FicheStats.py` (anglais).
|
||
|
|
|
||
|
|
## 2. Les cinq règles
|
||
|
|
|
||
|
|
1. **Type de fiche par suffixe, liste fermée, puis numéro dans le lot.** Types : `CART`, `SPEC`, `IMPL`, `BUILD`, `VAL`, `DOC`, `RECH`, `PERF`, `INV`. Forme : `<LOT>-<TYPE>-<nn>`. Exemple : `OPT0-RECH-03`. Un type absent de la liste passe d'abord par l'utilisateur.
|
||
|
|
2. **Tickets du gardien en `<LOT>-T<n>`.** La lettre R n'est plus réutilisée pour une nouvelle fiche, ni pour un ticket, une recherche ou une recommandation. Exemple : `AMEL2-T4`.
|
||
|
|
3. **Bases durables hors des lots**, sous `etat\BASES\<BASE>\`, citées par les lots qui s'en servent (le lot cite la base, ne la copie pas). Exemple : `etat\BASES\BC\` (base de connaissance d'optimisation), citée par `OPT0-RECH-03`.
|
||
|
|
4. **Outils en « Verbe-Objet » français**, verbe à l'infinitif, objet en PascalCase. Exemple : `Mesurer-Cadence.ps1`. Les noms d'outils tiers restent tels quels (`PresentMon`, `PerfReportTool`).
|
||
|
|
5. **Pas de rétroactivité.** Rien d'existant n'est renommé : renvois du journal, du registre et des CHG, références d'assets Unreal, tickets déjà déposés. La charte s'applique aux nouveaux éléments (fiches, tickets, bases, outils) créés après son adoption.
|
||
|
|
|
||
|
|
## 3. Transition
|
||
|
|
|
||
|
|
- Les tickets et fiches en cours gardent leur nom jusqu'à leur clôture (par exemple `OPT0-TACHES.md` garde `A1`, `K0`, `R10`).
|
||
|
|
- Le déplacement des bases d'OPT (`BC`, `DOC`, `REFAC`) vers `etat\BASES\` a été soumis à l'utilisateur, qui a répondu **« Laisser en place »** (2026-10-15) : `BC`, `DOC` et `REFAC` restent sous `etat\OPT\`, rien n'est déplacé. La règle 3 vaut pour les nouvelles bases.
|
||
|
|
- Les anciens outils gardent leur nom ; un outil nouveau ou réécrit suit la règle 4, et l'ancien nom reste indexé dans `Tools\LISEZMOI.md` s'il est remplacé.
|
||
|
|
- Textes proposés pour les skills `lp-doc` et `lp-lot` : `etat\NOM\NOM1\NOM1-TEXTES.md` (à soumettre ; skills non modifiés).
|
||
|
|
|
||
|
|
## 4. Ce que la charte ne couvre pas
|
||
|
|
|
||
|
|
Le nommage des assets Unreal du contenu du jeu (préfixes `BP_`, `M_`, `T_`…) n'est pas traité ici. Il est réservé à un lot à part, si l'utilisateur le veut ; il touche des références d'assets et demande des garde-fous propres.
|