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