PD-233 — Rétrospective¶

1. Contexte¶

2. Métriques¶

3. Learnings clés¶

• Extraction de texte depuis fichiers hybrides complexe : Les fichiers Astro mélangent JSX, TypeScript, HTML et expressions. Une approche basée sur l'AST serait plus fiable que les regex.

• Règles de contenu doivent prévoir des exceptions : Le marketing utilise des patterns (numérotation, étapes) qui ressemblent à des séquences techniques interdites. Distinction nécessaire.

• Double validation (local + CI) essentielle : Le pre-commit peut être contourné, le CI est le garde-fou final.

• Annexes copywriting doivent évoluer avec le site : Chaque nouvelle page nécessite une mise à jour des annexes correspondantes.

• Validateur désactivé est une dette visible : Le commentaire // TODO: Re-enable when E003 is fixed documente le compromis accepté.

4. Patterns applicables¶

Nouveau pattern : Architecture modulaire validateur contenu¶

scripts/validators/
├── validate-content.ts       # Point d'entrée
├── ForbiddenTermsDetector.ts # Termes interdits
├── SequencePatternDetector.ts # Séquences procédurales
├── PlaceholderChecker.ts     # Placeholders non remplis
└── TextExactMatcher.ts       # Correspondance annexe (désactivé)

Nouveau pattern : Exceptions contextuelles¶

const SEQUENCE_EXCEPTIONS = [
  '/how-it-works',  // Marketing légitime
  '/annexes/copywriting/', // Source de vérité
];

if (SEQUENCE_EXCEPTIONS.some(p => filePath.includes(p))) {
  return; // Pas de validation séquence
}

5. Signal CLAUDE.md¶

Priorité moyenne : Validation contenu pré-publication.

### Communication pré-INPI — Validation CI (2026-02-XX)

Tout site vitrine avec contraintes pré-INPI DOIT avoir :
1. **ForbiddenTermsDetector** : Liste FR/EN des termes interdits
2. **SequencePatternDetector** : Détection "Étape 1/2/3" avec exceptions marketing
3. **PlaceholderChecker** : `[À RENSEIGNER]`, `[TODO]`, `[TBD]`
4. **Job CI bloquant** sur main et MR

L'extraction de texte depuis Astro est complexe ; préférer valider le HTML généré post-build.

6. Conclusion¶

PD-233 a livré le cadre de validation pré-INPI avec 3 détecteurs fonctionnels. Le TextExactMatcher désactivé illustre la complexité de l'extraction de texte depuis des fichiers hybrides. La dette technique (pre-commit Husky, audit trail) est documentée pour correction future.

Rétrospective générée 2026-02-19 (Étape 10 batch site-vitrine)