PROJECT DOCUMENTATION GUIDELINES — VERSION COURTE v1.0

Objectif : mémo rapide pour se rappeler comment organiser la bibliothèque d’un projet ChatGPT.

--------------------------------------------------
1) Rôle de la bibliothèque
- Cache de travail minimal pour l’IA.
- Contient uniquement les documents canoniques utiles MAINTENANT.
- Pas une archive, pas un miroir NAS, pas un Git bis.

Archives complètes : NAS + Git.

--------------------------------------------------
2) Types de fichiers recommandés

- 00_ : INDEX, règles, checklists, overview
- 10_ : Specs canoniques (…_Final.txt)
- 20_ : Docs métier (scénarios, invariants, matrices stables)
- 30_ : Référentiels techniques (formats, états, tables, APIs)
- 40_ : Snapshots de scripts ou états de référence
- 90_ : Index d’archives / notes d’archives

Limite pratique : 25 fichiers max / projet (ChatGPT Plus).
Cible réaliste : 10–15 fichiers actifs.

--------------------------------------------------
3) Un seul fichier canonique par bloc

- Pendant le design : A0, A1, A2, notes…
- Quand c’est mûr : 10_SPEC__<Projet>_<Bloc>_Final.txt
- Les intermédiaires quittent la bibliothèque (archivés NAS/Git).

10_SPEC__…_Final.txt = vérité fonctionnelle pour le bloc.

--------------------------------------------------
4) INDEX obligatoire

Fichier : 00_INDEX__<Projet>__overview.txt

Doit lister :
- fichiers canoniques actifs
- statut (FROZEN / DRAFT / TO_UPDATE)
- dates de dernière mise à jour
- liens/chemins d’archives NAS/Git

--------------------------------------------------
5) Règle absolue : cohérence INDEX ↔ bibliothèque

Avant de bosser :
- Tout fichier actif doit apparaître dans l’INDEX.
- Aucun fichier actif “fantôme” (présent mais non listé).
- Aucun fichier manquant (indexé mais absent).
- Si incohérence → corriger d’abord, réfléchir ensuite.

--------------------------------------------------
6) Cycle d’une session

AVANT :
- Vérifier cohérence INDEX ↔ bibliothèque.
- Identifier quels blocs (A, B, C…) sont concernés.

PENDANT :
- Noter les décisions importantes.
- Identifier les impacts sur specs Final / docs métier.

APRÈS :
- Mettre à jour 10_SPEC__…_Final.txt.
- Mettre à jour 00_INDEX__… (statuts, dates, archives).
- Archiver les anciens fichiers sur NAS/Git.
- Nettoyer la bibliothèque (supprimer les obsolètes).

--------------------------------------------------
7) Règle d’équilibre

Pour un projet “sain” :
- 1 INDEX
- 1 RULES (guidelines complètes)
- 1 spec FINAL par bloc majeur
- 1–2 docs métier
- 1–2 référentiels tech
- 1–3 snapshots de scripts max

Objectif : rester lisible pour l’IA comme pour l’humain.

FIN — VERSION COURTE