a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
10 KiB
Como instalar o MSD Core no seu ambiente de execução
Instale o MSD Core (@golem15/msd-core) no ambiente de codificação com IA que você usa no dia a dia. Este guia apresenta o caminho padrão de instalação para cada ambiente suportado e, em seguida, cobre o caminho manual para máquinas sem Node.js.
O que você precisa: Node.js 18+ e npm (ou npx). Se você não tem Node.js, vá para Instalando sem Node.js.
Por que o instalador é necessário
O MSD Core distribui arquivos de agente e comando no formato nativo de frontmatter do Claude Code. Cada ambiente suportado espera um schema, layout de diretório e sintaxe de invocação de comandos diferente. O instalador realiza as transformações necessárias — por exemplo, convertendo listas de ferramentas e valores de cor para o OpenCode e escrevendo entradas TOML de agente para o Codex.
Não copie arquivos de agents/ ou commands/ diretamente. Fazer isso ignora as transformações e produz erros de validação de schema ou comandos ausentes.
Instalação padrão
Execute o instalador a partir de qualquer diretório. Ele solicita o seu ambiente e se a instalação deve ser global (todos os projetos) ou local (apenas este projeto).
npx @golem15/msd-core@latest
Esse é o único comando necessário para uma instalação nova ou para executar o instalador novamente após trocar de ambiente.
Instruções por ambiente
Claude Code
npx @golem15/msd-core@latest --claude --global
As habilidades são instaladas em ~/.claude/. Os comandos aparecem como slash commands /msd-* na sua próxima sessão do Claude Code. Reinicie o Claude Code para carregá-los.
Instalação em ambos os escopos --global e --local. Essa é uma configuração suportada, mas as próprias regras de resolução de gatilhos do Claude Code — escopo pessoal sobrepõe escopo de projeto, e uma skill sobrepõe um comando de mesmo nome — apontam para a mesma direção: a skill global sempre vence o gatilho /msd-<nome> sobre o comando local. O MSD Core detecta isso e imprime qual escopo está vencendo logo após a instalação (e reporta o mesmo fato pelo /msd-health como o diagnóstico W028); é um aviso, não uma falha — a instalação em si continua bem-sucedida. No escopo global, a referência da spec de workflow da skill vencedora é resolvida em tempo de execução em relação ao seu diretório de trabalho primeiro, então um projeto com seu próprio .claude/msd-core/ ainda obtém suas próprias specs mesmo que a skill global seja o que o Claude Code invoca.
Substituir o diretório de instalação:
CLAUDE_CONFIG_DIR=~/.claude-alt npx @golem15/msd-core@latest --claude --global
OpenCode
npx @golem15/msd-core@latest --opencode --global
As habilidades são instaladas em ~/.config/opencode/ (XDG) ou ~/.opencode/. O instalador converte o frontmatter dos agentes para o schema do OpenCode — removendo o campo tools: e convertendo valores de cor para hex. Consulte Instalando sem Node.js — transformações do OpenCode se você precisar entender o que muda.
Substituir o diretório de instalação:
OPENCODE_CONFIG_DIR=~/.config/opencode-alt npx @golem15/msd-core@latest --opencode --global
Kilo
npx @golem15/msd-core@latest --kilo --global
As habilidades são instaladas em ~/.config/kilo/ (XDG) ou ~/.kilo/. Usa o mesmo formato de comando markdown plano no estilo OpenCode.
Substituir o diretório de instalação:
KILO_CONFIG_DIR=~/.config/kilo-alt npx @golem15/msd-core@latest --kilo --global
Codex
npx @golem15/msd-core@latest --codex --global
As habilidades são instaladas em ~/.codex/skills/msd-*/SKILL.md. Os agentes são registrados com entradas TOML por agente em config.toml. Reinicie o Codex (ou execute codex --reload) após a instalação.
Versão mínima suportada: Codex CLI 0.130.0. Versões anteriores tinham varredura adicional de raiz de habilidades que pode produzir listagens duplicadas.
GitHub Copilot
npx @golem15/msd-core@latest --copilot --global
As habilidades são instaladas em ~/.copilot/. O MSD é instalado como arquivos de agente .md e arquivos de instrução de repositório.
Substituir o diretório de instalação:
COPILOT_CONFIG_DIR=~/.copilot-alt npx @golem15/msd-core@latest --copilot --global
Cursor
npx @golem15/msd-core@latest --cursor --global
As habilidades são instaladas em ~/.cursor/. O MSD instala habilidades, agentes e referências de regras.
Substituir o diretório de instalação:
CURSOR_CONFIG_DIR=~/.cursor-alt npx @golem15/msd-core@latest --cursor --global
Windsurf
npx @golem15/msd-core@latest --windsurf --global
As habilidades são instaladas em ~/.codeium/windsurf/. O MSD instala habilidades, agentes e regras de workspace.
Substituir o diretório de instalação:
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-alt npx @golem15/msd-core@latest --windsurf --global
Cline
O Cline usa uma integração baseada em regras — o MSD é instalado como .clinerules em vez de slash commands.
# Instalação global (todos os projetos)
npx @golem15/msd-core@latest --cline --global
# Instalação local (apenas este projeto)
npx @golem15/msd-core@latest --cline --local
Instalações globais escrevem em ~/.cline/. Instalações locais escrevem em ./.cline/. As regras são carregadas automaticamente pelo Cline — nenhum slash command personalizado é registrado.
CodeBuddy
npx @golem15/msd-core@latest --codebuddy --global
As habilidades são instaladas em ~/.codebuddy/skills/msd-*/SKILL.md.
Qwen Code
O Qwen Code usa o mesmo padrão de habilidades abertas do Claude Code 2.1.88+.
npx @golem15/msd-core@latest --qwen --global
As habilidades são instaladas em ~/.qwen/skills/msd-*/SKILL.md.
Substituir o diretório de instalação:
QWEN_CONFIG_DIR=~/.qwen-alt npx @golem15/msd-core@latest --qwen --global
Augment Code
npx @golem15/msd-core@latest --augment --global
As habilidades são instaladas em ~/.augment/. O MSD instala habilidades e agentes. Sem posse de hook ou statusline.
Antigravity
npx @golem15/msd-core@latest --antigravity --global
O instalador detecta automaticamente o diretório de configuração do Antigravity (~/.gemini/antigravity, ~/.gemini/antigravity-ide ou ~/.gemini/antigravity-cli). Usa a política de configurações compatível com Gemini.
Substituir o diretório de instalação:
ANTIGRAVITY_CONFIG_DIR=~/.gemini/antigravity-alt npx @golem15/msd-core@latest --antigravity --global
Trae
npx @golem15/msd-core@latest --trae --global
As habilidades são instaladas em ~/.trae/. O MSD instala habilidades, agentes e referências de regras.
Instalação local vs global
Todos os exemplos acima usam --global, que instala o MSD uma vez para a sua conta de usuário. Para limitar uma instalação a um único projeto, substitua --global por --local:
npx @golem15/msd-core@latest --claude --local
Uma instalação local escreve no diretório .claude/ na raiz do seu projeto. As configurações de instalação local têm precedência sobre as globais quando ambas existem.
Instalando edições de pré-lançamento (Next / Nightly / Insiders / Preview)
As edições de pré-lançamento dos ambientes (Windsurf Next, Cursor Nightly, VS Code Insiders, canais de preview do Codex, etc.) leem de um diretório de configuração irmão. Defina a variável de ambiente *_CONFIG_DIR correspondente antes de executar o instalador:
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-next npx @golem15/msd-core@latest --windsurf --global
Selecione o ambiente estável correspondente no prompt do instalador. O MSD não enumera as edições de pré-lançamento como ambientes nomeados separados — elas são suportadas com melhor esforço por meio desse mecanismo de variável de ambiente e não são testadas separadamente no CI de lançamento.
Instalando sem Node.js
Se você não pode executar npx (por exemplo, em uma máquina Windows sem Node.js), você tem duas opções.
Opção A — Use uma máquina que tenha Node.js. Qualquer máquina com Node.js serve: WSL, uma VM Linux, um runner de CI ou um contêiner Docker. Execute o instalador lá e, em seguida, copie o diretório de saída para a sua máquina de destino. Para o OpenCode:
npx @golem15/msd-core@latest --opencode --global
# Depois copie ~/.config/opencode/agents/ para a máquina Windows
Opção B — Transforme manualmente os arquivos-fonte. Os arquivos-fonte dos agentes estão em agents/ no repositório do MSD Core e estão no formato nativo de frontmatter do Claude Code. Cada ambiente espera um formato diferente. Para as transformações de campo exatas por ambiente, consulte Instalação manual / configuração sem Node.js no Guia do Usuário, que cobre as transformações do OpenCode em detalhes completos e aponta para as funções convert*Frontmatter do instalador para outros ambientes.
Após a instalação
Reinicie seu ambiente para carregar os novos comandos e agentes. Em seguida, inicie um projeto novo ou faça onboarding de um repositório existente:
/msd-new-project # projeto greenfield
/msd-onboard # base de código existente
Se o comando não for encontrado após o reinício, verifique se o diretório de instalação corresponde ao caminho de configuração esperado pelo ambiente. A seção de edições de pré-lançamento acima cobre a incompatibilidade mais comum.