d4767ac2e0
* 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>
78 lines
2.1 KiB
Markdown
78 lines
2.1 KiB
Markdown
# 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](../ARCHITECTURE.md).
|
|
|
|
---
|
|
|
|
## 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)
|
|
|
|
```text
|
|
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.
|