mirror of
https://github.com/MaksTinyWorkshop/_Assistant_Lead_Tech
synced 2026-04-06 21:41:42 +02:00
152 lines
2.4 KiB
Markdown
152 lines
2.4 KiB
Markdown
# Lead_tech — Index de la base de connaissance
|
||
|
||
Ce repository constitue la **mémoire inter‑projets** et la **doctrine technique** utilisée par les agents et les projets.
|
||
|
||
Il centralise :
|
||
|
||
- les conventions globales
|
||
- les patterns validés
|
||
- les décisions d’architecture
|
||
- les post‑mortems
|
||
- les playbooks réutilisables
|
||
|
||
---
|
||
|
||
# Structure de la base de connaissance
|
||
|
||
## Contexte global
|
||
|
||
- `CLAUDE.md`
|
||
Instructions globales chargées automatiquement par les agents.
|
||
|
||
- `AGENTS.md`
|
||
Alias vers `CLAUDE.md` pour compatibilité avec certains outils.
|
||
|
||
---
|
||
|
||
## Patterns validés
|
||
|
||
Patterns éprouvés en production ou en projets réels.
|
||
|
||
- `10_backend_patterns_valides.md`
|
||
- `10_frontend_patterns_valides.md`
|
||
|
||
---
|
||
|
||
## Risques et anti‑patterns
|
||
|
||
Situations connues pouvant entraîner :
|
||
|
||
- bugs difficiles
|
||
- dette technique
|
||
- complexité inutile
|
||
|
||
- `10_backend_risques_et_vigilance.md`
|
||
- `10_frontend_risques_et_vigilance.md`
|
||
|
||
---
|
||
|
||
## Workflows et intégrations
|
||
|
||
Procédures de travail et intégrations techniques.
|
||
|
||
- `20_workflows_README.md`
|
||
- `30_integrations_README.md`
|
||
|
||
---
|
||
|
||
## Décisions d’architecture
|
||
|
||
Mini‑ADR documentant les choix techniques structurants.
|
||
|
||
- `40_decisions_et_archi.md`
|
||
|
||
---
|
||
|
||
## Idées et explorations
|
||
|
||
Zone de réflexion pour des idées non encore validées.
|
||
|
||
- `50_idees_en_vrac.md`
|
||
|
||
---
|
||
|
||
## Playbooks
|
||
|
||
Procédures opérationnelles réutilisables.
|
||
|
||
Exemples :
|
||
|
||
- migration d’un projet vers le NUC
|
||
- configuration d’un service partagé
|
||
- bootstrap d’un projet
|
||
|
||
Dossier :
|
||
|
||
```
|
||
60_playbooks/
|
||
```
|
||
|
||
---
|
||
|
||
## Templates
|
||
|
||
Modèles de fichiers et structures de projet.
|
||
|
||
Exemples :
|
||
|
||
- template `CLAUDE.md` pour projet
|
||
- exemples de configuration Docker
|
||
|
||
Dossier :
|
||
|
||
```
|
||
70_templates/
|
||
```
|
||
|
||
---
|
||
|
||
## BMAD
|
||
|
||
Documentation sur l’articulation entre la méthode BMAD et cette base de connaissance.
|
||
|
||
Dossier :
|
||
|
||
```
|
||
80_bmad/
|
||
```
|
||
|
||
---
|
||
|
||
## Debug et post‑mortems
|
||
|
||
Historique de problèmes rencontrés et des solutions appliquées.
|
||
|
||
- `90_debug_et_postmortem.md`
|
||
|
||
---
|
||
|
||
# Principe fondamental
|
||
|
||
Toute information ajoutée ici doit être :
|
||
|
||
- **réutilisable sur plusieurs projets**
|
||
- **validée par l’expérience**
|
||
- **utile pour réduire le temps de debug**
|
||
|
||
Sinon elle doit rester dans le projet concerné.
|
||
|
||
---
|
||
|
||
# Capitalisation
|
||
|
||
Lorsqu’un nouveau pattern ou apprentissage apparaît :
|
||
|
||
```
|
||
FILE_UPDATE_PROPOSAL
|
||
Fichier : ...
|
||
Pourquoi : ...
|
||
```
|
||
|
||
Puis proposer le contenu à ajouter dans le fichier approprié.
|