Files
msd-core/docs/pt-BR/ARCHITECTURE.md
Quang Do d4767ac2e0 fix: replace /gsd: slash command format with /gsd- skill format in all user-facing content (#1579)
* fix: replace /gsd: command format with /gsd- skill format in all suggestions

All next-step suggestions shown to users were still using the old colon
format (/gsd:xxx) which cannot be copy-pasted as skills. Migrated all
occurrences across agents/, commands/, get-shit-done/, docs/, README files,
bin/install.js (hardcoded defaults for claude runtime), and
get-shit-done/bin/lib/*.cjs (generate-claude-md templates and error messages).
Updated tests to assert new hyphen format instead of old colon format.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: migrate remaining /gsd: format to /gsd- in hooks, workflows, and sdk

Addresses remaining user-facing occurrences missed in the initial migration:

- hooks/: fix 4 user-facing messages (pause-work, update, fast, quick)
  and 2 comments in gsd-workflow-guard.js
- get-shit-done/workflows/: fix 21 Skill() literal calls that Claude
  executes directly (installer does not transform workflow content)
- sdk/prompt-sanitizer.ts: update regex to strip /gsd- format in addition
  to legacy /gsd: format; update JSDoc comment
- tests/: update autonomous-ui-steps, prompt-sanitizer to assert new format

Note: commands/gsd/*.md frontmatter (name: gsd:xxx) intentionally unchanged
— installer derives skillName from directory path, not the name field.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(plan-phase): preserve --chain flag in auto-advance sync and handle ui-phase gate in chain mode

Bug 1: step 15 sync-flag check only guarded against --auto, causing
_auto_chain_active to be cleared when plan-phase is invoked without
--auto in ARGUMENTS even though a --chain pipeline was active. Added
--chain to the guard condition, matching discuss-phase behaviour.

Bug 2: UI Design Contract gate (step 5.6) always exited the workflow
when UI-SPEC was missing, breaking the discuss --chain pipeline
silently. When _auto_chain_active is true, the gate now auto-invokes
gsd-ui-phase --auto via Skill() and continues to step 6 without
prompting. Manual invocations retain the existing AskUserQuestion flow.

* fix: remove <sub>/clear</sub> pattern and duplicate old-format command in discuss-phase.md

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-04 07:24:31 -04:00

2.1 KiB

Arquitetura do GSD

Visão arquitetural do Get Shit Done (GSD) em Português.
Para detalhes de implementação linha a linha, consulte ARCHITECTURE.md em inglês.


Princípios

  • Orquestração leve no contexto principal
  • Trabalho pesado em subagentes
  • Artefatos persistentes em .planning/
  • Validação contínua por fase
  • Rastreabilidade por commits atômicos

Componentes centrais

  1. Camada de comando
    Recebe entrada do usuário (/gsd-*) e roteia fluxo.

  2. Camada de orquestração
    Coordena pesquisadores, planejadores, executores e verificadores.

  3. Camada de artefatos
    Mantém PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md, planos e sumários.

  4. Camada de execução
    Roda tarefas em ondas, respeitando dependências.

  5. Camada de validação
    Compara entrega contra objetivos, testes e critérios de fase.

Fluxo arquitetural (alto nível)

Entrada (/gsd-comando)
  -> Orquestrador
  -> Subagentes especializados
  -> Artefatos em .planning/
  -> Execução em ondas
  -> Verificação/UAT
  -> Atualização de estado + commits

Estado e persistência

  • STATE.md: memória operacional da jornada
  • ROADMAP.md: visão de progresso por fase
  • SUMMARY.md: histórico de decisões e resultados por tarefa
  • VALIDATION.md (quando aplicável): contrato de feedback automatizado

Paralelismo

  • Planos independentes: mesma onda (execução paralela)
  • Planos dependentes: ondas posteriores (execução sequencial)
  • Conflitos de arquivo: serialização controlada

Segurança

  • validação de caminhos de arquivo
  • detecção de prompt injection
  • hooks de guarda para escrita/edição sensível
  • scanner CI para padrões de risco

Extensibilidade

GSD suporta evolução por:

  • novos comandos
  • novos tipos de agente
  • novos artefatos por fase
  • novos gates de qualidade/segurança

Note

Esta versão foi criada para consulta de arquitetura em Português. A especificação canônica e completa continua no documento em inglês.