Files
msd-core/docs/pt-BR/CLI-TOOLS.md
Tom Boucher dff176bfd2 chore: rebrand to GSD-redux/get-shit-done-redux
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)
2026-05-22 08:27:07 -04:00

1.8 KiB

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 — 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)

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.