_Assistant_Lead_Tech/00_INDEX.md

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
• 80_bmad/integration_mcp_sidecar.md

---

MCP (expérimental)

Squelette de serveur MCP orienté support BMAD (guidance, gates, capitalisation).

Dossier :

mcp/leadtech_bmad_mcp/

---

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