18341c10a1
- 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
2.9 KiB
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
Structure de la base de connaissance
Contexte global
-
CLAUDE.md
Instructions globales chargées automatiquement par les agents. -
AGENTS.md
Alias versCLAUDE.mdpour compatibilité avec certains outils.
Patterns validés
Patterns éprouvés en production ou en projets réels.
10_backend_patterns_valides.md10_frontend_patterns_valides.md10_ux_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
Workflows et intégrations
Procédures de travail et intégrations techniques.
20_workflows_README.md30_integrations_README.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.mdpour 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.mdd’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 leCLAUDE.mdd’un projet et créeAGENTS.md -> CLAUDE.md
BMAD
Documentation sur l’articulation entre la méthode BMAD et cette base de connaissance.
Dossier :
80_bmad/
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é.