175 lines
12 KiB
Markdown
175 lines
12 KiB
Markdown
Fiche README-T2 — Niveau N2 — Modèle prévu opus | utilisé claude-opus-5-5 (orchestrateur, sans sous-agent)
|
|
|
|
# README-SPEC — réécriture de l'index `Docs/README.md` (copie 5.8, branche `ue5.8`)
|
|
|
|
Source des faits : `README-T1-INV.md` (relevé du 2026-10-10). Décision utilisateur du 2026-10-10 : « réactualise le README,
|
|
il n'est plus d'actualité 4.27 -> 5.5 » ; fichier visé : `Docs/README.md` (index) ; le `README.md` racine public n'est
|
|
**pas** touché.
|
|
|
|
## 1. Objectif mesurable
|
|
|
|
`Docs/README.md` devient l'index de la copie 5.8 : titre et état actuels, table des 32 docs avec colonnes **Statut** et
|
|
**Public** vérifiées une par une, plages `CHG-001` à `CHG-<max>` et `ERR-001` à `ERR-<max>` égales aux maximums relus
|
|
dans les fichiers au moment de l'écriture, historique 4.27 → 5.5 conservé dans une section « Historique ».
|
|
Aucun doc 01-32 modifié.
|
|
|
|
## 2. Fichiers touchés, ordre
|
|
|
|
1. `Docs/README.md` (réécrit) — **après `README-GO` de Big Boss** seulement (conflits : STE-R3 fait, `073f9df` ; OBP-T2 à venir).
|
|
2. `Docs/Journal_Modifications.md` : une entrée CHG (réservée sous verrou dans `etat/REPO/NUMEROS.md`), écrite au moment
|
|
du commit, sous jeton du journal accordé par Big Boss. La plage de l'index inclut alors ce CHG.
|
|
3. `etat/DOC/README/` : `README-TACHES.md`, `README-T1-INV.md`, cette SPEC, `README-IMPL.md`, `README-VAL.md`, `README-INT.md`.
|
|
4. `etat/REPO/NUMEROS.md` (ligne de réservation), `etat/REPO/tickets/README-R1.md`.
|
|
|
|
## 3. Structure proposée du nouvel index
|
|
|
|
```
|
|
# LifePlay — documentation de la copie UE 5.8 (branche ue5.8) : point d'entrée
|
|
> bandeau emplacements (DOCMV, CHG-300 ; DC3) — fusion des deux bandeaux actuels
|
|
## État au 2026-10-10
|
|
## Organisation du travail
|
|
## Documents (table 01-32 : Document | Statut | Public | Contenu ; puis journal, registre, correctifs/, etat/)
|
|
## Ordre de lecture conseillé
|
|
## Démarrer une session de travail
|
|
## Historique : migration 4.27 → 5.5 (V1, branche main)
|
|
```
|
|
|
|
### 3.1 Bandeau (texte proposé)
|
|
|
|
> Copie de travail `D:\Game\LifePlay-master 5.8`, branche `ue5.8` (la copie 5.5 et `main` portent la V1 et ses
|
|
> publications). Depuis le lot DOCMV (2026-10-10, CHG-300), cet index, le journal, le registre, les docs 01-32 et
|
|
> `correctifs/` sont dans `Docs/` ; `Docs/Migration/` ne garde que `etat/`, gestion des lots. Dans ces docs, `etat/…`
|
|
> désigne `Docs/Migration/etat/…`. Depuis le lot DC3 (2026-10-07), l'atelier de mods (scripts, `ModSources/`,
|
|
> `AnimSources/`) est dans le dépôt addon `LifePlay-Sandbox`.
|
|
|
|
### 3.2 « État au 2026-10-10 » (texte proposé, chaque point avec sa source)
|
|
|
|
- **Migration UE 5.5 → 5.8** : audit UA, porte G-U et lots U0 à U7b clos (doc 27, frontmatter ; doc 28 § 6) ; **U8**
|
|
(Shipping, publication de la V2.0) différé après la stabilisation et l'optimisation, décision du 2026-10-09 (doc 27,
|
|
frontmatter ; doc 29, `overview`) ; **U9** (voie UE5 native) différé après la V2.0.
|
|
- **Stabilisation V2, projet ST** (doc 29) : lots STA, STB, STC, STD, STE, STF, STM ; registres dans `etat/ST/<lot>/`.
|
|
- **Audit d'obsolescence et optimisation, projet OB** (doc 30) : lots OBA, OBB, OBP ; registres dans `etat/OB/<lot>/`.
|
|
- Dernière version publiée : tag `v1.5` (UE 5.5) ; aucune version 5.8 publiée.
|
|
|
|
### 3.3 « Organisation du travail » (texte proposé)
|
|
|
|
- Organisation des agents : doc 32 (chef de projet, orchestrateur, managers ; Big Boss, D-AG10, décidé le 2026-10-10 ;
|
|
gardien du dépôt, § 10).
|
|
- **Big Boss** : file de compilation (ordre de passage sur la copie UE, gels annoncés) et arbitrage des conflits entre
|
|
chefs de projet, orchestrateur et agents (fichiers, numéros, priorités entre lots) (doc 32, l. 64 et D-AG10) ;
|
|
journal des arbitrages `etat/BOSS/BOSS-JOURNAL.md`.
|
|
- **Gardien du dépôt** (agent `lp-gardien`) : seul à écrire dans git, sur ticket `etat/REPO/tickets/`, sous verrou
|
|
`etat/REPO/VERROU` ; règle R-REPO1 (statut du ticket et ligne de `REPO-JOURNAL.md` dans le même commit) ; skill `lp-repo`.
|
|
- **Numéros** CHG, ERR et doc réservés sous verrou dans `etat/REPO/NUMEROS.md`.
|
|
- **Jeton du journal** : une seule session écrit le journal à la fois, au moment de son commit, sur jeton accordé par
|
|
Big Boss (pratique consignée dans `BOSS-JOURNAL.md` et les tickets ; **pas encore décrite dans le doc 32**).
|
|
- Méthode d'un lot : skills `lp-lot`, `lp-doc` (`gabarits.md`), `lp-repo` ; livrables dans `etat/<projet>/<lot>/`.
|
|
|
|
### 3.4 Table des docs (proposition, une ligne par doc vérifiée dans le fichier)
|
|
|
|
Colonne « Contenu » : texte actuel de l'index conservé, sauf corrections notées. Colonne « Statut » : ce que déclare le
|
|
doc (bandeau, en-tête, frontmatter), voir Q2.
|
|
|
|
| Doc | Statut proposé | Public proposé | Correction du contenu |
|
|
|---|---|---|---|
|
|
| 01 | historique 4.27 (bandeau) | tous : architecture du jeu | — |
|
|
| 02 | historique 4.27 (bandeau) | historique | — |
|
|
| 03 | historique 4.27 (bandeau) | historique | « catalogue des tests de la V1 » |
|
|
| 04 | historique 4.27 (bandeau) | historique | — |
|
|
| 05 | historique 4.27 (bandeau) | historique | — |
|
|
| 06 | historique 4.27 (bandeau) ; V1 validée, `v1.0` | historique | — |
|
|
| 07 | historique 4.27 (bandeau) | tous : architecture du jeu | — |
|
|
| 08 | référence, rédigée pour 5.5 (chaîne 5.8 : renvoi au 27) | développeurs | — |
|
|
| 09 | référence ; atelier de mods dans l'addon (DC3) | développeurs | — |
|
|
| 10 | voir Q3 | voir Q3 | — |
|
|
| 11 | historique 4.27 (bandeau) | historique | — |
|
|
| 12 | historique 4.27 (bandeau) | historique | — |
|
|
| 13 | protocole (établi en O7e) ; scripts dans l'addon (DC3) | moddeurs, développeurs | — |
|
|
| 14 | lot UI14 (avant la V1.4) | historique | — |
|
|
| 15 | V1.4 | développeurs (publication) | — |
|
|
| 16 | étude et prototype H3a à H3d ; scripts dans l'addon (DC3) | développeurs, moddeurs | — |
|
|
| 17 | historique 4.27 (bandeau) | historique | — |
|
|
| 18 | référence (mesure) | développeurs | — |
|
|
| 19 | plan de lot ; gates I0 à I6 mesurés | pilotage | — |
|
|
| 20 | étude, lots AP1 à AP7 ; scripts dans l'addon (DC3) | développeurs | — |
|
|
| 21 | lots S0-S8 et SB0-SB4 (titre « ébauche, 2026-10-06 ») | développeurs | — |
|
|
| 22 | évaluation (S8, CHG-220) | pilotage | — |
|
|
| 23 | référence ; scripts dans l'addon (DC3) | développeurs, moddeurs | — |
|
|
| 24 | plan clos : DC0 à DC4 `completed` | pilotage | — |
|
|
| 25 | référence ; V1 du chantier close (VQ4) | développeurs | — |
|
|
| 26 | évaluation (VQ5) | pilotage | — |
|
|
| 27 | plan en cours : UA à U7b `completed`, U8 et U9 `pending` | pilotage | — |
|
|
| 28 | synthèse ; journal des lots U0 à U7b | pilotage | — |
|
|
| 29 | projet en cours ; frontmatter « phase 0 `in_progress` », point d'étape du 2026-10-10 | pilotage | — |
|
|
| 30 | projet en cours ; frontmatter « phase 0 `in_progress` » ; lots OBA, OBB, OBP | pilotage | — |
|
|
| 31 | évaluation (STAT1, CHG-271) | pilotage | — |
|
|
| 32 | en-tête « proposition (phase 0) » ; D-AG10 décidé, lot AG appliqué (CHG-299) | tous les agents, pilotage | — |
|
|
|
|
Lignes suivantes conservées : journal (`CHG-001` à `CHG-<max>`, note « CHG-048 absent »), registre (`ERR-001` à
|
|
`ERR-<max>`), `correctifs/` (P01 à P06, historique 4.27 → 5.5), `Migration/etat/` (texte actuel, plus `BOSS/` et `REPO/`).
|
|
|
|
### 3.5 « Ordre de lecture conseillé » (proposé)
|
|
|
|
1. Où en est le projet : cet index, puis 29 (ST) et 30 (OB) ; migration 5.8 : 27 et 28.
|
|
2. Travailler sur le projet : 32 (organisation), skills `lp-lot` / `lp-repo`, 08 (guide), 09 (commandes).
|
|
3. Comprendre le jeu : 01 puis 07 (historiques, toujours valables pour l'architecture).
|
|
4. Retrouver pourquoi une chose est ainsi : journal, registre, `etat/<projet>/<lot>/`.
|
|
|
|
### 3.6 « Démarrer une session de travail » (proposé)
|
|
|
|
Bloc PowerShell conservé (outils présents) sans `git tag --list '*-valide'` (0 tag) ; remplacé par
|
|
`git tag --list --sort=-creatordate | Select-Object -First 5`. Phrase finale : choisir le lot dans le registre du projet
|
|
(`etat/ST/…`, `etat/OB/…`) ou dans le doc 29 / 30 au lieu du cahier 04.
|
|
|
|
### 3.7 « Historique : migration 4.27 → 5.5 » (section conservée)
|
|
|
|
Contenu actuel déplacé tel quel : reprise du 2026-09-29, état au 2026-10-02 (V1 `v1.0`, V1.1 `v1.1`, L7a à L7l,
|
|
8 563 paquets), liste des docs « historique 4.27 » (01-07, 11, 12, 17, `Docs/Architecture/…`, une seule fois),
|
|
commandlets `LPFix*` retirés en U2 (tag `U2-avant`), ajout « publications suivantes : `v1.2` à `v1.5` ».
|
|
|
|
## 4. Risques R#, questions Q#
|
|
|
|
- R1 : conflit d'écriture avec OBP-T2 ou une autre session sur `Docs/README.md` → écriture seulement après `README-GO`.
|
|
- R2 : plage CHG périmée au commit (d'autres CHG écrits entre l'écriture et le commit) → plages relues juste avant le
|
|
ticket, sous jeton du journal.
|
|
- R3 : statut d'un doc affirmé sans preuve → chaque statut cite le fichier (VAL le recontrôle).
|
|
|
|
Questions pour l'utilisateur (liste fermée) :
|
|
|
|
| # | Question | Options | Recommandation |
|
|
|---|---|---|---|
|
|
| Q1 | Colonnes de la table | (a) `Document \| Statut \| Public \| Contenu` ; (b) garder `Document \| Pour qui \| Contenu` | **(a)** |
|
|
| Q2 | Statut d'un doc en retard sur le journal (29, 30, 32, 21 ; `README-T1-INV.md` § 4) | (a) statut déclaré par le doc, tel quel ; (b) statut déclaré + renvoi au CHG plus récent ; (c) statut réel d'après le journal | **(b)** : l'index ne contredit pas le doc et ne le réécrit pas ; les docs eux-mêmes restent à mettre à jour par leurs lots (suivi proposé à Big Boss) |
|
|
| Q3 | Doc 10 (« obligatoire avant toute modification », règles du 2026-09-29 au 2026-10-02) | (a) garder « obligatoire » ; (b) « référence (règles et leçons, V1) », méthode actuelle = `lp-lot` + doc 32 ; (c) passer en historique | **(b)** |
|
|
| Q4 | Autres contenus de `Docs/` (`Architecture/`, `Modding/`, `FAQ.txt`, `Game_Controls.txt`…) | (a) une ligne « Autres dossiers de Docs/ » ; (b) rien | **(a)** |
|
|
| Q5 | Structure § 3 et textes § 3.1 à 3.7 | (a) approuvés ; (b) à modifier (préciser) | — |
|
|
|
|
## 5. Interdits
|
|
|
|
Ne pas toucher le `README.md` racine, ni les docs 01-32, ni `Content\`, `Source\`, `etat\ST\`, `etat\OB\`, `etat\BOSS\`,
|
|
les skills. Aucune écriture git (gardien seul). Rien poussé. Pas d'éditeur ni de compilation.
|
|
|
|
## 6. Valeurs moteur
|
|
|
|
sans objet : lot documentaire, aucune valeur moteur.
|
|
|
|
## 7. Critères de VAL (commande → attendu)
|
|
|
|
| # | Contrôle | Commande | Attendu |
|
|
|---|---|---|---|
|
|
| V1 | Aucune doc oubliée | `ls Docs/[0-3][0-9]_*.md` comparé aux liens `](NN_…md)` de l'index | 32 / 32, aucun lien vers un fichier absent |
|
|
| V2 | Liens relatifs valides | tout `](cible)` de `Docs/README.md` résolu depuis `Docs/` (`test -e`) | 0 lien cassé |
|
|
| V3 | Plage du journal | max `^\| CHG-` du journal = borne écrite dans l'index | égalité |
|
|
| V4 | Plage du registre | max `^\| ERR-` du registre = borne écrite dans l'index | égalité |
|
|
| V5 | Statuts | pour chaque doc : statut de la table retrouvé dans le fichier (bandeau, en-tête ou frontmatter) | 32 / 32 |
|
|
| V6 | Historique conservé | les faits de l'ancien index (l. 9-14, 57-63) présents dans la section Historique | 100 % |
|
|
| V7 | Périmètre | `git status --porcelain` : seuls `Docs/README.md`, le journal et `etat/DOC/README/` (+ `NUMEROS.md`, ticket) modifiés par le lot ; `README.md` racine inchangé | conforme |
|
|
| V8 | Fins de ligne | `git ls-files --eol Docs/README.md` avant / après ; nombre de CR (`tr -cd '\r' \| wc -c`) | identique à l'avant |
|
|
|
|
## 8. Décisions de l'utilisateur (2026-10-10, questions fermées)
|
|
|
|
- Q1 et Q5 : structure § 3 et textes § 3.1 à 3.7 **approuvés** ; colonnes `Document | Statut | Public | Contenu`.
|
|
- Q2 : **(b)** statut déclaré par le doc, suivi d'un renvoi au CHG plus récent ; mise à jour des docs 21, 29, 30, 32
|
|
eux-mêmes proposée à Big Boss comme suite (hors lot).
|
|
- Q3 : **(b)** doc 10 = « référence (règles et leçons, V1) » ; méthode actuelle = `lp-lot` + doc 32.
|
|
- Q4 : **(a)** une ligne « Autres dossiers de Docs/ ».
|