refactor: hard-fork GSD -> MSD (Make Software Done)
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.
This commit is contained in:
Jakub Zych
@@ -1,6 +1,6 @@
|
||||
# Como instalar o GSD Core no seu ambiente de execução
|
||||
# Como instalar o MSD Core no seu ambiente de execução
|
||||
|
||||
Instale o GSD Core (`@opengsd/gsd-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.
|
||||
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](#instalando-sem-nodejs).
|
||||
|
||||
@@ -8,7 +8,7 @@ Instale o GSD Core (`@opengsd/gsd-core`) no ambiente de codificação com IA que
|
||||
|
||||
## Por que o instalador é necessário
|
||||
|
||||
O GSD 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.
|
||||
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.
|
||||
|
||||
@@ -19,7 +19,7 @@ O GSD Core distribui arquivos de agente e comando no formato nativo de frontmatt
|
||||
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).
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest
|
||||
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.
|
||||
@@ -31,17 +31,17 @@ Esse é o único comando necessário para uma instalação nova ou para executar
|
||||
### Claude Code
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --claude --global
|
||||
npx @golem15/msd-core@latest --claude --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.claude/`. Os comandos aparecem como slash commands `/gsd-*` na sua próxima sessão do Claude Code. Reinicie o Claude Code para carregá-los.
|
||||
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 `/gsd-<nome>` sobre o comando local. O GSD Core detecta isso e imprime qual escopo está vencendo logo após a instalação (e reporta o mesmo fato pelo `/gsd-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/gsd-core/` ainda obtém suas próprias specs mesmo que a skill global seja o que o Claude Code invoca.
|
||||
**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:**
|
||||
|
||||
```bash
|
||||
CLAUDE_CONFIG_DIR=~/.claude-alt npx @opengsd/gsd-core@latest --claude --global
|
||||
CLAUDE_CONFIG_DIR=~/.claude-alt npx @golem15/msd-core@latest --claude --global
|
||||
```
|
||||
|
||||
---
|
||||
@@ -49,7 +49,7 @@ CLAUDE_CONFIG_DIR=~/.claude-alt npx @opengsd/gsd-core@latest --claude --global
|
||||
### OpenCode
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --opencode --global
|
||||
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](#opencode--transformações-necessárias) se você precisar entender o que muda.
|
||||
@@ -57,7 +57,7 @@ As habilidades são instaladas em `~/.config/opencode/` (XDG) ou `~/.opencode/`.
|
||||
**Substituir o diretório de instalação:**
|
||||
|
||||
```bash
|
||||
OPENCODE_CONFIG_DIR=~/.config/opencode-alt npx @opengsd/gsd-core@latest --opencode --global
|
||||
OPENCODE_CONFIG_DIR=~/.config/opencode-alt npx @golem15/msd-core@latest --opencode --global
|
||||
```
|
||||
|
||||
---
|
||||
@@ -65,7 +65,7 @@ OPENCODE_CONFIG_DIR=~/.config/opencode-alt npx @opengsd/gsd-core@latest --openco
|
||||
### Kilo
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --kilo --global
|
||||
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.
|
||||
@@ -73,7 +73,7 @@ As habilidades são instaladas em `~/.config/kilo/` (XDG) ou `~/.kilo/`. Usa o m
|
||||
**Substituir o diretório de instalação:**
|
||||
|
||||
```bash
|
||||
KILO_CONFIG_DIR=~/.config/kilo-alt npx @opengsd/gsd-core@latest --kilo --global
|
||||
KILO_CONFIG_DIR=~/.config/kilo-alt npx @golem15/msd-core@latest --kilo --global
|
||||
```
|
||||
|
||||
---
|
||||
@@ -81,10 +81,10 @@ KILO_CONFIG_DIR=~/.config/kilo-alt npx @opengsd/gsd-core@latest --kilo --global
|
||||
### Codex
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --codex --global
|
||||
npx @golem15/msd-core@latest --codex --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.codex/skills/gsd-*/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.
|
||||
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.
|
||||
|
||||
@@ -93,15 +93,15 @@ As habilidades são instaladas em `~/.codex/skills/gsd-*/SKILL.md`. Os agentes s
|
||||
### GitHub Copilot
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --copilot --global
|
||||
npx @golem15/msd-core@latest --copilot --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.copilot/`. O GSD é instalado como arquivos de agente `.md` e arquivos de instrução de repositório.
|
||||
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:**
|
||||
|
||||
```bash
|
||||
COPILOT_CONFIG_DIR=~/.copilot-alt npx @opengsd/gsd-core@latest --copilot --global
|
||||
COPILOT_CONFIG_DIR=~/.copilot-alt npx @golem15/msd-core@latest --copilot --global
|
||||
```
|
||||
|
||||
---
|
||||
@@ -109,15 +109,15 @@ COPILOT_CONFIG_DIR=~/.copilot-alt npx @opengsd/gsd-core@latest --copilot --globa
|
||||
### Cursor
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --cursor --global
|
||||
npx @golem15/msd-core@latest --cursor --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.cursor/`. O GSD instala habilidades, agentes e referências de regras.
|
||||
As habilidades são instaladas em `~/.cursor/`. O MSD instala habilidades, agentes e referências de regras.
|
||||
|
||||
**Substituir o diretório de instalação:**
|
||||
|
||||
```bash
|
||||
CURSOR_CONFIG_DIR=~/.cursor-alt npx @opengsd/gsd-core@latest --cursor --global
|
||||
CURSOR_CONFIG_DIR=~/.cursor-alt npx @golem15/msd-core@latest --cursor --global
|
||||
```
|
||||
|
||||
---
|
||||
@@ -125,29 +125,29 @@ CURSOR_CONFIG_DIR=~/.cursor-alt npx @opengsd/gsd-core@latest --cursor --global
|
||||
### Windsurf
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --windsurf --global
|
||||
npx @golem15/msd-core@latest --windsurf --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.codeium/windsurf/`. O GSD instala habilidades, agentes e regras de workspace.
|
||||
As habilidades são instaladas em `~/.codeium/windsurf/`. O MSD instala habilidades, agentes e regras de workspace.
|
||||
|
||||
**Substituir o diretório de instalação:**
|
||||
|
||||
```bash
|
||||
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-alt npx @opengsd/gsd-core@latest --windsurf --global
|
||||
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-alt npx @golem15/msd-core@latest --windsurf --global
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Cline
|
||||
|
||||
O Cline usa uma integração baseada em regras — o GSD é instalado como `.clinerules` em vez de slash commands.
|
||||
O Cline usa uma integração baseada em regras — o MSD é instalado como `.clinerules` em vez de slash commands.
|
||||
|
||||
```bash
|
||||
# Instalação global (todos os projetos)
|
||||
npx @opengsd/gsd-core@latest --cline --global
|
||||
npx @golem15/msd-core@latest --cline --global
|
||||
|
||||
# Instalação local (apenas este projeto)
|
||||
npx @opengsd/gsd-core@latest --cline --local
|
||||
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.
|
||||
@@ -157,10 +157,10 @@ Instalações globais escrevem em `~/.cline/`. Instalações locais escrevem em
|
||||
### CodeBuddy
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --codebuddy --global
|
||||
npx @golem15/msd-core@latest --codebuddy --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.codebuddy/skills/gsd-*/SKILL.md`.
|
||||
As habilidades são instaladas em `~/.codebuddy/skills/msd-*/SKILL.md`.
|
||||
|
||||
---
|
||||
|
||||
@@ -169,15 +169,15 @@ As habilidades são instaladas em `~/.codebuddy/skills/gsd-*/SKILL.md`.
|
||||
O Qwen Code usa o mesmo padrão de habilidades abertas do Claude Code 2.1.88+.
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --qwen --global
|
||||
npx @golem15/msd-core@latest --qwen --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.qwen/skills/gsd-*/SKILL.md`.
|
||||
As habilidades são instaladas em `~/.qwen/skills/msd-*/SKILL.md`.
|
||||
|
||||
**Substituir o diretório de instalação:**
|
||||
|
||||
```bash
|
||||
QWEN_CONFIG_DIR=~/.qwen-alt npx @opengsd/gsd-core@latest --qwen --global
|
||||
QWEN_CONFIG_DIR=~/.qwen-alt npx @golem15/msd-core@latest --qwen --global
|
||||
```
|
||||
|
||||
---
|
||||
@@ -185,17 +185,17 @@ QWEN_CONFIG_DIR=~/.qwen-alt npx @opengsd/gsd-core@latest --qwen --global
|
||||
### Augment Code
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --augment --global
|
||||
npx @golem15/msd-core@latest --augment --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.augment/`. O GSD instala habilidades e agentes. Sem posse de hook ou statusline.
|
||||
As habilidades são instaladas em `~/.augment/`. O MSD instala habilidades e agentes. Sem posse de hook ou statusline.
|
||||
|
||||
---
|
||||
|
||||
### Antigravity
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --antigravity --global
|
||||
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.
|
||||
@@ -203,7 +203,7 @@ O instalador detecta automaticamente o diretório de configuração do Antigravi
|
||||
**Substituir o diretório de instalação:**
|
||||
|
||||
```bash
|
||||
ANTIGRAVITY_CONFIG_DIR=~/.gemini/antigravity-alt npx @opengsd/gsd-core@latest --antigravity --global
|
||||
ANTIGRAVITY_CONFIG_DIR=~/.gemini/antigravity-alt npx @golem15/msd-core@latest --antigravity --global
|
||||
```
|
||||
|
||||
---
|
||||
@@ -211,19 +211,19 @@ ANTIGRAVITY_CONFIG_DIR=~/.gemini/antigravity-alt npx @opengsd/gsd-core@latest --
|
||||
### Trae
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --trae --global
|
||||
npx @golem15/msd-core@latest --trae --global
|
||||
```
|
||||
|
||||
As habilidades são instaladas em `~/.trae/`. O GSD instala habilidades, agentes e referências de regras.
|
||||
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 GSD uma vez para a sua conta de usuário. Para limitar uma instalação a um único projeto, substitua `--global` por `--local`:
|
||||
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`:
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --claude --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.
|
||||
@@ -235,10 +235,10 @@ Uma instalação local escreve no diretório `.claude/` na raiz do seu projeto.
|
||||
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:
|
||||
|
||||
```bash
|
||||
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-next npx @opengsd/gsd-core@latest --windsurf --global
|
||||
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-next npx @golem15/msd-core@latest --windsurf --global
|
||||
```
|
||||
|
||||
Selecione o ambiente estável correspondente no prompt do instalador. O GSD 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.
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
@@ -249,11 +249,11 @@ Se você não pode executar `npx` (por exemplo, em uma máquina Windows sem Node
|
||||
**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:
|
||||
|
||||
```bash
|
||||
npx @opengsd/gsd-core@latest --opencode --global
|
||||
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 GSD 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](../USER-GUIDE.md#manual-install--no-nodejs-setup) 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.
|
||||
**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](../USER-GUIDE.md#manual-install--no-nodejs-setup) 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.
|
||||
|
||||
---
|
||||
|
||||
@@ -262,8 +262,8 @@ npx @opengsd/gsd-core@latest --opencode --global
|
||||
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:
|
||||
|
||||
```bash
|
||||
/gsd-new-project # projeto greenfield
|
||||
/gsd-onboard # base de código 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.
|
||||
@@ -273,6 +273,6 @@ Se o comando não for encontrado após o reinício, verifique se o diretório de
|
||||
## Relacionados
|
||||
|
||||
- [Seu primeiro projeto](../tutorials/your-first-project.md)
|
||||
- [Atualizar o GSD Core](update-gsd.md)
|
||||
- [Atualizar o MSD Core](update-msd.md)
|
||||
- [Configuração](../CONFIGURATION.md)
|
||||
- [Índice da documentação](../README.md)
|
||||
|
||||
Reference in New Issue
Block a user