Refonte Structure

CLAUDE.md

@@ -13,23 +13,39 @@ Langue de travail : **français**.
 
 ## Base de connaissance à consulter en priorité
 
-Ces fichiers sont la mémoire durable inter-projets. Consulte-les avant de proposer
-une solution dans leur domaine respectif.
+La base de connaissance est organisée dans `knowledge/` par domaine.
+Consulte-la avant de proposer une solution dans le domaine concerné.
 
-| Fichier                               | Contenu                                        |
-| ------------------------------------- | ---------------------------------------------- |
-| `10_backend_patterns_valides.md`      | Patterns backend validés en conditions réelles |
-| `10_frontend_patterns_valides.md`     | Patterns frontend/mobile validés               |
-| `10_ux_patterns_valides.md`           | Patterns UX/UI validés                         |
-| `10_product_patterns_valides.md`      | Patterns produit / métier validés              |
-| `10_n8n_patterns_valides.md`          | Patterns n8n validés                           |
-| `10_backend_risques_et_vigilance.md`  | Risques et anti-patterns backend               |
-| `10_frontend_risques_et_vigilance.md` | Risques et anti-patterns frontend              |
-| `10_ux_risques_et_vigilance.md`       | Risques et anti-patterns UX/UI                 |
-| `10_n8n_risques_et_vigilance.md`           | Nodes et patterns n8n à risque                 |
-| `10_conventions_redaction.md`         | Conventions de documentation technique        |
-| `40_decisions_et_archi.md`            | Décisions techniques (mini-ADR)                |
-| `90_debug_et_postmortem.md`           | Post-mortems et bugs capitalisés               |
+### Procédure d'accès
+
+1. Identifie le domaine : `backend`, `frontend`, `ux`, `workflow`
+2. Lis le `README.md` du sous-dossier `patterns/` ou `risques/` concerné
+3. Dans ce README, repère les fichiers dont le nom et la description matchent le contexte
+4. Lis ces fichiers avant de proposer quoi que ce soit
+
+### Structure
+
+| Dossier | Contenu |
+| ------- | ------- |
+| `knowledge/backend/patterns/` | Patterns backend validés (auth, contracts, prisma, stripe, nestjs, multi-tenant, nextjs, async) |
+| `knowledge/backend/risques/` | Risques backend (auth, contracts, prisma, stripe, nestjs, redis, nextjs, general) |
+| `knowledge/frontend/patterns/` | Patterns frontend/mobile validés (state, forms, navigation, design-tokens, nextjs, tests) |
+| `knowledge/frontend/risques/` | Risques frontend (auth, state, navigation, design-tokens, nextjs, tests, performance, general) |
+| `knowledge/ux/patterns/` | Patterns UX/UI validés |
+| `knowledge/ux/risques/` | Risques et anti-patterns UX/UI |
+| `knowledge/n8n/patterns/` | Patterns n8n validés |
+| `knowledge/n8n/risques/` | Risques et anti-patterns n8n |
+| `knowledge/product/patterns/` | Patterns produit / métier validés |
+| `knowledge/product/risques/` | Risques et anti-patterns produit |
+| `knowledge/workflow/risques/` | Risques workflow agent (story-tracking) |
+
+### Fichiers globaux (hors knowledge/)
+
+| Fichier | Contenu |
+| ------- | ------- |
+| `10_conventions_redaction.md` | Conventions de documentation technique |
+| `40_decisions_et_archi.md` | Décisions techniques (mini-ADR) |
+| `90_debug_et_postmortem.md` | Post-mortems et bugs capitalisés |
 
 ## Règles de mise à jour
 
@@ -70,17 +86,19 @@ Les agents peuvent proposer librement des entrées dans :
 
 Ce fichier sert de **zone tampon** pour les apprentissages à analyser.
 
-Après validation, le contenu est déplacé vers le fichier approprié :
+Après validation, le contenu est déplacé vers le fichier approprié dans `knowledge/` :
 
-- `10_backend_patterns_valides.md`
-- `10_frontend_patterns_valides.md`
-- `10_ux_patterns_valides.md`
-- `10_product_patterns_valides.md`
-- `10_n8n_patterns_valides.md`
-- `10_backend_risques_et_vigilance.md`
-- `10_frontend_risques_et_vigilance.md`
-- `10_ux_risques_et_vigilance.md`
-- `10_n8n_risques_et_vigilance.md`
+- `knowledge/backend/patterns/<thème>.md`
+- `knowledge/backend/risques/<thème>.md`
+- `knowledge/frontend/patterns/<thème>.md`
+- `knowledge/frontend/risques/<thème>.md`
+- `knowledge/ux/patterns/<thème>.md`
+- `knowledge/ux/risques/<thème>.md`
+- `knowledge/n8n/patterns/general.md`
+- `knowledge/n8n/risques/general.md`
+- `knowledge/product/patterns/general.md`
+- `knowledge/product/risques/<thème>.md`
+- `knowledge/workflow/risques/story-tracking.md`
 - `10_conventions_redaction.md`
 - `40_decisions_et_archi.md`
 - `90_debug_et_postmortem.md`
@@ -101,9 +119,9 @@ automatiquement les chemins selon la machine (Mac / NUC).
 
 ## Patterns clés à appliquer systématiquement
 
-- **Contracts-First / Zod-Infer / No-DTO** : voir `10_backend_patterns_valides.md`
-- **Navigation réactive useEffect** : voir `10_frontend_patterns_valides.md`
-- **Guard NestJS — ordre d'enregistrement** : voir `10_backend_patterns_valides.md`
+- **Contracts-First / Zod-Infer / No-DTO** : voir `knowledge/backend/patterns/contracts.md`
+- **Navigation réactive useEffect** : voir `knowledge/frontend/patterns/navigation.md`
+- **Guard NestJS — ordre d'enregistrement** : voir `knowledge/backend/patterns/nestjs.md`
 - **Format d'erreur API standardisé** : `{ error: { code, message, requestId } }`
 - **Sessions avec TTL** : toujours un champ `expiresAt`, filtrer dans les queries