MaksTinyWorkshop
ef24d85d57
Triage des 27 propositions du buffer de capitalisation (skill capitalisation-triage), avec vérification des doublons contre la base. Intégré dans knowledge/ (23 entrées): - backend: redis (compensation incrBy non-atomique), nestjs (injection cassée sous tsx watch; guard write mode dégradé), async (test rollback pipeline multi-fichiers), contracts (idempotence POST), auth (disclosure comptes soft-deleted), prisma (index partial soft-delete), llm-providers (nouveau: OAuth vs API key, prompt caching). - frontend: tests (garde-fous parking Later), navigation (fichiers non-route sous src/app Expo Router), general (type client vs payload backend), state (fallback catch-all mapping DB→UI). - workflow: story-tracking (statut BMAD vs narratif obsolète). - product: general (nouveau: doc feature store sans UI). - infra: NOUVEAU DOMAINE (traefik, tailscale, docker, docker-networking, reverse-proxy-paths, sidecar tailscale) + 00_INDEX.md. Autres: - 90_debug_et_postmortem.md: post-mortem réseau Docker partagé hors compose. - Rejeté 3 doublons (types enum contracts, getter PrismaService, $transaction). - Buffer 95_a_capitaliser.md purgé et restauré à son état initial. - _projects.conf: MAJ statuts epics + ajout app-rl799.
3.7 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
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 versCLAUDE.mdpour 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/ |
| Infra | knowledge/infra/patterns/ |
knowledge/infra/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.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/
Fichiers principaux :
80_bmad/articulation_avec_lead_tech.md80_bmad/process_llm_et_parallelisation.md80_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é.