a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
76 lines
4.1 KiB
Markdown
76 lines
4.1 KiB
Markdown
# Modo Discuss: Suposições vs Entrevista
|
||
|
||
A fase de discuss do MSD 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 msd-tools.cjs config-set workflow.discuss_mode assumptions
|
||
|
||
# Voltar ao modo de entrevista
|
||
node msd-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 `/msd-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 MSD Core.
|