mirror of
https://github.com/MaksTinyWorkshop/_Assistant_Lead_Tech
synced 2026-04-06 21:41:42 +02:00
184 lines
3.5 KiB
Markdown
184 lines
3.5 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
|
||
|
||
## Identité du repo
|
||
|
||
Nom logique : `Lead_tech`
|
||
|
||
Emplacements physiques selon l’environnement :
|
||
|
||
- Mac : `~/AI_RULES/_Assistant_Lead_Tech`
|
||
- NUC : `/srv/helpers/_Assistant_Lead_Tech`
|
||
|
||
Référence portable à utiliser dans les scripts et templates :
|
||
|
||
- `$LEADTECH`
|
||
|
||
---
|
||
|
||
# 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 & Risques
|
||
|
||
Organisés dans `knowledge/` par domaine. Chaque domaine a un sous-dossier `patterns/` et `risques/`, chacun avec un `README.md` servant d'index.
|
||
|
||
| Domaine | Patterns | Risques |
|
||
| ------- | -------- | ------- |
|
||
| Backend | `knowledge/backend/patterns/` | `knowledge/backend/risques/` |
|
||
| Frontend | `knowledge/frontend/patterns/` | `knowledge/frontend/risques/` |
|
||
| UX | `knowledge/ux/patterns/` | `knowledge/ux/risques/` |
|
||
| n8n | `knowledge/n8n/patterns/` | `knowledge/n8n/risques/` |
|
||
| Product | `knowledge/product/patterns/` | `knowledge/product/risques/` |
|
||
| Workflow | — | `knowledge/workflow/risques/` |
|
||
|
||
---
|
||
|
||
## Conventions de rédaction
|
||
|
||
Conventions de documentation et rédaction technique validées inter-projets.
|
||
|
||
- `10_conventions_redaction.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/
|
||
```
|
||
|
||
---
|
||
|
||
## Scripts
|
||
|
||
Scripts utilitaires permettant d'automatiser certaines opérations récurrentes liées aux projets et aux agents.
|
||
|
||
Exemples :
|
||
|
||
- génération automatique du `CLAUDE.md` d’un projet
|
||
- création du symlink `AGENTS.md -> CLAUDE.md`
|
||
- bootstrap de la mémoire projet
|
||
|
||
Dossier :
|
||
|
||
```
|
||
scripts/
|
||
```
|
||
|
||
Script principal :
|
||
|
||
- `scripts/generate_project_claude.sh` — génère le `CLAUDE.md` d’un projet et crée `AGENTS.md -> CLAUDE.md`
|
||
|
||
---
|
||
|
||
## BMAD
|
||
|
||
Documentation sur l’articulation entre la méthode BMAD et cette base de connaissance.
|
||
|
||
Dossier :
|
||
|
||
```
|
||
80_bmad/
|
||
```
|
||
|
||
Fichiers principaux :
|
||
|
||
- `80_bmad/articulation_avec_lead_tech.md`
|
||
- `80_bmad/process_llm_et_parallelisation.md`
|
||
|
||
---
|
||
|
||
## 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é.
|