Refonte Structure

_AI_INSTRUCTIONS.md

@@ -8,33 +8,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
 
-## Règles de mise à jour
+1. Identifie le domaine : `backend`, `frontend`, `ux`, `n8n`, `product`, `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
 
-Quand tu repères qu'un pattern mérite d'être capitalisé :
+### Structure
 
-```
-FILE_UPDATE_PROPOSAL
-Fichier : `<nom_du_fichier>`
-Pourquoi : <1-2 phrases>
-```
+| 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 |
 
 ## Capitalisation du savoir
 
@@ -59,47 +65,20 @@ Validation
 Lead_tech
 ```
 
-Les agents peuvent proposer librement des entrées dans :
+Les agents peuvent proposer librement des entrées dans `95_a_capitaliser.md`.
 
-`95_a_capitaliser.md`
-
-Ce fichier sert de **zone tampon** pour les apprentissages à analyser.
-
-Après validation, le contenu est déplacé vers le fichier approprié :
-
-- `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`
-- `10_conventions_redaction.md`
-- `40_decisions_et_archi.md`
-- `90_debug_et_postmortem.md`
-
-Objectif :
-
-- éviter de polluer la base de connaissance
-- capitaliser progressivement les retours d'expérience
-- maintenir `Lead_tech` comme mémoire fiable et validée
+Après validation, le contenu est déplacé vers le fichier approprié dans `knowledge/`.
 
 ## Projets actifs
 
 La liste des projets actifs est maintenue dans `_projects.conf`.
 
-Ce fichier constitue le registre central des projets (stack, scope, état).
-Les scripts de l’environnement Lead_tech l’utilisent pour résoudre
-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`
-- **Format d'erreur API standardisé** : `{ error: { code, message, requestId } }`
+- **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
 
 ## Infrastructure NUC