_Assistant_Lead_Tech/80_bmad/integration_mcp_sidecar.md

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)

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.