Retrospective -- PD-249¶
Resume story¶
- Story : PD-249 -- Manuel technique SAE consolide
- Domaine : legal-compliance
- Date : 2026-02-27
- Projet : doc (ProbatioVault-doc)
- Complexite : medium
- Duree : 18h
- Gates : G3 GO (v2, 9.00) | G5 GO (v2, 9.63) | G8 GO (v1, 9.81)
Learnings de cette story¶
Depuis les gates¶
| Gate | Verdict | Score | Iter | Tags | Note |
|---|---|---|---|---|---|
| G3 | GO | 9.00 | v2 | #sae #documentation #iso14641 #legal-compliance | Specs doc convergent naturellement mais criteres qualitatifs a quantifier des v1 |
| G5 | GO | 9.63 | v2 | #sae #documentation #plan-review | Prerequis de transition etat doc et processus publication a contractualiser dans CC |
| G8 | GO | 9.81 | v1 | #sae #documentation #conformite-normative #iso14641 #nfz42013 | Approche structurelle suffisante sans mkdocs build |
Depuis le REX¶
-
INV-DOC-MARKDOWNLINT (invariant candidat) : Toute ligne de texte narratif <= 120 chars. Sans cette contrainte dans les code contracts, les agents produisent des lignes longues en masse (419 erreurs PD-249). Tags :
#documentaire #markdownlint #invariant-candidate -
Review doc ChatGPT superficielle : La review ChatGPT Gate 8 (28 lignes) n'a effectue aucune verification de fond (INV, CC, CA). Necessite un template dedie pour les projets documentaires. Template cree :
7a Review Doc.md -
Markdownlint dans 6a Decomposition : Regle 6 ajoutee au template 6a (v2.2.0) pour injecter la contrainte markdownlint dans les code contracts doc.
Patterns recurrents (domaine legal-compliance)¶
Stories analysees (5)¶
| Story | Projet | Titre | G3 | G5 | G8 | Duree |
|---|---|---|---|---|---|---|
| PD-244 | doc | Audit ISO 14641 / NF Z42-013 | GO v2 (9.88) | GO v2 (8.88) | GO v1 (8.23) | 13h |
| PD-250 | backend | Job destruction definitive | GO v4 (8.63) | RESERVE (7.88) | RESERVE (7.88) | 23.5h |
| PD-251 | backend | Job verification integrite | GO v2 (8.17) | GO v2 (8.67) | GO v1 (8.75) | 5h |
| PD-249 | doc | Manuel technique SAE | GO v2 (9.00) | GO v2 (9.63) | GO v1 (9.81) | 18h |
Tags recurrents (>= 3 stories)¶
| Tag | Stories | Occurrences |
|---|---|---|
#legal-compliance | PD-244, PD-250, PD-251, PD-249 | 10 |
#iso14641 | PD-244, PD-250, PD-249 | 4 |
#invariant-candidate | PD-250, PD-251, PD-249 + 3 autres domaines | 6 |
Pattern 1 -- Gate 3 RESERVE systematique en v1¶
Frequence : 4/4 stories (PD-244, PD-250, PD-251, PD-249) toutes passent par au moins v2 en G3.
Impact : 1 iteration supplementaire systematique. PD-250 a necessite 4 iterations (ESCALADE en v3).
Cause : Les specs documentaires/normatives contiennent des ambiguites qualitatives (criteres de conformite, seuils de couverture, definitions de "conforme") non detectees avant Gate 3.
Recommandation : Injecter une checklist pre-G3 specifique legal-compliance : versions normes, definitions conformite, seuils quantitatifs explicites.
Pattern 2 -- Projets doc convergent mieux que backend¶
Frequence : PD-244 et PD-249 (doc) vs PD-250/PD-251 (backend)
Impact :
- Doc : scores G8 moyens 9.02 (PD-244: 8.23, PD-249: 9.81)
- Backend : scores G8 moyens 8.31 (PD-250: 7.88, PD-251: 8.75)
- Doc : total iterations 9 pour 2 stories (4.5/story)
- Backend : total iterations 12 pour 2 stories (6/story)
Cause : Les projets doc n'ont pas de tests unitaires, pas de pipeline CI, pas de Sonar. Les ecarts sont essentiellement structurels et corrigeables rapidement.
Recommandation : Envisager un workflow allegue pour les stories purement documentaires (pas de step 7 complet, review structurelle suffisante).
Pattern 3 -- Invariants candidats a capitaliser¶
Frequence : Tag #invariant-candidate dans 6+ stories tous domaines confondus.
Impact : PD-177 a integre 2 invariants de PD-55 et obtenu 0 ecart en 3 gates (ROI ~1.5 iterations/invariant).
Invariants candidats legal-compliance :
- INV-DOC-MARKDOWNLINT (PD-249) : lignes <= 120 chars
- INV-NORM-VERSION (PD-244) : version norme explicite
- INV-DESTRUCTION-AUDIT (PD-250) : log audit monotone
Recommandations¶
Priorite haute (>= 5 stories ou NON_CONFORME recurrent)¶
Checklist pre-G3 legal-compliance— Écarté (couvert par template spec v1.7.0 sections "Formats et contraintes" + "Bornes numériques", pas de stories legal-compliance prévues à court terme)
Priorite normale¶
-
Workflow doc allege— Écarté (trop peu de stories doc pour justifier un workflow dédié, le workflow standard converge déjà bien) -
Template 7a Review Doc : Valider que le nouveau template
7a Review Doc.md(cree lors du REX PD-249) est effectivement utilise par les prochaines stories doc et mesurer l'impact sur la qualite des reviews ChatGPT. -
Invariants legal-compliance : Injecter INV-DOC-MARKDOWNLINT et INV-NORM-VERSION dans les specs des prochaines stories du domaine legal-compliance.
Signal CLAUDE.md¶
Section "Contraintes techniques dans le plan d'implementation"¶
Suggestion : Ajouter une sous-section specifique aux projets documentaires :
### Projets documentaires (type: doc)
- Markdownlint : lignes <= 120 chars (INV-DOC-MARKDOWNLINT)
- MkDocs : validation structurelle (nav + fichiers) si build
indisponible
- Normes : version explicite obligatoire (ex: NF Z42-013:2020,
pas NF Z42-013)
Section "Learnings-as-invariants"¶
Suggestion : Ajouter un exemple concret legal-compliance :
**Exemples legal-compliance** :
- INV-DOC-MARKDOWNLINT : lignes texte narratif <= 120 chars
(source: PD-249, ROI: -419 erreurs markdownlint)
- INV-NORM-VERSION : version norme ISO/NF explicite
(source: PD-244, ROI: -1 iteration Gate 3)
Section "Etape 7 -- Acceptabilite"¶
Suggestion : Ajouter une note pour les projets doc :