fe04edb7bf
- Nouveaux fichiers : 10_product_patterns_valides.md, 10_conventions_redaction.md - Templates n8n déplacés vers 70_templates/ (workflow + intégration) - Contenu 10_n8n_README.md absorbé dans les fichiers dédiés patterns/risques - Suppression des stubs 10_n8n_README.md, 20_worklows_README.md, 30_integrations_README.md - Index, _AI_INSTRUCTIONS, 95_a_capitaliser et post-bmad-install.sh mis à jour Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
3.0 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.md10_product_patterns_valides.md10_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_nodes_a_risques.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.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é.