This commit is contained in:
MaksTinyWorkshop
2026-03-26 13:36:51 +01:00
parent 9b7af9f1b0
commit 808e9d5536
9 changed files with 118 additions and 49 deletions

View File

@@ -16,9 +16,9 @@ Langue de travail : **français**.
La base de connaissance est organisée dans `knowledge/` par domaine.
Consulte-la avant de proposer une solution dans le domaine concerné.
### Procédure d'accès
### Procédure daccès
1. Identifie le domaine : `backend`, `frontend`, `ux`, `workflow`
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
@@ -47,16 +47,6 @@ Consulte-la avant de proposer une solution dans le domaine concerné.
| `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
Quand tu repères qu'un pattern mérite d'être capitalisé :
```
FILE_UPDATE_PROPOSAL
Fichier : `<nom_du_fichier>`
Pourquoi : <1-2 phrases>
```
## Capitalisation du savoir
Les apprentissages découverts dans un projet ne doivent pas être ajoutés
@@ -80,49 +70,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é dans `knowledge/` :
- `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`
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 lenvironnement Lead_tech lutilisent pour résoudre
automatiquement les chemins selon la machine (Mac / NUC).
## Patterns clés à appliquer systématiquement
- **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 } }`
- **Guard NestJS — ordre denregistrement** : voir `knowledge/backend/patterns/nestjs.md`
- **Format derreur API standardisé** : `{ error: { code, message, requestId } }`
- **Sessions avec TTL** : toujours un champ `expiresAt`, filtrer dans les queries
## Infrastructure NUC