Navegar↑↓Espaço
BMAD METHOD
MCP SERVERS & COPILOT
BMAD v6 // MCP PROTOCOL
01 BMAD Method
02 Serena MCP opcional
03 Context Mode MCP opcional
TECH ARCHITECTURE LABS // BMAD + MCP

Infraestrutura completa de
desenvolvimento assistido por IA

Um processo consistente, previsível e seguro combinando MCP Servers, Agentes BMAD e instruções especializadas do Copilot.

BMAD
Multi-Agent Specs
Serena
AST & Language Server · opcional
Context
Sandbox & Memory · opcional
Navegação semânticaSandbox isoladaMemória persistenteContratos no GitAnálise de impactoThink in CodeNavegação semânticaSandbox isoladaMemória persistenteContratos no GitAnálise de impactoThink in Code
02
BMAD METHOD
MCP SERVERS & COPILOT
PARADIGM SHIFT // 02
OBJETIVO & PARADIGMA // POR QUE MCP + SPECS

Desenvolvimento consistente, previsível e seguro

HOJE
O problema do chat desconectado
Antes
Arquivos inteiros enviados sem necessidade
Para mexer em uma função, o arquivo todo vai no prompt.
Janela de contexto esgotada, alucinações
Com o contexto cheio, o modelo esquece o começo e inventa o resto.
Nenhuma memória das decisões
A sessão seguinte começa do zero, sem saber o que já foi decidido.
COM BMAD + MCP
A solução BMAD + MCP
Depois
Navegação semântica por símbolos
O Serena lê a AST pelo language server: o agente pede o símbolo pelo nome e recebe só aquela função, não o arquivo inteiro.
Execução segura em sandbox
O Context Mode executa o código num ambiente isolado: nada toca a máquina nem o repositório, e só o resultado volta.
Analyst → Architect → Dev → Reviewer
Cada agente entrega um documento ao seguinte: análise, plano, código e revisão.
Os contratos ficam versionados no Git, não na memória da sessão.
02 / 17
03
BMAD METHOD
MCP SERVERS & COPILOT
INFRAESTRUTURA // 03
INFRAESTRUTURA // MCP SERVERS

A dupla de
servidores MCP

Operações semânticas sobre a AST do código e gestão da janela de contexto.

2 SERVIDORES
No WSL, Node, uv e Python se resolvem uma vez: depois é só o comando de cada servidor.
03 / 17
04
BMAD METHOD
MCP SERVERS & COPILOT
ROTEAMENTO // 04
ROTEAMENTO // GUIA DE ESCOLHA DOS FLUXOS

Visão geral dos
fluxos por tipo de demanda

Cada tipo de tarefa tem uma cadeia de agentes própria, para evitar burocracia.

6 FLUXOS
Escolher o fluxo errado custa mais caro do que não ter fluxo nenhum.
04 / 17
05
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 05
FLUXO 1 // CORREÇÃO DE BUGS

Fluxo:
Correção de bugs

Utilizado para correções pequenas ou localizadas.

9 ETAPAS
Sem plano de arquitetura para um bug de uma linha.
05 / 17
06
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 06
FLUXO 2 // NOVA FUNCIONALIDADE

Fluxo:
Nova funcionalidade

Fluxo recomendado para desenvolvimento de novas funcionalidades.

14 ETAPAS
O fluxo mais longo do conjunto: o único com PM na entrada e Tech Writer na saída.
06 / 17
07
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 07
FLUXO 3 // REFATORAÇÃO

Fluxo:
Refatoração

Utilizado quando houver alterações arquiteturais, mudanças em vários módulos ou necessidade de reorganização significativa do código.

11 ETAPAS
É o fluxo 1 com o Architect no meio: o plano vem antes de mexer em vários módulos.
07 / 17
08
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 08
FLUXO 4 // INTERFACE E EXPERIÊNCIA

Fluxo:
Desenvolvimento de interface (UI/UX)

Quando a tarefa envolver telas, experiência do usuário ou alterações significativas de interface.

10 ETAPAS
O único fluxo com UX Designer, e o único que dispensa o review.md no fim.
08 / 17
09
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 09
FLUXO 5 // SPIKE TÉCNICO

Fluxo:
Spike técnico / prova de conceito (PoC)

Fluxo recomendado para avaliar tecnologias, arquiteturas ou soluções antes da implementação definitiva.

6 ETAPAS
Não passa por Dev nem por Reviewer: a entrega é a decisão, não o código.
09 / 17
10
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 10
FLUXO 6 // DOCUMENTAÇÃO TÉCNICA

Fluxo:
Atualização de documentação

Quando a implementação exigir atualização de documentação técnica.

