dff176bfd2
Mirror of code, issues, and PRs from the upstream gsd-build/get-shit-done, which appears compromised or abandoned (maintainer unreachable since 2026-04-01; $GSD token linked to rug-pull). - Adds rebrand notice block at top of English README - Removes $GSD token badge and @gsd_foundation X badge (keeps Discord) - Renames npm packages: get-shit-done-cc -> get-shit-done-redux, @gsd-build/sdk -> @gsd-redux/sdk - Updates all repo URLs across docs, workflows, package.json, bin/ - Updates ci@gsd-build -> ci@gsd-redux in workflow git identities - Leaves CHANGELOG and .changeset/* alone (historical, time-stamped)
73 lines
1.8 KiB
Markdown
73 lines
1.8 KiB
Markdown
# Referência de Ferramentas CLI
|
|
|
|
Resumo em Português das ferramentas CLI do GSD.
|
|
Para API completa (assinaturas, argumentos e comportamento detalhado), consulte [CLI-TOOLS.md em inglês](../CLI-TOOLS.md) — inclui a secção **SDK and programmatic access** (`gsd-sdk query`, `@gsd-redux/sdk`).
|
|
|
|
---
|
|
|
|
## Objetivo
|
|
|
|
As ferramentas CLI permitem que comandos e agentes do GSD executem ações padronizadas de:
|
|
|
|
- leitura e escrita de artefatos
|
|
- gerenciamento de fases e roadmap
|
|
- execução e validação de planos
|
|
- integração com git e automação
|
|
|
|
## Áreas funcionais
|
|
|
|
### Projeto e estado
|
|
|
|
- inicialização de artefatos (`PROJECT`, `REQUIREMENTS`, `ROADMAP`, `STATE`)
|
|
- atualização de estado por fase
|
|
- controle de milestones
|
|
|
|
### Planejamento
|
|
|
|
- criação de planos atômicos
|
|
- validação pré-execução
|
|
- consolidação de pesquisa
|
|
|
|
### Execução
|
|
|
|
- despacho de tarefas por onda
|
|
- persistência de sumários
|
|
- checkpoints de progresso
|
|
|
|
### Verificação
|
|
|
|
- comparação de saída com objetivos
|
|
- geração de relatórios de validação
|
|
- apoio ao UAT
|
|
|
|
### Utilitários
|
|
|
|
- leitura/escrita segura de arquivos
|
|
- parsing de argumentos
|
|
- normalização de paths
|
|
|
|
## Boas práticas para autores de agentes
|
|
|
|
- Use artefatos existentes como fonte de verdade
|
|
- Evite lógica duplicada entre agentes
|
|
- Registre saídas em arquivos canônicos de fase
|
|
- Garanta que toda tarefa tenha critério claro de done/verify
|
|
|
|
---
|
|
|
|
## Fluxo típico (programático)
|
|
|
|
```text
|
|
Ler contexto do projeto
|
|
-> montar input da etapa
|
|
-> executar ferramenta CLI
|
|
-> persistir artefatos
|
|
-> atualizar estado/roadmap
|
|
-> retornar resumo para o orquestrador
|
|
```
|
|
|
|
---
|
|
|
|
> [!NOTE]
|
|
> Este arquivo é um guia prático em Português para quem integra ou estende workflows. Para contratos estritos e detalhes técnicos completos, use o documento original em inglês.
|