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 / 20
03
BMAD METHOD
MCP SERVERS & COPILOT
SERENA MCP // 03
SERENA MCP // AST + LSP

As duas leituras
que o Serena faz do código

Uma diz como o código está organizado. A outra, como as partes se relacionam.

AST
Estrutura do código
Entende como o código está organizado: classes, métodos, funções e parâmetros.
class UserService { public function createUser() {} }
→ O Serena identifica a classe UserService e, dentro dela, o método createUser().
LSP
Navegação e relações
Entende como as partes se relacionam: definições, referências, tipos e usos.
$userService->createUser();
→ O Serena descobre onde createUser() foi definido e todos os lugares que o chamam.
NA PRÁTICA
“Onde está UserService::createUser() e quem usa esse método?”
Em vez de ler ou buscar texto em centenas de arquivos, o agente pergunta isto.
Menos código no prompt Menos tokens gastos Mais contexto livre Navegação precisa
O ganho não é ler mais rápido: é não precisar ler o que não importa.
03 / 20
04
BMAD METHOD
MCP SERVERS & COPILOT
CONTEXT MODE // 04
CONTEXT MODE // OTIMIZAÇÃO DE CONTEXTO

Um filtro entre
as ferramentas e o LLM

Processa o volume bruto antes dele ocupar a janela e entrega ao modelo só o que importa.

EXEMPLO · LOGS
20.000
linhas de log
→ Context Mode →
50
linhas relevantes
Sem o filtro, as vinte mil linhas iam inteiras para o modelo, e quase todas eram ruído.
EXEMPLO · BUSCA
15.000
linhas em dezenas de arquivos
→ Context Mode →
3
arquivos com o erro
O modelo precisa da lista curta, não do resultado bruto da busca.
EM UMA FRASE
O processamento acontece fora da janela; o que entra nela é só o resultado.
É o par do Serena: um reduz o que se pede, o outro reduz o que volta.
Menos tokens consumidos Menos informação irrelevante Mais espaço na janela Respostas mais focadas Melhor desempenho em tarefas longas
Janela de contexto não é memória infinita: é orçamento, e o filtro é quem administra.
04 / 20
05
BMAD METHOD
MCP SERVERS & COPILOT
INFRAESTRUTURA // 05
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.
05 / 20
06
BMAD METHOD
MCP SERVERS & COPILOT
CONFIGURAÇÃO // 06
CONFIGURAÇÃO // UM ARQUIVO, DOIS SERVIDORES

O arquivo que
liga tudo

Um JSON no repositório declara os dois servidores. Quem clonar o projeto já os tem.

.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"
      ]
    }
  }
}
SERENA
Sobe pelo uvx, direto do repositório
Sem clonar e sem instalar: o --from aponta para o Git e o uvx resolve o resto.
CONTEXT MODE
Sobe pelo npx, com o -y
Pacote publicado no npm: o -y dispensa a pergunta de instalação na primeira vez.
ONDE FICA
Versionado com o projeto
Em .vscode/mcp.json. A configuração é do repositório, não da máquina de cada um.
06 / 20
07
BMAD METHOD
MCP SERVERS & COPILOT
ROTEAMENTO // 07
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.
07 / 20
08
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 08
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.
08 / 20
09
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 09
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.
09 / 20
10
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 10
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.
10 / 20
11
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 11
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.
11 / 20
12
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 12
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.
12 / 20
13
BMAD METHOD
MCP SERVERS & COPILOT
WORKFLOW // 13
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.
13 / 20
14
BMAD METHOD
MCP SERVERS & COPILOT
DIRECTORY LAYOUT // 14
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.
14 / 20
15
BMAD METHOD
MCP SERVERS & COPILOT
INSTRUCTION PIPELINE // 15
GOVERNANÇA // COPILOT INSTRUCTIONS

Instruções especializadas em
.github/instructions

01
copilot-instructions.md

O arquivo central: aponta para todas as instruções especializadas.

02
workspace & bmad

Como o workspace é organizado, quais são os microsserviços e até onde vai cada agente.

03
serena & context-mode

Quando consultar o código pelo Serena, em vez de ler arquivo inteiro, e como gastar menos contexto.

04
tests & commit

Testes com Jest no front e PHPUnit no back, sempre no formato preparar, executar e verificar. Mensagem de commit no padrão Conventional Commits, escrita em português.

Regras que o agente lê antes de você digitar, para você não repetir contexto no prompt.
15 / 20
16
BMAD METHOD
MCP SERVERS & COPILOT
GOLDEN RULES // 16
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.
16 / 20
17
BMAD METHOD
MCP SERVERS & COPILOT
SETUP // 17
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.
17 / 20
18
BMAD METHOD
MCP SERVERS & COPILOT
LIVE CLI // 18
HANDS-ON // TERMINAL & COMANDOS

Execução no
terminal vivo

Com o mcp.json no lugar, quatro comandos acionam o time inteiro de agentes.

bmad-mcp-workspace : zsh
$
18 / 20
19
BMAD METHOD
MCP SERVERS & COPILOT
FECHAMENTO // 19
FECHAMENTO // O QUE MUDA NA PRÁTICA

O agente para de adivinhar
e passa a consultar

19 / 20
20
BMAD METHOD
MCP SERVERS & COPILOT
DOCUMENTATION COMPLETE // 20
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 →
20 / 20