mirror of
https://github.com/MaksTinyWorkshop/_Assistant_Lead_Tech
synced 2026-06-28 01:53:40 +02:00
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.
198 lines
3.7 KiB
Markdown
198 lines
3.7 KiB
Markdown
# 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/` |
|
||
| 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.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é.
|