Files
_Assistant_Lead_Tech/80_bmad/integration_mcp_sidecar.md
Claude 3ce243591c docs(mcp-rollout): clarify Curator as human-driven flow (no BMAD agent)
Le role Curator de la doc rollout n'avait pas d'agent BMAD dedie, ce
qui laissait planer un doute sur ses points d'invocation. Clarification :

- Pas d'agent BMAD Curator. Le role est execute par l'humain.
- Les autres agents (dev, qa, architect, sm, pm, ux-designer) ecrivent
  directement dans 95_a_capitaliser.md via leurs memories — pas besoin
  de propose_capitalization en critical_action.
- Le triage est manuel via le skill capitalisation-triage et le tool
  MCP triage_capitalization() pour la pre-analyse heuristique.
- propose_capitalization reste utile en interactif quand l'humain veut
  formaliser une entree.
2026-05-07 07:59:57 +00:00

2.8 KiB

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
  1. Pre-implementation (Builder)
  • Appel: validate_plan(domain, plan_text, agent_role="builder", strict=true)
  • Regle: HALT si blocking_issues non vide, override humain trace.
  1. 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.
  1. 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.
  1. 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.