3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
121 lines
5.7 KiB
Markdown
121 lines
5.7 KiB
Markdown
# Como atualizar o GSD Core
|
|
|
|
Atualize uma instalação existente do GSD Core para a versão mais recente, visualize o changelog antes de confirmar e recupere personalizações locais que a atualização sobrescreveria.
|
|
|
|
**O que você precisa:** O mesmo ambiente de execução para o qual o GSD está instalado. O comando de atualização re-executa o instalador internamente, portanto requer Node.js e npx disponíveis (mesmos requisitos da instalação original).
|
|
|
|
---
|
|
|
|
## O caminho padrão de atualização
|
|
|
|
De dentro do seu ambiente de execução de IA, execute:
|
|
|
|
```bash
|
|
/gsd-update
|
|
```
|
|
|
|
O GSD irá:
|
|
|
|
1. Detectar a versão instalada e o escopo da instalação (global ou local).
|
|
2. Verificar no npm a versão mais recente do `@opengsd/gsd-core`.
|
|
3. Buscar o changelog e exibir o que mudou entre sua versão instalada e a mais recente.
|
|
4. Solicitar confirmação antes de alterar qualquer coisa.
|
|
5. Fazer backup de quaisquer arquivos adicionados pelo usuário encontrados dentro de diretórios gerenciados pelo GSD para `gsd-user-files-backup/`.
|
|
6. Executar o instalador (`npx @opengsd/gsd-core@latest --<runtime> --<scope>`).
|
|
7. Limpar o cache de verificação de atualização para que o indicador na barra de status seja redefinido.
|
|
8. Informar se arquivos GSD modificados localmente foram copiados para `gsd-local-patches/`.
|
|
|
|
Reinicie seu ambiente de execução após a atualização para carregar os novos comandos e agentes.
|
|
|
|
---
|
|
|
|
## Flags
|
|
|
|
| Flag | O que faz |
|
|
|------|-----------|
|
|
| `--sync` | Após atualizar, sincroniza habilidades do registro GSD |
|
|
| `--reapply` | Após atualizar, mescla arquivos GSD modificados localmente de volta a partir de `gsd-local-patches/` |
|
|
|
|
```bash
|
|
/gsd-update --sync # Update and sync skills
|
|
/gsd-update --reapply # Update and reapply local patches
|
|
```
|
|
|
|
---
|
|
|
|
## Revisando o changelog antes de atualizar
|
|
|
|
`/gsd-update` sempre exibe o diff do changelog entre sua versão instalada e a mais recente *antes* de solicitar confirmação. Não é necessário acessar o GitHub separadamente. A saída tem a seguinte aparência:
|
|
|
|
```text
|
|
## GSD Update Available
|
|
|
|
Installed: 1.39.0
|
|
Latest: 1.41.0
|
|
|
|
### What's New
|
|
────────────────────────────────────────────────────────────
|
|
[changelog entries for 1.40.0 and 1.41.0]
|
|
────────────────────────────────────────────────────────────
|
|
|
|
Proceed with update? [Yes, update now / No, cancel]
|
|
```
|
|
|
|
Se o changelog não puder ser obtido (sem acesso à rede, falha no npm), a atualização ainda prossegue após a confirmação — ela não é bloqueada pela disponibilidade do changelog.
|
|
|
|
---
|
|
|
|
## Recuperando personalizações locais
|
|
|
|
### Arquivos que você adicionou dentro de diretórios gerenciados pelo GSD
|
|
|
|
Se você colocou arquivos personalizados dentro de diretórios que o GSD gerencia (por exemplo, agentes personalizados com o prefixo `gsd-` ou arquivos extras em `commands/gsd/`), o instalador os detectará e os copiará para `gsd-user-files-backup/` antes de limpar esses diretórios. Após a atualização, restaure-os manualmente a partir desse local de backup.
|
|
|
|
Arquivos colocados fora de diretórios gerenciados pelo GSD — agentes personalizados sem o prefixo `gsd-`, comandos personalizados fora de `commands/gsd/`, seus arquivos `CLAUDE.md` e hooks personalizados — nunca são tocados pelo instalador.
|
|
|
|
### Arquivos GSD que você modificou diretamente
|
|
|
|
Se você editou um arquivo instalado pelo GSD (por exemplo, ajustando o prompt de sistema de um agente), o instalador detecta a modificação por meio de uma comparação de hash com seu manifesto, faz backup do arquivo em `gsd-local-patches/` e, em seguida, o substitui pela nova versão. Após a atualização:
|
|
|
|
```bash
|
|
/gsd-update --reapply
|
|
```
|
|
|
|
Esse comando mescla suas modificações de `gsd-local-patches/` de volta aos arquivos recém-instalados.
|
|
|
|
Se você pulou o `--reapply` após uma atualização anterior e deseja aplicar os patches agora:
|
|
|
|
```bash
|
|
/gsd-update --reapply
|
|
```
|
|
|
|
É seguro executar `--reapply` de forma independente sem acionar um novo download — se você já estiver na versão mais recente, o GSD ignora a etapa de instalação e vai direto para a reaplicação dos patches.
|
|
|
|
---
|
|
|
|
## Quando o npm está indisponível
|
|
|
|
Se `npx @opengsd/gsd-core@latest` falhar devido a uma falha no npm, restrições de rede ou porque você está trabalhando a partir do repositório de código-fonte, use o procedimento de atualização manual em [docs/manual-update.md](../../manual-update.md). Esse documento aborda como fazer pull do commit mais recente, compilar o dist dos hooks e executar `node bin/install.js` diretamente.
|
|
|
|
---
|
|
|
|
## Se você já está na versão mais recente
|
|
|
|
`/gsd-update` encerra imediatamente com uma mensagem de confirmação — sem download, sem instalação, sem necessidade de reinicialização.
|
|
|
|
---
|
|
|
|
## Migrações do instalador
|
|
|
|
Cada versão do GSD pode incluir migrações do instalador que renomeiam, movem ou removem arquivos gerenciados. A camada de migração é executada automaticamente antes que o novo payload do pacote seja gravado. Migrações que afetariam arquivos que você modificou solicitam confirmação em vez de agir silenciosamente. Para o design completo e o registro do contrato de configuração de tempo de execução, consulte [docs/installer-migrations.md](../../installer-migrations.md).
|
|
|
|
---
|
|
|
|
## Relacionados
|
|
|
|
- [Instalar no seu ambiente de execução](install-on-your-runtime.md)
|
|
- [Referência de comandos](../COMMANDS.md)
|
|
- [Atualização manual](../../manual-update.md)
|
|
- [Migrações do instalador](../../installer-migrations.md)
|
|
- [Índice da documentação](../README.md)
|