msd-core/docs/pt-BR

Documentação do MSD Core

A documentação está organizada em quatro quadrantes: tutoriais ajudam você a aprender na prática, guias de instruções resolvem tarefas específicas, referência apresenta fatos autorizados, e explicação explora conceitos e decisões de design.

Versões por idioma: English · Português (pt-BR) · 日本語 · 简体中文

---

Tutorials

• Seu primeiro projeto — da instalação à primeira fase entregue, um caminho garantido
• Integrando uma base de código existente — leve o MSD Core a um repositório já existente

---

How-to guides

• Instalar no seu ambiente de execução — passos de instalação específicos para cada um dos 15 ambientes de execução suportados
• Discutir uma fase — registrar decisões de implementação antes do início do planejamento
• Planejar uma fase — executar pesquisa, decompor o trabalho e verificar a qualidade do plano
• Executar uma fase — rodar planos em ondas paralelas com subagentes com contexto renovado
• Verificar e entregar — revisar o trabalho concluído, diagnosticar falhas e criar o PR
• Rodar fases de forma autônoma — usar o modo autônomo para execução de fases sem supervisão
• Lidar com tarefas rápidas e ágeis — usar /msd-quick e /msd-fast para trabalho avulso fora do ciclo de fases
• Configurar perfis de modelo — alternar entre níveis de modelo: qualidade, equilibrado e econômico
• Configurar revisão entre IAs — configurar uma segunda IA para revisar o código produzido pelo agente principal
• Trabalhar em paralelo com workstreams — executar linhas de trabalho independentes simultaneamente usando workstreams
• Isolar trabalho com workspaces — usar workspaces para isolar mudanças experimentais ou arriscadas
• Depurar uma execução com falha — diagnosticar e recuperar de execuções de fase quebradas ou incompletas
• Explorar e esboçar — usar /msd-spike e /msd-sketch para trabalho exploratório antes de comprometer com um plano
• Projetar uma fase de UI — usar o ciclo de fase de UI para trabalho de frontend e visual
• Conduzir o MSD a partir de uma issue do rastreador — iniciar uma fase a partir de uma issue do GitHub, Linear ou Jira
• Migrar do GSD 2 — atualizar um projeto GSD 2 existente para o MSD Core
• Atualizar o MSD — executar novamente o instalador para obter a versão mais recente
• Recuperar e solucionar problemas — corrigir problemas comuns, reconstruir contexto e desinstalar

---

Referência

• Comandos — todos os comandos com flags e exemplos
• Configuração — schema completo de configuração, perfis de modelo, estratégias de branching git
• Ferramentas CLI — API programática msd-tools.cjs para workflows e agentes
• Funcionalidades — índice completo de funcionalidades
• Inventário — skills instaladas e mapa de superfície
• Schema do STATE.md — referência campo a campo para .planning/STATE.md
• Schema do CONTEXT.md — referência campo a campo para .planning/phases/<N>/CONTEXT.md
• Schema do PLAN.md — referência campo a campo para .planning/phases/<N>/PLAN.md
• Artefatos de planejamento — todos os arquivos .planning/ e seus papéis

---

Explicação

• Engenharia de contexto — como a degradação de contexto se forma e como o MSD Core a previne
• O ciclo de fase — racional de design para o ciclo Discuss → Plan → Execute → Verify → Ship
• Orquestração multi-agente — como os subagentes são criados, delimitados e coordenados
• Modelo de segurança — limites de confiança, permissões e automação segura
• Arquitetura — arquitetura do sistema, modelo de agentes e fluxo de dados
• Modos de discussão — modo de suposições vs. modo de entrevista para /msd-discuss-phase
• Monitoramento de contexto — arquitetura do hook de monitoramento da janela de contexto
• Orquestração orientada por issues — receita para conduzir o MSD a partir de uma issue do rastreador usando primitivos existentes

---

Relacionados

• README raiz — página inicial, início rápido e visão geral da documentação
• Changelog — histórico de versões