PD-252 — Rétrospective¶
1. Résumé story¶
| Attribut | Valeur |
|---|---|
| Story | PD-252 — Politique formats de préservation |
| Type | Documentaire pure (0 ligne de code) |
| Projet | ProbatioVault-doc |
| Source | GAP-FINAL-004 (PD-244 audit ISO 14641) |
| Verdict final | GO — Gate 8 v1 — 8.75/10 |
| Durée totale | ~3h (1 session) |
2. Patterns identifiés¶
P1 — Gate 3 difficile pour stories documentaires normatives¶
Observation : Gate 3 a nécessité 4 itérations (v1: 4.5, v2: 6.0, v3: 6.75, v4: 7.875) avec escalade au plafond et dérogation manuelle. La spec initiale ChatGPT avait des lacunes structurelles (matrice composite, durées "variable", collision MIME).
Pattern : Les stories documentaires normatives (ISO/NF) ont une surface d'analyse plus large que les stories code car chaque terme porte un engagement normatif. La spec initiale doit être plus rigoureuse.
Recommandation : Pour les stories doc normatives, injecter un checklist pré-Gate 3 dans le prompt spec (step 1) : regex, enum, matrice décomposée, durées concrètes.
P2 — Gate 8 facile après Gate 3 difficile¶
Observation : Gate 8 GO en v1 (8.75/10, 0 bloquant, 0 majeur). Les corrections apportées en Gate 3 (12 corrections v3→v4) ont consolidé la spec à un point où l'implémentation documentaire était quasi-mécanique.
Pattern : L'investissement en amont (Gate 3 rigoureuse) se rentabilise en aval (Gate 8 GO v1). Ce pattern est cohérent avec PD-283 (Gate 3 difficile → Gate 8 facile).
P3 — Dérogation Art. II systématique pour prompts > 30KB¶
Observation : 6 appels sur 6 (P1/P2 pour Gates 3v4, 5, 8) ont dû utiliser claude -p au lieu d'OpenCode ChatGPT. Tous les prompts assemblés dépassaient 30KB.
Pattern : Les stories legal-compliance avec normes ISO/NF génèrent des prompts > 30KB systématiquement (spec + tests + références = 50-80KB). La dérogation Art. II est la norme, pas l'exception, pour ce domaine.
Recommandation : Considérer une stratégie de prompt splitting pour les gates legal-compliance, ou accepter la dérogation comme standard pour ce domaine.
P4 — claude -p écrit sur disque (contournement --allowedTools)¶
Observation : Même avec --allowedTools "", claude -p utilise parfois ses tools Write/Edit pour écrire directement sur disque. Le stdout ne contient qu'un résumé. L'orchestrateur doit toujours vérifier le disque après chaque appel.
Pattern récurrent : Confirmé sur PD-283 et PD-252 (plan, REX, acceptabilité, confrontation).
3. Améliorations process¶
A1 — Checklist pré-Gate 3 pour stories doc normatives¶
Injecter dans le prompt spec (step 1) une checklist spécifique au domaine legal-compliance :
- Durées concrètes (ISO 8601, pas "variable")
- Matrice décomposée (1 ligne = 1 type × 1 niveau)
- Regex pour tout champ structuré
- Distinction références structurées vs citations documentaires
- Clause pour validations non implémentées
Statut : Recommandation — à valider avec PO avant injection dans template.
A2 — Dérogation Art. II par domaine¶
Documenter dans CONSTITUTIONAL.md que les stories legal-compliance bénéficient d'une dérogation Art. II permanente pour les gates (prompts > 30KB structurellement).
Statut : Recommandation — nécessite validation humaine (modification CONSTITUTIONAL.md).
4. Métriques¶
| Gate | Score | Itérations | Verdict |
|---|---|---|---|
| G3 | 7.875/10 | 4 (dérogation) | RESERVE |
| G5 | 8.0/10 | 1 | RESERVE |
| G8 | 8.75/10 | 1 | GO |
| Métrique | Valeur |
|---|---|
| Tests contractuels | 31/31 PASS |
| CA couverts | 12/12 (100%) |
| INV respectés | 9/9 (100%) |
| Écarts résiduels | 2 mineurs (typo accent, backtick) |
| Learnings capturés | 2 |
5. Conclusion¶
PD-252 clôture GAP-FINAL-004 (ISO 14641 §10.1.1). La politique de formats de préservation est formalisée dans preservation-format-policy.md et référencée depuis ch08. Le workflow a démontré que la rigueur en amont (Gate 3 à 4 itérations) garantit la fluidité en aval (Gate 8 GO v1).