# 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", strict=true)`
- Regle: HALT si `blocking_issues` non vide, override humain trace.

3. Post-patch (Builder)
- Appel: `validate_patch(domain, diff_text, changed_files, strict=true)`
- Regle: HALT avant statut `review` si `blocking_issues` non vide.
- Resultat ajoute au Dev Agent Record et a `Leadtech MCP Gates`.

4. Review (Reviewer)
- Appel: `emit_checklist(agent_role="reviewer", domain, story_text)`
- Appel: `validate_patch(domain, diff_text, changed_files, strict=false)` (advisory, le blocage a deja eu lieu cote dev).
- Option: relancer `validate_patch` sur le diff final de PR.

5. Cloture et apprentissage (Curator) — **flux humain manuel**
- Aucun agent BMAD dedie au role Curator.
- Le `propose_capitalization(...)` est appele indirectement: les agents (dev, qa, architect, sm, pm, ux-designer) ont une `memory` qui leur fait ajouter directement dans `95_a_capitaliser.md` quand un apprentissage emerge.
- Le triage est execute par l'humain via le skill `capitalisation-triage` (`skills/capitalisation-triage/SKILL.md`), qui s'appuie sur le tool MCP `triage_capitalization()` pour la pre-analyse heuristique.

## Statut de rollout

- Phase 1 (advisory only): achevee.
- Phase 2 (3 blocages stricts cibles): **statut actuel**.
  - `validate_patch`: patch sans fichier source = artefacts BMAD seuls.
  - `validate_patch`: sessions sans expiresAt visible.
  - `validate_plan`: plan backend sans reference aux contrats partages.
- Phase 3 (elargissement): a evaluer apres observation des faux positifs sur 10 a 20 stories.

Documents operationnels associes :

- `mcp/leadtech_bmad_mcp/docs/rollout_bmad_advisory.md`
- `mcp/leadtech_bmad_mcp/docs/pilot_bmad_10_stories.md`

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