Test MCP_Perso

80_bmad/integration_mcp_sidecar.md

@@ -0,0 +1,57 @@
+# BMAD — Integration MCP Sidecar (Lead_tech)
+
+Ce document decrit le cablage du serveur MCP `leadtech-bmad-mcp` dans BMAD.
+
+## Positionnement
+
+- BMAD reste le systeme d'orchestration.
+- Le MCP Lead_tech est un **appui**: guidance, controles qualite, capitalisation.
+- Le MCP ne pilote ni branche, ni statut, ni execution des stories.
+
+## Points d'injection
+
+1. Entrée story (Analyst)
+- Appel: `get_guidance(domain, task_type="analysis", story_text=...)`
+- Sortie injectee dans la story:
+  - `Patterns a appliquer`
+  - `Risques a eviter`
+  - `Gates de validation`
+
+2. Pre-implementation (Builder)
+- Appel: `validate_plan(domain, plan_text, agent_role="builder")`
+- Regle: pas d'implementation tant que `blocking_issues` n'est pas vide.
+
+3. Post-patch (Builder)
+- Appel: `validate_patch(domain, diff_text, changed_files)`
+- Resultat ajoute au Dev Agent Record.
+
+4. Review (Reviewer)
+- Appel: `emit_checklist(agent_role="reviewer", domain, story_text)`
+- Option: relancer `validate_patch` sur le diff final de PR.
+
+5. Cloture et apprentissage (Curator)
+- Appel: `propose_capitalization(...)` en `dry_run=true` par defaut.
+- Revue periodique: `triage_capitalization()`.
+
+## Mode de rollout recommande
+
+- Phase 1: advisory only (aucun blocage automatique)
+- Phase 2: blocage sur `blocking_issues` uniquement
+- Phase 3: rules strictes sur domaines critiques (backend auth/contracts/sessions)
+
+## Traceabilite
+
+Chaque story BMAD doit contenir une section `Leadtech MCP Gates` avec:
+
+- timestamp
+- tool appele
+- resume des `must_do`, `red_flags`, `blocking_issues`
+- decision humaine associee
+
+## Contraintes de securite
+
+- `LEADTECH_MCP_ALLOW_WRITE=0` en environnement normal.
+- Ecriture activee ponctuellement uniquement pour:
+  - `propose_capitalization(dry_run=false)`
+  - `route_to_project_memory(dry_run=false)`
+- Jamais d'ecriture directe dans `knowledge/*` par tool MCP.