docs: Session Clean + ROADMAP sprints X.5 (refactoring obligatoire)

This commit is contained in:
Hermann_Kitio 2026-04-21 05:14:57 +03:00
parent 656b42e6c4
commit 385b29679e
2 changed files with 130 additions and 0 deletions

View file

@ -480,3 +480,56 @@ Avant chaque session Claude Code, vérifier :
|---|---|---|
| 1.0 | 2026-04-17 | Création, adaptée de la version backend |
| 1.1 | 2026-04-18 | Ajout Règle L — tokens du design system (Sprint 0.5) |
| 1.2 | 2026-04-21 | Ajout section 10 — Session Clean obligatoire après chaque sprint |
---
## 10. Session Clean (obligatoire après chaque sprint)
> Session séparée du sprint de dev — jamais en cours d'implémentation.
### Déclenchement
- Le sprint est terminé
- Tous les tests automatisés sont verts
- Un commit propre existe (point de retour sûr)
### Prompt standard à donner à Claude Code
Lis dans l'ordre :
1. docs/ARCHITECTURE.md
2. docs/DEVELOPMENT_PRINCIPLES.md
3. docs/DESIGN_SYSTEM.md
Sprint [X] terminé, tests au vert, commit propre effectué.
Agis comme un ingénieur senior.
Analyse uniquement les fichiers modifiés ce sprint.
Objectif : réduire la complexité sans changer aucune fonctionnalité.
Règles :
- 1 fichier modifié à la fois
- npm run typecheck + npm run test après chaque fichier
- Si un test échoue : annuler la modification, passer au suivant
- Ne pas toucher aux fichiers non modifiés ce sprint
- Ne pas supprimer de code sans vérifier au préalable
qu'il n'est pas référencé ailleurs dans le projet
(grep obligatoire avant toute suppression)
- Aucune décision architecturale — si un doute,
signaler et attendre
Produis un plan (liste des fichiers à nettoyer, ordre)
et attends le GO.
### Séquence obligatoire
1. Claude Code propose le plan (fichiers + ordre)
2. Validation dans le Project avant GO
3. Claude Code factorise — 1 fichier à la fois
4. npm run typecheck + npm run test verts après chaque fichier
5. Tests manuels Golden Dataset — groupes concernés
6. Si tout vert → commit : refactor(<scope>): nettoyage Sprint [X]
7. CHANGELOG.md mis à jour
### Règle absolue
Un test manuel qui échoue après refactor = annuler toute
la session Clean, revenir au commit du sprint,
diagnostiquer avant de retenter.