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>
76 lines
4.1 KiB
Markdown
76 lines
4.1 KiB
Markdown
# 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](how-to/discuss-a-phase.md).
|
||
|
||
## 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
|
||
|
||
```bash
|
||
# 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](reference/context-md.md) para ver a estrutura completa do arquivo produzido por ambos os modos.
|
||
|
||
## Como o Modo Assumptions Funciona
|
||
|
||
1. **Inicialização** — Igual ao modo discuss (carrega contexto anterior, explora o código-base, verifica pendências)
|
||
2. **Análise aprofundada** — O subagente de exploração lê de 5 a 15 arquivos do código-base relacionados à fase
|
||
3. **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)
|
||
4. **Confirmar ou corrigir** — O usuário revisa as suposições e seleciona as que precisam ser alteradas
|
||
5. **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](reference/context-md.md) para a referência completa dos campos.
|
||
|
||
## Relacionados
|
||
|
||
- [Realizar discuss de uma fase](how-to/discuss-a-phase.md) — passo a passo para executar `/gsd-discuss-phase` em qualquer modo.
|
||
- [Esquema do CONTEXT.md](reference/context-md.md) — referência completa dos campos do arquivo produzido por ambos os modos.
|
||
- [O ciclo de fases](explanation/the-phase-loop.md) — como o discuss se encaixa no ciclo mais amplo de discuss → plan → execute → verify → ship.
|
||
- [Índice de documentação](README.md) — sumário completo da documentação do GSD Core.
|