4 ETAPAS
Quatro etapas e um único agente: é o fluxo mais curto do conjunto.
10 / 17
11
BMAD METHOD
MCP SERVERS & COPILOT
DIRECTORY LAYOUT // 11
ARQUITETURA DE ARQUIVOS // AGENTS & SKILLS

Estrutura no repositório
e skills reutilizáveis

01 // PERSONAS
.github/agents/

Agentes do Copilot em *.agent.md, com personalidade, escopo e comandos próprios.

02 // RECURSOS
.agents/

Configurações, módulos, templates e recursos compartilhados na execução dos workflows.

03 // CAPACIDADES
.agents/skills/

Capacidades reutilizáveis entre agentes: documentação, requisitos, planejamento, código e revisão.

A arquitetura de Skills evita duplicação de lógica e mantém cada agente no seu escopo.
11 / 17
12
BMAD METHOD
MCP SERVERS & COPILOT
INSTRUCTION PIPELINE // 12
GOVERNANÇA // COPILOT INSTRUCTIONS

Instruções especializadas em
.github/instructions

01
copilot-instructions.md

Arquivo central que referencia todas as instruções especializadas.

02
workspace & bmad

Estrutura do workspace, microsserviços e escopo de cada agente.

03
serena & context-mode

Roteamento para AST e regras de economia de contexto com Think in Code.

04
tests & commit

Testes Jest em Arrange-Act-Assert e Conventional Commits em português.

Regras que o agente lê antes de você digitar, para você não repetir contexto no prompt.
12 / 17
13
BMAD METHOD
MCP SERVERS & COPILOT
GOLDEN RULES // 13
GOVERNANÇA // REGRAS DE OURO

Boas práticas e
separação de papéis

Analyst

Único responsável pelo entendimento do problema e das regras.

Architect

Define a estratégia técnica antes de qualquer linha de código.

Developer

Só implementa. Nunca use para planejar ou revisar.

Reviewer

Valida qualidade, cobertura de testes e regressões.

Tech Writer

Mantém a documentação de engenharia em dia.

Builder

Customiza os próprios agentes do BMAD.

Seis papéis, zero sobreposição: é isso que impede a contaminação de contexto.
13 / 17
14
BMAD METHOD
MCP SERVERS & COPILOT
SETUP // 14
SETUP // INSTALAÇÃO DO BMAD

Um comando instala
o time inteiro

O instalador escreve o diretório _bmad/ no projeto e registra os módulos escolhidos.

Node.js 20.12+ Python 3.10+ uv astral.sh/uv
wsl : bash
$
bmad-build abre o fluxo; bmad-help diz o que vem depois.
MÓDULOS OFICIAIS
BMad Method
Planejar e entregar software, do protótipo novo à base de código estabelecida.
BMad Builder
Construtor de skills, workflows e agentes.
Creative Intelligence Suite
Parceiros de pensamento criativo para inovação, design thinking e narrativa.
BMad Test Architect
Complemento de testes corporativos para o BMad Method.
BMad Loop
Constrói, verifica e faz o retro de um épico inteiro sem supervisão.
BMad Game Dev Studio
Idealizar, projetar e construir jogos em Unity, Unreal, Godot ou Phaser.
14 / 17
15
BMAD METHOD
MCP SERVERS & COPILOT
LIVE CLI // 15
HANDS-ON // TERMINAL & COMANDOS

Execução no
terminal vivo

Um mcp.json declara os dois servidores. Quatro comandos acionam o time inteiro de agentes.

.vscode/mcp.json
{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/oraios/serena",
        "serena",
        "start-mcp-server"
      ]
    },
    "context-mode": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}
bmad-mcp-workspace : zsh
$
15 / 17
16
BMAD METHOD
MCP SERVERS & COPILOT
CONTEXT MODE // 16
CONTEXT MODE // MEMÓRIA PERSISTENTE

O contexto que não se perde

16 / 17
17
BMAD METHOD
MCP SERVERS & COPILOT
DOCUMENTATION COMPLETE // 17
RESULTADOS & IMPACTO // REFERÊNCIAS OFICIAIS

A tríade consolidada de engenharia assistida por IA

Suba os dois MCP Servers, rode o Fluxo 1 e compare com a sua última sessão de chat.

01
BMAD Method

Processo ágil multiagente com fases estritas e contratos em Markdown.

github.com/bmad-code-org →
02
Serena MCP

Navegação e refatoração semântica na AST via LSP, sem enviar arquivos inteiros.

github.com/oraios/serena →
03
Context Mode MCP

Execução em sandbox, indexação de memória e filtragem da janela de contexto.

github.com/mksglu/context-mode →
17 / 17