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
2026-10-06 01:47:40 +02:00
parent fe069b2a56
commit a9a7a328e6
2763 changed files with 78465 additions and 78434 deletions

View File

@@ -2,7 +2,7 @@
**Objetivo:** Recuperar quando uma execução de fase falha, trava ou produz trabalho incompleto — e retomar de forma limpa sem perder o progresso ou repetir o trabalho que já foi concluído com sucesso.
**Pré-requisitos:** Você executou `/gsd-execute-phase N` e a execução parou antes de gravar `VERIFICATION.md`, ou você vê saída inesperada, arquivos ausentes ou um indicador de progresso travado.
**Pré-requisitos:** Você executou `/msd-execute-phase N` e a execução parou antes de gravar `VERIFICATION.md`, ou você vê saída inesperada, arquivos ausentes ou um indicador de progresso travado.
---
@@ -12,15 +12,15 @@ Antes de tomar qualquer ação de recuperação, determine o que realmente acont
### Se você ver "Spawning…" sem saída após 1–5 minutos
Isso é normal, não é um travamento. Os subagentes GSD são executados em uma janela de contexto isolada. A nota de atividade na linha de spawn confirma isso. Não interrompa a sessão.
Isso é normal, não é um travamento. Os subagentes MSD são executados em uma janela de contexto isolada. A nota de atividade na linha de spawn confirma isso. Não interrompa a sessão.
Se já se passaram mais de 10 minutos sem resultado, verifique a barra lateral do Claude Code. Se a tarefa do agente aparecer como concluída mas nenhuma saída tiver aparecido, o resultado pode ter sido perdido em uma troca de contexto — execute novamente o mesmo comando:
```bash
/gsd-execute-phase 1
/msd-execute-phase 1
```
O GSD verifica a existência de arquivos `SUMMARY.md` antes de despachar os executores. Planos que já possuem um são ignorados automaticamente.
O MSD verifica a existência de arquivos `SUMMARY.md` antes de despachar os executores. Planos que já possuem um são ignorados automaticamente.
### Se a execução parou no meio de uma onda com uma mensagem de erro
@@ -34,7 +34,7 @@ Planos que commitaram seu trabalho terão uma entrada como `feat(01-02): …`. P
### Se o executor commitou o código mas não gravou SUMMARY.md
O GSD detecta isso na próxima execução e apresenta uma porta de retomada segura com três opções:
O MSD detecta isso na próxima execução e apresenta uma porta de retomada segura com três opções:
- **Fechar manualmente** — inspecione os commits você mesmo, escreva `SUMMARY.md` e execute novamente.
- **Executar novamente do zero** — reverta ou substitua os commits parciais antes de despachar um novo executor.
@@ -44,12 +44,12 @@ O GSD detecta isso na próxima execução e apresenta uma porta de retomada segu
## Diagnosticar a causa raiz
### Execute `/gsd-debug --diagnose`
### Execute `/msd-debug --diagnose`
Se a execução produziu saída incorreta, código com stubs ou uma falha de verificação, use o modo somente de diagnóstico para investigar sem aplicar nenhuma correção:
```bash
/gsd-debug --diagnose "Phase 2 executor produced stubs instead of real code"
/msd-debug --diagnose "Phase 2 executor produced stubs instead of real code"
```
`--diagnose` para na causa raiz sem tocar nos seus arquivos. Ele cria um arquivo de sessão em `.planning/debug/<slug>.md` para que você possa retomar a investigação mais tarde, se necessário.
@@ -57,36 +57,36 @@ Se a execução produziu saída incorreta, código com stubs ou uma falha de ver
Para iniciar uma sessão de depuração completa que também aplica uma correção:
```bash
/gsd-debug "Login middleware not handling 401 correctly after phase 3"
/msd-debug "Login middleware not handling 401 correctly after phase 3"
```
O GSD coleta sintomas, executa uma investigação estruturada usando o método científico e propõe uma correção. Se `tdd_mode: true` estiver definido na sua configuração, ele exige um teste com falha antes de aplicar qualquer correção.
O MSD coleta sintomas, executa uma investigação estruturada usando o método científico e propõe uma correção. Se `tdd_mode: true` estiver definido na sua configuração, ele exige um teste com falha antes de aplicar qualquer correção.
### Verificar sessões de depuração ativas
```bash
/gsd-debug list
/msd-debug list
```
Mostra todas as sessões abertas com sua hipótese atual e próxima ação. Para retomar uma sessão específica:
```bash
/gsd-debug continue <slug>
/msd-debug continue <slug>
```
---
## Executar uma análise post-mortem com `/gsd-forensics`
## Executar uma análise post-mortem com `/msd-forensics`
Se a causa não estiver clara a partir da saída de erro — por exemplo, planos referenciam arquivos inexistentes, a execução produziu resultados inesperados ou o estado parece corrompido — execute uma investigação forense:
```bash
/gsd-forensics "Phase 3 execution stalled after wave 1"
/msd-forensics "Phase 3 execution stalled after wave 1"
```
O GSD analisa o histórico do git, a completude dos artefatos em `.planning/`, a consistência de STATE.md, o trabalho não commitado e as worktrees órfãs. Ele grava um relatório estruturado em `.planning/forensics/report-<timestamp>.md` e apresenta as etapas de remediação recomendadas.
O MSD analisa o histórico do git, a completude dos artefatos em `.planning/`, a consistência de STATE.md, o trabalho não commitado e as worktrees órfãs. Ele grava um relatório estruturado em `.planning/forensics/report-<timestamp>.md` e apresenta as etapas de remediação recomendadas.
`/gsd-forensics` é somente leitura — ele nunca modifica os arquivos do seu projeto.
`/msd-forensics` é somente leitura — ele nunca modifica os arquivos do seu projeto.
**O que ele detecta:**
@@ -103,46 +103,46 @@ O GSD analisa o histórico do git, a completude dos artefatos em `.planning/`, a
Assim que o problema subjacente for resolvido, execute novamente o comando de execução:
```bash
/gsd-execute-phase 1
/msd-execute-phase 1
```
O GSD ignora planos cujo `SUMMARY.md` já existe e despacha executores apenas para os planos restantes.
O MSD ignora planos cujo `SUMMARY.md` já existe e despacha executores apenas para os planos restantes.
Se precisar executar novamente apenas uma onda específica:
```bash
/gsd-execute-phase 1 --wave 2
/msd-execute-phase 1 --wave 2
```
---
## Reverter com `/gsd-undo`
## Reverter com `/msd-undo`
Se a execução produziu código que você deseja descartar completamente, reverta usando o manifesto do plano em vez do `git revert` manual:
### Reverter um único plano
```bash
/gsd-undo --plan 03-02
/msd-undo --plan 03-02
```
Reverte todos os commits do plano `02` da fase `3`. O GSD exibe uma porta de confirmação antes de gravar qualquer alteração.
Reverte todos os commits do plano `02` da fase `3`. O MSD exibe uma porta de confirmação antes de gravar qualquer alteração.
### Reverter uma fase inteira
```bash
/gsd-undo --phase 03
/msd-undo --phase 03
```
Reverte todos os commits da fase `3`. O GSD verifica se alguma fase subsequente depende desta fase e avisa você antes de prosseguir.
Reverte todos os commits da fase `3`. O MSD verifica se alguma fase subsequente depende desta fase e avisa você antes de prosseguir.
### Selecionar interativamente a partir de commits recentes
```bash
/gsd-undo --last 5
/msd-undo --last 5
```
Mostra os cinco commits GSD mais recentes e permite que você selecione quais reverter.
Mostra os cinco commits MSD mais recentes e permite que você selecione quais reverter.
---
@@ -151,7 +151,7 @@ Mostra os cinco commits GSD mais recentes e permite que você selecione quais re
Se você retornou ao projeto após uma reinicialização de contexto ou uma nova sessão:
```bash
/gsd-resume-work
/msd-resume-work
```
Restaura o contexto completo da sua sessão a partir do último handoff, incluindo a fase atual, bloqueadores e onde a execução parou.
@@ -159,7 +159,7 @@ Restaura o contexto completo da sua sessão a partir do último handoff, incluin
Como alternativa, para ver sua posição atual e avançar automaticamente para o próximo passo correto:
```bash
/gsd-progress --next
/msd-progress --next
```
---