171 lines
15 KiB
Markdown
171 lines
15 KiB
Markdown
# DOCSTAT-SPEC : statuts et renvois des docs 08, 09, 21, 29, 30, 32
|
||
|
||
Fiche DOCSTAT-T2 — Niveau N2 — Modèle prévu claude-opus-5-5 | utilisé claude-opus-5-5
|
||
|
||
Lot DOC « DOCSTAT », copie 5.8 (`ue5.8`, HEAD `71511a2`). Décision de l'utilisateur du 2026-10-10 « 1 - 5 oui »
|
||
(`etat/BOSS/BOSS-JOURNAL.md` l. 192). Points du lot : 1, 2, 3, 5. Numéros de ligne relevés le 2026-10-10 sur l'arbre de
|
||
travail ; ceux de `BOSS-JOURNAL.md` seront relus juste avant le ticket (Big Boss y écrit encore).
|
||
|
||
## 1. Objectif mesurable (et relevé DOCSTAT-T1)
|
||
|
||
Après le lot : les docs 08 et 09 renvoient au doc 10 avec le statut de l'index ; les statuts des docs 21, 29, 30, 32
|
||
disent l'état prouvé par les registres et les commits ; le doc 32 décrit les règles en vigueur avec leurs sources ;
|
||
`BOSS-JOURNAL.md` est commité tel que Big Boss l'a laissé ; une entrée CHG et la plage de l'index en font la trace.
|
||
|
||
**Relevé (établi, lecture des fichiers) :**
|
||
|
||
| # | Fichier : ligne | Texte actuel (extrait) | Fait vérifié |
|
||
|---|---|---|---|
|
||
| R1 | `Docs/08_Guide_Developpeur.md:5` | « Méthode de travail obligatoire : `10_Protocole_Operations.md`. » | index `Docs/README.md:48` : doc 10 = « référence (règles et leçons, V1) ; méthode actuelle : skill `lp-lot` et doc 32 » |
|
||
| R2 | `Docs/09_Commandes_Utiles.md:4` | « Méthode : `10_Protocole_Operations.md`. » | même index ; **écart à la consigne** : la l. 4 du doc 09 ne dit pas « obligatoire », seulement « Méthode » ; alignée quand même (elle présente le doc 10 comme la méthode) |
|
||
| R3 | `Docs/21_Sandbox_Addon.md:1` | titre « (ébauche, 2026-10-06) » ; aucun autre champ de statut dans le doc | § Acceptation : S0 à S8 cochés, S8 « `S8-VAL.md` PASS » (l. 176) ; CHG-220 du 2026-10-06 (journal l. 1228) ; doc tenu depuis : pin « Copie 5.8 » `9227db8` (CHG-312), reports cochés jusqu'à CHG-308 |
|
||
| R4 | `Docs/29_Projet_Stabilisation_V2.md:7, 10, 13` | `phase0` `in_progress` ; `lot-sta` `pending` ; `gate-gst` `pending` | STA ouvert le 2026-10-09 avec décisions de l'utilisateur (`etat/ST/STA/STA-TACHES.md:8`) ; STA-T1 à T3, T2a2, T2b ×5, T2c acceptées, **STA-T4 « à faire »** (jamais faite) ; « **Porte G-ST validée** (« approuve le plan ») » (`STA-TACHES.md:17`) ; lots STB, STC, STD clos, STE, STF en cours (doc 29 l. 288-326 ; `BOSS-JOURNAL.md`) |
|
||
| R5 | `Docs/30_Projet_Audit_Obsolescence.md:7, 10, 13` | `phase0` `in_progress` ; `lot-oba` `pending` ; `gate-gob` `pending` | OBA : 7 fiches sur 7 acceptées dont OBA-T5 (synthèse → porte G-OB) (`etat/OB/OBA/OBA-TACHES.md`) ; porte G-OB **tenue en partie** : « OK pour traitement » de B1, B3, G-OB-6 (`etat/OB/OBB/OBB-TACHES.md:5-7`) ; OBB : EVAL « **GO conditionnel** » (`OBB-EVAL.md:186`) ; OBP clos (CHG-310, CHG-312) ; retraits et remplacements : après la sortie de ST (doc 30, O1, l. 35) |
|
||
| R6 | `Docs/32_Organisation_Agents.md:3-4` | « Statut : proposition (phase 0), décisions D-AG à valider \| Entrée journal : à prendre par le lot AG » | lot AG clos : `bdb8f6b` (addon 5.8), `a8dea6d` (addon), `ee9dce2`, `2cca224` (jeu), CHG-299 (`etat/AG/AG-TACHES.md`, clôture) ; en place : `lp-gardien`, `sk-repo`, `lp-repo`, Big Boss (D-AG10) ; **pas en place** : chef de projet, planificateur, 6 managers (aucun `lp-mgr-*` ni `lp-planificateur` dans `~/.claude/agents`, aucun `sk-manage`, `sk-plan`, `sk-chef`) ; D-AG1 à D-AG8 non tranchées (aucune trace hors du doc 32 et des brouillons) |
|
||
| R7 | `Docs/README.md:59, 67, 68, 70` (colonne Statut) | décrit l'état **actuel** des docs 21, 29, 30, 32 (« titre ébauche », « frontmatter phase 0 `in_progress` », « en-tête proposition (phase 0) ») | ces 4 cellules deviennent fausses après le lot → Q4 |
|
||
| R8 | `Docs/Migration/etat/BOSS/BOSS-JOURNAL.md` | ` M`, +103 lignes depuis `ee9dce2` (`git diff --stat`) | Big Boss continue d'y écrire |
|
||
|
||
Fins de ligne des 9 fichiers visés : `i/lf w/lf attr/-text` (`git ls-files --eol`). Aucun lien à ancre vers les titres
|
||
des docs 21, 29, 30, 32 (`grep` de `<doc>.md#` sous `Docs` et `.claude` : 0).
|
||
|
||
## 2. Fichiers touchés, ordre, texte exact
|
||
|
||
Un seul changement par ligne citée ; aucun autre octet modifié. Outil : Edit (jamais de script, `lp-doc`).
|
||
|
||
### 2.1 Point 1 — renvois au doc 10
|
||
|
||
**`Docs/08_Guide_Developpeur.md` l. 5**
|
||
- avant : `` > `09_Commandes_Utiles.md`. Méthode de travail obligatoire : `10_Protocole_Operations.md`. ``
|
||
- après : `` > `09_Commandes_Utiles.md`. Règles et leçons (référence, V1) : `10_Protocole_Operations.md` ; méthode actuelle : skill `lp-lot` et `32_Organisation_Agents.md`. ``
|
||
|
||
**`Docs/09_Commandes_Utiles.md` l. 4**
|
||
- avant : `` > `08_Guide_Developpeur.md`. Méthode : `10_Protocole_Operations.md`. ``
|
||
- après : `` > `08_Guide_Developpeur.md`. Règles et leçons (référence, V1) : `10_Protocole_Operations.md` ; méthode actuelle : skill `lp-lot` et `32_Organisation_Agents.md`. ``
|
||
|
||
### 2.2 Point 3 — statuts des docs 21, 29, 30
|
||
|
||
**`Docs/21_Sandbox_Addon.md` l. 1** (seul champ de statut du doc : le titre)
|
||
- avant : `# 21. Migration sandbox → addon éditeur (ébauche, 2026-10-06)`
|
||
- après : `# 21. Migration sandbox → addon éditeur (lots S0 à S8 clos, CHG-220 ; pin et registre des reports tenus à jour)`
|
||
|
||
**`Docs/29_Projet_Stabilisation_V2.md`** (frontmatter, valeurs `status` seules)
|
||
- l. 7 (`phase0`) : `in_progress` → `completed` (Q1)
|
||
- l. 10 (`lot-sta`) : `pending` → `completed` (Q2)
|
||
- l. 13 (`gate-gst`) : `pending` → `completed`
|
||
|
||
**`Docs/30_Projet_Audit_Obsolescence.md`** (frontmatter, valeurs `status` seules)
|
||
- l. 7 (`phase0`) : `in_progress` → `completed` (Q1)
|
||
- l. 10 (`lot-oba`) : `pending` → `completed`
|
||
- l. 13 (`gate-gob`) : `pending` → `in_progress`
|
||
|
||
Non touchés (hors « champs de statut ») : titres H1 « fiche projet (phase 0) » des docs 29 et 30 (le document est bien
|
||
la fiche de phase 0) ; aucune ligne `todos` ajoutée pour STB à STF ni OBB / OBP (le point d'étape du doc 29 les décrit).
|
||
|
||
### 2.3 Point 2 — doc 32 (plan de section)
|
||
|
||
1. **l. 3-4, en-tête** (remplacées par 2 lignes) :
|
||
`- **Date :** 2026-10-10 | **Statut :** appliqué en partie depuis le 2026-10-10 (lot AG, CHG-299 : gardien du dépôt,
|
||
Big Boss) ; chef de projet, planificateur et managers conçus, non mis en place ; D-AG1 à D-AG8 non tranchées |`
|
||
` **Entrée journal :** CHG-299 (lot AG) ; révision ci-dessous : entrée du lot DOCSTAT` (Q3 sur le mot « en partie »)
|
||
2. **après l. 17** (nouvelle puce de révision, 2 lignes) :
|
||
`- **Révision du 2026-10-10 (lot DOCSTAT, décision de l'utilisateur « 1 - 5 oui ») :** statut mis à jour ; règles en`
|
||
` vigueur au § 15, avec leurs sources ; la conception d'origine (§ 1 à § 14) n'est pas modifiée.`
|
||
3. **§ 15 ajouté en fin de fichier** (après l. 401), titre `## 15. En vigueur depuis le 2026-10-10 (révision DOCSTAT)`,
|
||
précédé de `---` comme les autres sections. Contenu (≈ 45 lignes, tout fait cité par `BOSS-JOURNAL.md` l. N ou fichier) :
|
||
- **15.1 Ce qui est en place, ce qui ne l'est pas** (tableau 2 lignes) : en place = Big Boss (l. 51), gardien seul
|
||
à écrire dans git (`sk-repo`, `lp-repo`, `lp-gardien` ; commits AG), une session par lot qui orchestre son lot et
|
||
lance elle-même le gardien sur ticket (l. 67 : « aucune session orchestrateur dédiée »), livrables sous
|
||
`Docs\Migration\etat\` seulement (l. 9-10) ; pas en place = chef, orchestrateur général unique, planificateur,
|
||
managers, `SUIVI`, `fiches/` (§ 11, § 13 ; `~/.claude/agents`).
|
||
- **15.2 File de compilation** : une session à la fois sur la copie UE ; `BUILD-DEMANDE` → `BUILD-ATTENTE <rang>` ou
|
||
`BUILD-GO` → `BUILD-FIN` ; **un `BUILD-GO` par fiche** ; travail hors copie UE libre ; prolongation d'un BUILD-GO
|
||
en cours seulement par Big Boss ; Big Boss contre-vérifie chaque `BUILD-FIN` (processus, MD5 des assets,
|
||
`git status`). Sources : l. 4-5, 34-35, 99, 108, 65.
|
||
- **15.3 Jeton du journal** : un seul rédacteur de `Docs/Journal_Modifications.md` à la fois ; `JOURNAL-DEMANDE` →
|
||
jeton → entrée → commit → `JOURNAL-LIBRE <hash>` ; ordre de disponibilité, qui n'est pas prêt cède ; **une entrée
|
||
CHG ne s'écrit que quand son commit est imminent** (le gardien vérifie que le diff du journal = la ligne du
|
||
ticket) ; la plage de l'index `Docs/README.md` suit dans le même commit. Sources : l. 83, 107, 117, 186.
|
||
- **15.4 R-REPO1** : statut `fait` du ticket et ligne de `REPO-JOURNAL.md` écrits avant le commit et inclus dedans,
|
||
sans hash (HEAD d'avant ; `git log --grep <TICKET>`). **Précision** : les traces d'un ticket sans commit (tag, pin,
|
||
config) partent avec le **prochain commit du dépôt, quel que soit le lot** ; `NUMEROS.md` et `REPO-JOURNAL.md`
|
||
partent **entiers** avec le premier commit du jeu qui les trouve modifiés. Sources : l. 63, 82, 83, 98 ;
|
||
`lp-repo` § 4.
|
||
- **15.5 `--amend` (ERR-087)** : un commit fautif non poussé se corrige par un nouveau commit ou un `git revert` ;
|
||
`--amend` seulement avec l'accord de l'utilisateur. Sources : `Docs/Registre_Erreurs.md` ERR-087 (corrigé,
|
||
CHG-302) ; `lp-repo` § 10 ; `sk-repo` § 9 aligné par Big Boss (l. 122) ; l. 103.
|
||
- **15.6 Gels et réservations de documents** : Big Boss peut geler des fichiers partagés pour un lot (seul ce lot les
|
||
écrit ; le reste d'`etat\` et la copie UE restent libres ; levée à la FIN-LOT contre-vérifiée) : gel DOCMV
|
||
(l. 92-93, levé l. 100). Hors gel, un fichier est réservé à un lot sur `DÉCLARATION` jusqu'à son commit (l. 161,
|
||
168, 192).
|
||
- **15.7 Refus d'autorisation** : un refus du système d'autorisations se signale (utilisateur, Big Boss) et ne se
|
||
contourne pas ; aucune autre session n'écrit à la place ; il se lève par un ordre ou une approbation de
|
||
l'utilisateur dans la session concernée ; Big Boss ne change aucune règle d'autorisation à la demande d'une
|
||
session ; règles `permissions.allow` posées par l'utilisateur pour journal, registre, index, `TACHES`, `NUMEROS`,
|
||
`REPO-JOURNAL`, `BOSS-JOURNAL` (fichier hors git). Sources : l. 145, 147, 151, 156.
|
||
- **15.8 Messages en usage** (bloc de code, complète § 9) : `[<SESSION>→BOSS] <LOT> DÉCLARATION | CONFLIT |
|
||
BUILD-DEMANDE | BUILD-FIN | JOURNAL-DEMANDE | JOURNAL-LIBRE <hash> | GEL-DEMANDE | FIN-LOT <chemin>` ;
|
||
`[BOSS→<SESSION>] … BUILD-ATTENTE <rang> | BUILD-GO | GEL-GO | ARBITRAGE`.
|
||
|
||
### 2.4 Point 5 — `BOSS-JOURNAL.md`
|
||
Aucune écriture par DOCSTAT. Le ticket l'emporte tel qu'il est au moment du commit (MD5 relevé dans le ticket).
|
||
|
||
### 2.5 Traces (DOCSTAT-T6, après VAL)
|
||
- `Docs/Journal_Modifications.md` : une entrée `CHG-<n>` (numéro réservé sous verrou dans `etat/REPO/NUMEROS.md`),
|
||
écrite sous jeton, au moment du commit.
|
||
- `Docs/README.md` l. 71 : plage `CHG-317` → `CHG-<n>` (et cellules de la Q4 si (a)).
|
||
- Ordre : 08, 09, 21, 29, 30, 32 (IMPL) → VAL → NUMEROS → JOURNAL-DEMANDE → journal + README → ticket.
|
||
|
||
## 3. Repli
|
||
`.\Tools\Restore.ps1 -Lot DOCSTAT` (instantané pris avant la 1re écriture ; proposé, jamais lancé sans accord) ; après
|
||
commit : `git revert` du commit du ticket `DOCSTAT-R1`.
|
||
|
||
## 4. Risques et questions
|
||
|
||
- **R1** : Big Boss écrit `BOSS-JOURNAL.md` pendant le ticket → le gardien relève le MD5 à l'étape 0 et commite ce qu'il
|
||
trouve ; une ligne écrite après le commit part avec le commit suivant (pas de découpage).
|
||
- **R2** : numéros de ligne de `BOSS-JOURNAL.md` cités au § 15 décalés si Big Boss modifie l'en-tête → relus juste
|
||
avant le ticket (V6).
|
||
- **R3** : `REPO-JOURNAL.md` est ` M` (traces d'autres tickets, dont STE-R4, LISIB-R1 non suivis) → règle l. 98 : il part
|
||
entier avec ce commit ; les tickets non suivis d'autres lots partent seulement s'ils sont « fait » sans commit propre
|
||
(R-REPO1 précisée), sinon ils restent ; liste fixée dans le ticket après relevé.
|
||
|
||
**Questions (liste fermée, recommandation en premier)** :
|
||
- **Q1** — `phase0` des docs 29 et 30 (« Fiche projet validée par l'utilisateur ») : aucune trace écrite de la
|
||
validation ; les phases suivantes ont été lancées et décidées par l'utilisateur (STA, OBA, porte G-ST). (a) `completed`
|
||
(validation de fait) ; (b) laisser `in_progress`.
|
||
- **Q2** — `lot-sta` : STA-T4 (synthèse → G-ST) n'a jamais été faite, la porte G-ST a été tenue sans elle. (a)
|
||
`completed` ; (b) `in_progress`.
|
||
- **Q3** — doc 32 : la consigne dit « statut appliqué » ; le relevé R6 montre une application partielle (gardien, Big
|
||
Boss ; ni chef, ni planificateur, ni managers). (a) « appliqué en partie » avec le détail ; (b) « appliqué ».
|
||
- **Q4** — index `Docs/README.md`, colonne Statut des lignes 59, 67, 68, 70 (deviennent fausses) : (a) les aligner dans le
|
||
même commit (4 cellules) ; (b) ne porter que la plage (consigne stricte), écart laissé à un lot suivant.
|
||
|
||
Textes proposés si Q4 (a) :
|
||
- l. 59 : `lots S0 à S8 clos (CHG-220) ; pin et registre des reports tenus à jour`
|
||
- l. 67 : `projet en cours ; phase 0, STA et porte G-ST faites ; point d'étape du 2026-10-10 ; dernier CHG ST : CHG-317 (STF)`
|
||
- l. 68 : `projet en cours ; phase 0 et OBA faites, porte G-OB en cours (B1, B3, G-OB-6 traités : OBB, GO conditionnel) ; dernier CHG OB : CHG-312 (OBP)`
|
||
- l. 70 : `appliqué en partie (lot AG, CHG-299) : gardien du dépôt, Big Boss ; règles en vigueur au § 15 (DOCSTAT)`
|
||
|
||
## 5. Interdits
|
||
Aucune écriture hors des lignes du § 2 et de `etat\DOC\DOCSTAT\` ; ni `Content\`, `Source\`, `GI.uasset`, `etat\ST\`,
|
||
`etat\OB\`, skills ; pas d'écriture de `BOSS-JOURNAL.md` ; pas de copie UE ; aucune commande git qui écrit (gardien
|
||
seul) ; rien poussé.
|
||
|
||
## 6. Valeurs moteur
|
||
Sans objet : aucun code ni réglage moteur.
|
||
|
||
## 7. Critères de VAL (commande → attendu)
|
||
- **V1** `git diff --numstat -- Docs/08_Guide_Developpeur.md Docs/09_Commandes_Utiles.md Docs/21_Sandbox_Addon.md` → `1 1` pour chacun.
|
||
- **V2** `git diff --numstat -- Docs/29_Projet_Stabilisation_V2.md Docs/30_Projet_Audit_Obsolescence.md` → `3 3` (ou `2 2` pour 29 si Q2 (b), selon les réponses), lignes 7, 10, 13 seulement, valeurs du § 2.2.
|
||
- **V3** `git diff -- Docs/32_Organisation_Agents.md` → l. 3-4 remplacées, 2 lignes ajoutées après l. 17, § 15 ajouté en fin ; aucune autre ligne changée.
|
||
- **V4** `git status --short -- Docs` → seuls les 6 docs + (T6) journal, README ; `etat\` : DOCSTAT et fichiers d'autres sessions déjà présents au relevé.
|
||
- **V5** `git ls-files --eol` des fichiers écrits → `w/lf` ; `tr -cd '\r' < f | wc -c` → 0 ; pas de BOM.
|
||
- **V6** chaque numéro de ligne `BOSS-JOURNAL.md` du § 15 pointe la ligne dont il est la source (relecture une à une).
|
||
- **V7** chemins et noms cités dans le texte ajouté existent (`ls` / `grep`) ; aucun lien Markdown cassé dans les 6 docs.
|
||
- **V8** (après T6) une seule ligne ajoutée au journal (`CHG-<n>`), plage README = `CHG-<n>`, `NUMEROS.md` : `<n>` réservé à DOCSTAT.
|
||
|
||
## 8. Décisions de l'utilisateur (2026-10-10, questions fermées dans la session DOCSTAT)
|
||
- SPEC : « Approuvée ».
|
||
- Q1 et Q2 : « Tout « completed » » (phase0 des docs 29 et 30, lot-sta, gate-gst, lot-oba `completed` ; gate-gob `in_progress`).
|
||
- Q3 : « Appliqué en partie ».
|
||
- Q4 : « Aligner les 4 cellules » (l. 59, 67, 68, 70 de `Docs/README.md`, textes du § 4).
|