Files
_Assistant_Lead_Tech/80_bmad/articulation_avec_lead_tech.md
MaksTinyWorkshop 18341c10a1 feat: ajout couverture UX/UI dans Lead_tech
- Création 10_ux_patterns_valides.md et 10_ux_risques_et_vigilance.md
- Référencés dans 00_INDEX.md, _AI_INSTRUCTIONS.md, CLAUDE.md
- Tableau de lecture BMAD mis à jour (ligne UX ajoutée)
- Format Fichier cible mis à jour partout pour inclure les fichiers UX
- post-bmad-install.sh : memory bmm-ux-designer pointe vers les bons fichiers
2026-03-08 19:27:08 +01:00

4.9 KiB

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
UX / design 10_ux_patterns_valides.md, 10_ux_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 : <10_backend_patterns_valides.md | 10_frontend_patterns_valides.md | 10_ux_patterns_valides.md | 10_backend_risques_et_vigilance.md | 10_frontend_risques_et_vigilance.md | 10_ux_risques_et_vigilance.md | 40_decisions_et_archi.md | 90_debug_et_postmortem.md>

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é)