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.
159 lines
5.5 KiB
Markdown
159 lines
5.5 KiB
Markdown
# Como discutir uma fase
|
|
|
|
**Objetivo:** Reunir as decisões de implementação que uma fase precisa antes do planejamento começar — para que o pesquisador e o planejador possam agir sem precisar consultar você novamente.
|
|
|
|
**Pré-requisitos:** `.planning/ROADMAP.md` deve existir. Caso contrário, execute `/msd-new-project` primeiro.
|
|
|
|
---
|
|
|
|
## Escolha seu modo de discussão
|
|
|
|
MSD Core oferece dois modos. Escolha com base em quão bem compreendida é a base de código.
|
|
|
|
**Se você quiser expressar suas preferências de implementação antecipadamente** (modo de entrevista, padrão):
|
|
|
|
```bash
|
|
/msd-discuss-phase 2
|
|
```
|
|
|
|
Claude identifica áreas cinzentas no escopo da fase, permite que você selecione quais discutir e trabalha com aproximadamente quatro perguntas por área.
|
|
|
|
**Se a base de código já tem padrões claros e você acha a maioria das perguntas óbvias** (modo de suposições):
|
|
|
|
```bash
|
|
node msd-tools.cjs config-set workflow.discuss_mode assumptions
|
|
/msd-discuss-phase 2
|
|
```
|
|
|
|
Claude lê de 5 a 15 arquivos relevantes da base de código por meio de um subagente, formula suposições com evidências e níveis de confiança, e as apresenta para confirmação ou correção. Normalmente 2 a 4 interações em vez de 15 a 20.
|
|
|
|
Para voltar ao modo anterior:
|
|
|
|
```bash
|
|
node msd-tools.cjs config-set workflow.discuss_mode discuss
|
|
```
|
|
|
|
Veja [Modos de discussão explicados](../workflow-discuss-mode.md) para uma comparação completa, incluindo quando cada modo tende a economizar tempo.
|
|
|
|
---
|
|
|
|
## Discutir todas as áreas cinzentas sem a etapa de seleção
|
|
|
|
Por padrão, Claude apresenta as áreas cinzentas e pergunta quais você deseja cobrir. Se você quiser trabalhar em todas elas sem esse prompt de seleção:
|
|
|
|
```bash
|
|
/msd-discuss-phase 2 --all
|
|
```
|
|
|
|
---
|
|
|
|
## Acelerar uma fase direta
|
|
|
|
**Se a fase é bem compreendida e você quer que Claude escolha os padrões recomendados sem fazer perguntas:**
|
|
|
|
```bash
|
|
/msd-discuss-phase 3 --auto
|
|
```
|
|
|
|
Claude seleciona a resposta recomendada para cada pergunta e registra as escolhas. Use isso para fases em que as decisões são de baixo impacto ou já estão implícitas pelas fases anteriores.
|
|
|
|
**Se você tem restrições de sessão remota (sem menus TUI):**
|
|
|
|
```bash
|
|
/msd-discuss-phase 2 --text
|
|
```
|
|
|
|
Todos os prompts são renderizados como listas numeradas em texto simples em vez de seletores interativos.
|
|
|
|
---
|
|
|
|
## Responder perguntas em grupos
|
|
|
|
Se você preferir responder várias perguntas de uma vez em vez de uma por uma:
|
|
|
|
```bash
|
|
/msd-discuss-phase 2 --batch
|
|
```
|
|
|
|
Claude agrupa de 2 a 5 perguntas por turno.
|
|
|
|
---
|
|
|
|
## Adicionar análise de trade-offs a cada pergunta
|
|
|
|
Se você quiser uma tabela comparativa das opções antes de se comprometer:
|
|
|
|
```bash
|
|
/msd-discuss-phase 2 --analyze
|
|
```
|
|
|
|
---
|
|
|
|
## Responder em massa a partir de um arquivo preparado
|
|
|
|
Se você tem um arquivo de respostas preparado e quer enviar todas as decisões em uma única passagem:
|
|
|
|
```bash
|
|
/msd-discuss-phase 1 --power
|
|
```
|
|
|
|
---
|
|
|
|
## Visualizar as suposições de Claude antes de discutir
|
|
|
|
**Se você quiser ver o que Claude assumiria e faria antes de qualquer sessão interativa** — útil para validar o alinhamento antes de investir tempo em discussão:
|
|
|
|
```bash
|
|
/msd-discuss-phase 3 --assumptions
|
|
```
|
|
|
|
Claude exibe suas suposições (com evidências da base de código e níveis de confiança) e encerra. Nenhum CONTEXT.md é escrito. Revise a saída e, se algo precisar de correção, execute uma sessão normal de discussão ou em modo de suposições.
|
|
|
|
---
|
|
|
|
## O que o CONTEXT.md contém
|
|
|
|
Tanto o modo de discussão quanto o modo de suposições produzem o mesmo `{phase}-CONTEXT.md` no diretório da fase. Os agentes downstream (pesquisador, planejador, verificador de plano) leem esse arquivo de forma idêntica independentemente do modo que o produziu. Ele contém seis seções:
|
|
|
|
| Seção | Finalidade |
|
|
|---|---|
|
|
| `<domain>` | Delimitação da fase — o que esta fase entrega |
|
|
| `<decisions>` | Decisões de implementação confirmadas durante a sessão |
|
|
| `<canonical_refs>` | Especificações, ADRs e documentos que os agentes downstream devem ler |
|
|
| `<code_context>` | Recursos reutilizáveis, padrões e pontos de integração |
|
|
| `<specifics>` | Referências e preferências do usuário |
|
|
| `<deferred>` | Ideias anotadas para fases futuras |
|
|
|
|
A seção `<canonical_refs>` é obrigatória. Se você referenciar um documento, especificação ou ADR durante a discussão, Claude o adiciona imediatamente e o lê para embasar as perguntas subsequentes.
|
|
|
|
Veja [Esquema do CONTEXT.md](../reference/context-md.md) para a referência completa dos campos.
|
|
|
|
---
|
|
|
|
## Como as decisões alimentam o planejamento
|
|
|
|
Quando você executar `/msd-plan-phase` em seguida, o planejador lê CONTEXT.md para saber quais decisões estão confirmadas. Ele não vai refazer perguntas já respondidas aqui. O pesquisador o lê primeiro para saber o que investigar.
|
|
|
|
**Se o CONTEXT.md estiver ausente quando você executar `/msd-plan-phase`**, você terá a opção de continuar sem contexto (os planos usam apenas pesquisa e requisitos, sem suas preferências de design) ou executar `/msd-discuss-phase` primeiro.
|
|
|
|
---
|
|
|
|
## Se você tiver um PRD ou documento de critérios de aceitação
|
|
|
|
Pule a fase de discussão completamente e vá direto para o planejamento:
|
|
|
|
```bash
|
|
/msd-plan-phase 1 --prd path/to/prd.md
|
|
```
|
|
|
|
O planejador sintetiza o CONTEXT.md a partir do PRD e trata todos os requisitos como decisões confirmadas.
|
|
|
|
---
|
|
|
|
## Relacionados
|
|
|
|
- [Planejar uma fase](plan-a-phase.md)
|
|
- [Modos de discussão](../workflow-discuss-mode.md)
|
|
- [Esquema do CONTEXT.md](../reference/context-md.md)
|
|
- [Índice de documentação](../README.md)
|