[DTP-Worker] Sprint 8 · buffer L75 · Doc agents QA (stub→doc réelle · 4 modules méta sourcés) + fix lien roadmap mort ×11 AGENT.md (guard+docs verts)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-30 12:33:28 +00:00
parent 5d9ea5687d
commit dbeea972ed
13 changed files with 175 additions and 16 deletions
@@ -11,7 +11,7 @@ Automatise génération BIM depuis brief projet, extraction IFC, upload Speckle
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@ Dashboard CRM luxury, workflow lead→contrat, JAMAIS EspoCRM ni HubSpot
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@ CI/CD Gitea, systemd services, docker Frappe, monitoring VPS
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@ Toute logique métier native Frappe v15, DocTypes, workflows, e-CF, RBAC
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@ Console dark+doré uniformisée, 5 portails RBAC, dashboards entités
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@ Pipeline IFC → Speckle → viewer 3D console, bim-cloud.otov7.com
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@ App EAS builds iOS/Android, submit stores, EAS OTA updates
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@ Enregistrement noms projets Niza (36/37/43), e-CF DGII, UAF, ISA/IFRS 5D
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -1,23 +1,76 @@
-# QA Agent · 4Big Score 95+/100
+# 🔬 QA Agent · Recette 4Big & gates de méta-niveau (score 95+/100)
+
+**Rôle** : Cet agent est le **gardien de la qualité** du mandat DTP. Il ne produit
+pas de fonctionnalité métier ; il produit des **gates automatiques** qui prouvent —
+en une commande, de façon déterministe et sans jamais fabriquer de chiffre — que
+**100 % des livrables** du mandat tiennent le niveau 4Big (**≥ 95/100**, CLAUDE.md
+#5), s'exécutent vert, sont conformes et couvrent toutes les promesses roadmap.

 ## Scope
-Tests E2E Playwright, audit qualité 5D, self-verification HTTP
+Audit qualité 4Big + audit 5D de conformité + régression exhaustive + recette
+d'acceptation/traçabilité + tests E2E Playwright + self-verification HTTP.
+
+## Principe directeur : QA opère au **méta-niveau** (ISA 315 · SoD)
+Chaque livrable QA **lit les hand-off `out/` déjà commités** par les agents amont
+(ou découvre les modules **depuis le CI**) et les confronte de façon **bijective**.
+Il ne relance pas les générateurs métier et **ne fabrique aucune donnée**.
+**Séparation des tâches (SoD)** : chaque gate QA **s'exclut lui-même** de son propre
+périmètre — un auditeur ne s'audite jamais.
+
+## Livrables QA réellement produits (`05_deliverables_mvp/qa/`)
+
+| Module | Sprint | Rôle | Entrée CLI | Job CI | Tests |
+|---|---|---|---|---|---|
+| `audit_5d/` | 5 (roadmap L57) | Audit **5D** de conformité : 17 contrôles / 5 dimensions, lit les `out/` amont, coche UAF + normes ISA/IFRS | `audit_5d_gen.py build\|validate` | `qa-audit-5d-tests` | 37 |
+| `audit_4big/` | 7 (roadmap L69) | **Gate qualité** : note 4Big de 100 % des livrables, verdict `FAIL` si un module < 95/100 ou couverture incomplète | `audit_4big_gen.py build\|validate` | `qa-audit-4big-tests` | 35 |
+| `regression/` | 8 (roadmap L74) | **Matrice de régression** : agrège l'exécution de **toutes** les suites gated en un verdict unique + le compte agrégé faisant autorité | `regression_gen.py build\|validate\|run` | `qa-regression-tests` | 25 |
+| `acceptance/` | 8 (roadmap L75 / L80-87) | **Recette / traçabilité** : mappe chaque promesse roadmap (8 livrables + 7 métriques) vers sa preuve, bijectif vs CI | `acceptance_gen.py build\|validate` | `qa-acceptance-tests` | 31 |
+
+**Quatre axes distincts, non redondants** (CLAUDE.md #5 · éliminer les doublons) :
+`audit_4big` note la **qualité statique** · `regression` prouve l'**exécution** ·
+`acceptance` prouve la **couverture des promesses** · `audit_5d` prouve la
+**conformité** normative des hand-off.
+
+## Verdict agrégé courant (source `qa/regression/out/regression_run.json`)
+**21 suites gated · 534 tests · 534 passés · 0 échec · 0 erreur → verdict `PASS`.**
+Ce compte est **découvert automatiquement depuis le CI** (`q4lib.registry.parse_ci`,
+réutilisé sans duplication) — jamais compté à la main.

 ## Non-négociables (voir CLAUDE.md racine pour la liste complète)
 - Gitea only (jamais GitHub)
 - ERPNext natif en priorité
- Score 4Big 95+/100
- Zéro invention chiffres
+- Score 4Big 95+/100 — **c'est le seuil que ces gates font respecter**
+- Zéro invention de chiffres — les nombres cités par les gates sont des **citations
+  verbatim** de la roadmap ou des comptes **recalculés** depuis le CI/les `out/`
 - Vérifier · Investiguer · Valider · Confirmer

-## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+## Livrable attendu · roadmap
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md`. Volets QA : Sprint 1 (baseline
+Playwright /crm /waf-home /qa /choisir-mon-unite) · Sprint 5 (audit 5D UAF +
+ISA/IFRS) · Sprint 7 (audit 4Big 95+/100 sur 100 % deliverables) · Sprint 8
+(régression exhaustive + recette d'acceptation).
+
+## Anti-invention — invariants transverses des gates
+- **Couverture bijective** : un module gated non tracé **ou** une preuve non gated
+  → génération/validation **refusée** ; la validation **recalcule** la couverture
+  depuis le CI (jamais une liste figée à la main).
+- **Zéro chiffre fabriqué** : tout paramètre non confirmé reste une **confirmation
+  sourcée** (owner + source), jamais une valeur inventée.
+- **Build déterministe** : sortie stable et rejouable ; le gate CI (guard + JSON +
+  docs + YAML) doit rester vert.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
 - Handoffs formalisés dans `05_deliverables_mvp/handoffs/`
 - Blockers escalés à Michel Roy via WhatsApp +18296296385

+## Coordination inter-agents
+- **Tous les agents** : QA consomme leurs hand-off `out/` et leurs jobs CI ; tout
+  nouveau module gated est **automatiquement** intégré aux 4 gates (découverte CI).
+- **DevOps** : le `regression run` alimente le `deploy_runbook` (phase Vérification
+  QA) ; la recette `acceptance` recense les parties hors périmètre worker (VPS · #8).
+- **Publiciste** : réutilise le validateur maison Publiciste pour les specs QA.
+
 ## Éthique
 - Sensibilité culturelle FR/EN/ES + RD
 - Voix Amélie QC (multilingual_v2) pour toute interaction OTOIA
@@ -11,7 +11,7 @@ Batch renders depuis IFC/description projet, 6 vues par projet minimum
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -11,7 +11,7 @@
 - Vérifier · Investiguer · Valider · Confirmer

 ## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS.md` pour deliverables par sprint.
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.

 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -1,5 +1,48 @@
 # Activity Log · 2026-07-30 · Claude Code DTP

+## Session `20260730_122751` (session 25)
+
+**Tâche** : **Sprint 8 · buffer L75 (corrections finales · doc)** — Toutes les
+promesses roadmap sont désormais prouvées en-repo (recette `qa/acceptance` :
+15/15 `in_repo`, seule M5 « app publiée 2 stores » reste hors périmètre worker).
+Aucun module roadmap restant à créer. La tâche buffer à plus forte valeur, conforme
+au mandat (« améliore la doc d'un AGENT.md existant ») : **corriger + étoffer la
+documentation agent**.
+
+**Gap comblé (2 défauts réels)** :
+1. **Référence roadmap cassée** dans **11 fichiers** `03_agents/*/AGENT.md` : ils
+   pointaient vers `04_roadmap/ROADMAP_8_WEEKS.md` (**inexistant**) au lieu de
+   `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` (le vrai fichier, référencé partout
+   ailleurs). Lien mort → corrigé sur les 11.
+2. **`03_agents/qa/AGENT.md` était un stub de 29 lignes** alors que l'agent QA a
+   livré **4 modules de méta-niveau** substantiels (`audit_5d`, `audit_4big`,
+   `regression`, `acceptance`) ; la doc ne reflétait pas la réalité livrée.
+
+**Fichiers modifiés** :
+- `03_agents/qa/AGENT.md` : réécrit (stub → doc réelle). Table des 4 livrables QA
+  (sprint · rôle · **entrée CLI** · **job CI** · **nb tests** — tous **sourcés**
+  depuis les modules réels), principe méta-niveau (ISA 315 · SoD), verdict agrégé
+  courant (**21 suites · 534 tests · PASS**, cité depuis
+  `qa/regression/out/regression_run.json`), invariants anti-invention, coordination.
+- `03_agents/{bim,crm,devops,erpnext_backend,frontend_console,ifc_speckle,mobile,onapi_legal,rendu,seo}/AGENT.md`
+  + `qa` : correction du lien roadmap cassé (11 fichiers).
+
+**Anti-invention (#6)** : **zéro chiffre fabriqué** — chaque nombre de la doc QA
+est soit un compte réel (`grep def test_`, `regression_run.json`), soit une citation
+de la roadmap ; aucune donnée métier inventée.
+
+**Vérifs** : `ci/guard_constraints.sh` vert (contraintes non-négociables OK) ;
+`ci/check_docs.sh` vert (**liens internes OK** — plus aucun lien mort) ;
+0 référence `ROADMAP_8_WEEKS.md` restante ; 11 fichiers pointent bien vers le fichier
+existant.
+
+**Hors périmètre worker (VPS · #8)** : néant (changement doc-only en-repo).
+
+**Détail complet** : voir
+[`05_deliverables_mvp/daily_reports/2026-07-30-session25.md`](../05_deliverables_mvp/daily_reports/2026-07-30-session25.md).
+
+**Auto-score 4Big** : 95/100.
+
 ## Session `20260730_115744` (session 24)

 **Tâche** : **Sprint 8 · QA (buffer L75 · recette)** — Générateur de la **Matrice
@@ -0,0 +1,63 @@
+# Rapport de session · 2026-07-30 · session 25
+
+**Agent** : Claude Code DTP · **Session** : `20260730_122751`
+**Sprint** : 8 · **Volet** : buffer L75 (corrections finales · documentation agent)
+**Auto-score 4Big** : 95/100
+
+---
+
+## 1. Contexte — pourquoi une tâche « doc » et pas un nouveau module
+
+La roadmap `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` va du Sprint 1 au Sprint 8
+(dernier). La recette d'acceptation livrée en session 24
+(`05_deliverables_mvp/qa/acceptance/out/acceptance_matrix.json`) prouve que
+**15/15 promesses** (8 livrables de sprint + 7 métriques succès MVP) sont
+**`in_repo`** — la seule hors périmètre worker est **M5** (« Mobile app publié
+2 stores », soumission store réelle · #8).
+
+Il **ne reste donc aucun module roadmap à créer en-repo**. Créer un 5ᵉ générateur
+de méta-niveau serait un doublon (interdit CLAUDE.md #5). La consigne de mandat
+prévoit exactement ce cas : *« Si aucune tâche prioritaire évidente → améliore la
+doc d'un AGENT.md existant. »* J'ai donc traité les défauts de documentation réels.
+
+## 2. Défauts corrigés
+
+### 2.1 Lien roadmap mort dans 11 `AGENT.md`
+Les stubs `03_agents/*/AGENT.md` renvoyaient à `04_roadmap/ROADMAP_8_WEEKS.md`.
+Ce fichier **n'existe pas** ; les fichiers présents sont `ROADMAP.md`,
+`ROADMAP_8_WEEKS_OR_LESS.md` (le canonique, cité par CLAUDE.md et tous les
+livrables) et `ROADMAP_8_WEEKS_v1_archived.md`. → 11 fichiers corrigés vers le
+fichier existant.
+
+### 2.2 `qa/AGENT.md` = stub obsolète
+Le doc de l'agent QA faisait 29 lignes (template) alors que QA a livré **4 modules
+de méta-niveau**. Réécrit pour refléter la réalité, avec **faits sourcés** :
+
+| Module | Sprint | Entrée CLI | Job CI | Tests (réels) |
+|---|---|---|---|---|
+| `audit_5d` | 5 (L57) | `audit_5d_gen.py` | `qa-audit-5d-tests` | 37 |
+| `audit_4big` | 7 (L69) | `audit_4big_gen.py` | `qa-audit-4big-tests` | 35 |
+| `regression` | 8 (L74) | `regression_gen.py` | `qa-regression-tests` | 25 |
+| `acceptance` | 8 (L75/L80-87) | `acceptance_gen.py` | `qa-acceptance-tests` | 31 |
+
+Comptes de tests obtenus par `grep -c 'def test_'` sur chaque suite ; le verdict
+agrégé cité (**21 suites · 534 tests · PASS**) provient de
+`qa/regression/out/regression_run.json`. **Aucun chiffre inventé.**
+
+## 3. Vérifications
+
+- `ci/guard_constraints.sh` → **vert** (aucune contrainte non-négociable violée ;
+  pas de GitHub / EspoCRM / écriture `/var/www/html/static` / `git clean`).
+- `ci/check_docs.sh` → **vert** : « Documentation conforme (**liens internes OK**) »
+  — plus aucun lien mort vers un fichier roadmap inexistant.
+- `grep -rn ROADMAP_8_WEEKS.md 03_agents/` → **0 occurrence** restante ;
+  11 fichiers pointent désormais vers `ROADMAP_8_WEEKS_OR_LESS.md`.
+
+## 4. Hors périmètre worker (VPS · #8)
+Néant — changement **doc-only** entièrement en-repo. Aucune action VPS/nginx/systemd.
+
+## 5. Fichiers touchés
+- Réécrit : `03_agents/qa/AGENT.md`
+- Lien corrigé : `03_agents/{bim,crm,devops,erpnext_backend,frontend_console,ifc_speckle,mobile,onapi_legal,qa,rendu,seo}/AGENT.md`
+- Journal : `05_activity_log/2026-07-30.md` (entrée session 25)
+- Ce rapport.