_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

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