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.
4.1 KiB
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.
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 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 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
/msd-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 MSD Core.