# 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

Patterns éprouvés en production ou en projets réels.

- `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`

---

## 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`
- `10_ux_risques_et_vigilance.md`
- `10_n8n_risques_et_vigilance.md`

---

## 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é.
