PROJECT DOCUMENTATION GUIDELINES — Version 1.1
(Fichier standard à placer dans chaque projet ChatGPT — Seedmover / Synomap / Autobrr / Qbit / etc.)

---------------------------------------------------------------------

1. Rôle de la bibliothèque du projet
La bibliothèque du projet ChatGPT sert de cache de travail minimal, contenant uniquement les documents canoniques nécessaires à l’avancement actuel.

Ce n’est pas :
- une archive complète,
- un miroir du NAS,
- un Git bis.

Les archives et historiques vivent sur Git + NAS.

---------------------------------------------------------------------

2. Catégories recommandées de fichiers

- 00_ → Index, règles, checklists, overview
- 10_ → Specs canoniques
- 20_ → Documents métier
- 30_ → Référentiels techniques
- 40_ → Snapshots de scripts / états de référence
- 90_ → Optionnel — index d’archives

Limite système : 25 fichiers max par projet (ChatGPT Plus).

---------------------------------------------------------------------

3. Principe fondamental : un seul fichier canonique par bloc

Phase “design” : fichiers intermédiaires (A0, A1, A2…).

Phase “finalisation” : création d’un fichier unique :

10_SPEC__<Projet>_<Bloc>_Final.txt

Les fichiers intermédiaires sont supprimés de la bibliothèque mais archivés sur NAS/Git.

---------------------------------------------------------------------

4. Fichier INDEX (obligatoire)

00_INDEX__<Projet>__overview.txt

Doit lister :
- fichiers canoniques
- statut (FROZEN, DRAFT…)
- dates de mise à jour
- archives NAS/Git liées

---------------------------------------------------------------------

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

Avant toute session :
- Vérifier que l’INDEX correspond exactement aux fichiers actifs.
- Aucun fichier ne doit exister hors INDEX.
- Aucun fichier indexé ne doit manquer dans la bibliothèque.
- Si incohérence → correction obligatoire avant tout travail.

---------------------------------------------------------------------

6. Règles de maintenance documentaire

À chaque session :
1. Vérifier INDEX ↔ bibliothèque
2. Mettre à jour la spec canonique Final
3. Mettre à jour l’INDEX
4. Pousser sur NAS/Git
5. Nettoyer la bibliothèque (obsolètes / limites)

---------------------------------------------------------------------

7. Rôle de ChatGPT

ChatGPT doit :
- vérifier la cohérence INDEX ↔ bibliothèque
- proposer les corrections
- rappeler les MAJ à effectuer
- signaler les doublons, obsolescences
- surveiller la limite des 25 fichiers

---------------------------------------------------------------------

8. Règle d’équilibre

Un projet doit idéalement contenir :
- 1 INDEX
- 1 RULES
- 1 spec FINAL par bloc
- 1–2 docs métier
- 1–2 référentiels techniques
- 1–3 snapshots

Charge recommandée : 10–15 fichiers actifs.

---------------------------------------------------------------------

9. Règle de vérité

10_SPEC__…_Final.txt = Source-of-Truth du bloc  
Git + NAS = Source-of-Truth historique.

---------------------------------------------------------------------

10. Archivage

Tout fichier supprimé de la bibliothèque doit :
- être archivé sur NAS/Git
- être indiqué dans l’INDEX
- optionnel : apparaître dans 90_ARCHIVE_INDEX.txt

---------------------------------------------------------------------

11. Discipline générale

- Toujours vérifier INDEX ↔ bibliothèque avant de travailler
- Toujours finir par une MAJ documentaire
- Ne jamais laisser de fichiers obsolètes
- Ne jamais modifier un fichier sans vérifier s’il est canonique

---------------------------------------------------------------------

FIN DU DOCUMENT — Version 1.1