# 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.