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>
4.1 KiB
Modo Discuss: Suposições vs Entrevista
A fase de discuss do GSD Core oferece dois modos para coletar o contexto de implementação antes do início do planejamento. Entender quando usar cada um ajuda a passar da fase de perguntas para um CONTEXT.md confirmado com menos idas e vindas.
Para instruções passo a passo sobre como executar cada modo, consulte o Como realizar discuss de uma fase.
Modos
discuss (padrão)
O fluxo original no estilo de entrevista. O Claude identifica áreas cinzentas na fase, apresenta-as para seleção e faz aproximadamente quatro perguntas por área. Adequado para:
- Fases iniciais em que o código-base é novo
- Fases em que o usuário tem opiniões firmes que deseja expressar proativamente
- Usuários que preferem coleta de contexto guiada e conversacional
assumptions
Um fluxo com foco no código-base. O Claude analisa profundamente o código-base por meio de um subagente (lendo de 5 a 15 arquivos relevantes), formula suposições com evidências e as apresenta para confirmação ou correção. Adequado para:
- Código-bases consolidados com padrões bem definidos
- Usuários que consideram as perguntas da entrevista óbvias
- Coleta de contexto mais rápida (~2–4 interações vs ~15–20)
Configuração
# Habilitar o modo assumptions
node gsd-tools.cjs config-set workflow.discuss_mode assumptions
# Voltar ao modo de entrevista
node gsd-tools.cjs config-set workflow.discuss_mode discuss
A configuração é por projeto (armazenada em .planning/config.json). Consulte o esquema do CONTEXT.md para ver a estrutura completa do arquivo produzido por ambos os modos.
Como o Modo Assumptions Funciona
- Inicialização — Igual ao modo discuss (carrega contexto anterior, explora o código-base, verifica pendências)
- Análise aprofundada — O subagente de exploração lê de 5 a 15 arquivos do código-base relacionados à fase
- Apresentação das suposições — Cada suposição inclui:
- O que o Claude faria e por quê (citando caminhos de arquivo)
- O que dá errado se a suposição estiver incorreta
- Nível de confiança (Confident / Likely / Unclear)
- Confirmar ou corrigir — O usuário revisa as suposições e seleciona as que precisam ser alteradas
- Escrever o CONTEXT.md — Formato de saída idêntico ao do modo discuss
Compatibilidade de Flags
| Flag | modo discuss |
modo assumptions |
|---|---|---|
--auto |
Seleciona automaticamente as respostas recomendadas | Ignora a etapa de confirmação e resolve automaticamente itens Unclear |
--batch |
Agrupa perguntas em lotes | N/A (correções já agrupadas) |
--text |
Perguntas em texto puro (sessões remotas) | Perguntas em texto puro (sessões remotas) |
--analyze |
Exibe tabelas de trade-off por pergunta | N/A (suposições já incluem evidências) |
Saída
Ambos os modos produzem um CONTEXT.md idêntico com as mesmas seis seções:
<domain>— Limite da fase<decisions>— Decisões de implementação confirmadas<canonical_refs>— Especificações/documentos que os agentes downstream devem ler<code_context>— Ativos reutilizáveis, padrões, pontos de integração<specifics>— Referências e preferências do usuário<deferred>— Ideias registradas para fases futuras
Os agentes downstream (researcher, planner, checker) consomem esse arquivo de forma idêntica, independentemente do modo que o produziu. Consulte o esquema do CONTEXT.md para a referência completa dos campos.
Relacionados
- Realizar discuss de uma fase — passo a passo para executar
/gsd-discuss-phaseem qualquer modo. - Esquema do CONTEXT.md — referência completa dos campos do arquivo produzido por ambos os modos.
- O ciclo de fases — como o discuss se encaixa no ciclo mais amplo de discuss → plan → execute → verify → ship.
- Índice de documentação — sumário completo da documentação do GSD Core.