_Assistant_Lead_Tech/80_bmad/articulation_avec_lead_tech.md

BMAD — Articulation avec Lead_tech

BMAD fournit une méthode de travail basée sur des agents spécialisés.

Le repository Lead_tech fournit :

• la mémoire inter-projets
• les conventions globales
• les patterns validés
• les décisions d'architecture

---

Principe

BMAD ne remplace pas Lead_tech.

BMAD s'appuie dessus.

---

Répartition des responsabilités

Lead_tech

Contient :

• patterns validés
• décisions d'architecture
• conventions globales
• playbooks
• post-mortems

Projet

Contient :

• le code
• les règles spécifiques
• l'architecture locale
• les conventions propres au projet

Agents BMAD

Responsables de :

• cadrer
• implémenter
• reviewer
• améliorer le code
• capitaliser les apprentissages vers Lead_tech

---

Lecture obligatoire avant de travailler

Avant d'introduire un nouveau pattern, une nouvelle convention ou une nouvelle architecture, les agents DOIVENT lire les fichiers Lead_tech correspondants.

Type de tâche	Fichiers à lire en priorité
Backend (API, services)	10_backend_patterns_valides.md, 10_backend_risques_et_vigilance.md
Frontend / mobile	10_frontend_patterns_valides.md, 10_frontend_risques_et_vigilance.md
Architecture / design	40_decisions_et_archi.md
Debug / investigation	90_debug_et_postmortem.md
n8n / automatisations	10_n8n_patterns_valides.md, 10_n8n_nodes_a_risques.md

Règle : si un pattern Lead_tech existe et couvre le besoin, l'appliquer directement sans réinventer.

---

Hiérarchie de contexte

1. contraintes techniques réelles
2. règles du projet (CLAUDE.md projet)
3. règles globales (Lead_tech)

---

Communication bi-directionnelle — Capitalisation

Les agents BMAD ne se contentent pas de lire Lead_tech. Ils y contribuent activement en remontant les apprentissages.

Zone de capitalisation

Le fichier cible pour toutes les propositions est :

$LEADTECH/95_a_capitaliser.md

$LEADTECH est une variable d'environnement définie automatiquement sur Mac et sur le NUC via scripts/aliases.sh. Elle pointe vers le repo Lead_tech de la machine courante.

En pratique :

• Mac : ~/AI_RULES/_Assistant_Lead_Tech/95_a_capitaliser.md
• NUC : /srv/projects/_Assistant_Lead_Tech/95_a_capitaliser.md

Quand capitaliser

Un apprentissage mérite d'être remonté si :

• un bug difficile a été résolu
• un anti-pattern a été identifié
• un pattern réutilisable a émergé
• une décision d'architecture structurante a été prise
• une contrainte technique inattendue a été rencontrée

À quel moment dans le workflow BMAD

Moment	Action
Fin d'une story	Vérifier si un pattern réutilisable a émergé
Résolution d'un bug difficile	Écrire une entrée dans 95_a_capitaliser.md
Choix d'architecture notable	Proposer une entrée dans 40_decisions_et_archi.md
Fin de sprint / milestone	Relire 95_a_capitaliser.md et valider ou supprimer

Format de la proposition

DATE — PROJET

FILE_UPDATE_PROPOSAL
Fichier cible : <nom_du_fichier>

Pourquoi :
<raison en 1-2 phrases>

Proposition :
<contenu suggéré>

Exemple :

2026-03-08 — app-alexandrie

FILE_UPDATE_PROPOSAL
Fichier cible : 10_backend_patterns_valides.md

Pourquoi :
L'ordre d'enregistrement des guards NestJS a causé request.user undefined
dans EmailVerifiedGuard lors de l'implémentation de l'auth.

Proposition :
Toujours enregistrer AuthGuard en premier dans providers[] avant tout guard
qui lit request.user.

Règle importante

Les agents peuvent écrire librement dans 95_a_capitaliser.md.

Ils ne doivent jamais écrire directement dans les fichiers de connaissance validée (10_*, 40_*, 90_*).

La validation et l'intégration finale sont faites par le développeur.

---

Résumé du flux complet

Lead_tech
  ↓ (lecture avant implémentation)
Agent BMAD
  ↓ (implémentation)
Apprentissage détecté
  ↓
$LEADTECH/95_a_capitaliser.md
  ↓ (validation humaine)
Lead_tech (fichier approprié)