Aplicar uma revisão

O que Aplicar uma revisão faz?

Ajude a pessoa a decidir sobre cada achado e aplicar apenas o que ela aprovar.

Regra fundamental: nunca assuma, infira ou aplique uma alteração sem uma decisão explícita. Se um achado for ambíguo, peça esclarecimentos antes de oferecer opções. Cada achado é decidido separadamente; nunca os agrupe.

Artefatos e status

• Cada item de trabalho reside em docs/specs/<YYYYMMDD>-<tipo>-<nome>/.
• spec.md e plan.md possuem status: draft | approved | obsolete no frontmatter. Apenas uma pessoa define approved.
• Se você alterar um artefato que estava approved, defina-o como draft e informe.

Passo 1: apresentar os achados

1. Identifique o item de trabalho e a revisão (review-spec.md ou review-plan.md). Pergunte se não estiver claro.
2. Liste todos os achados, numerados, começando pelos bloqueantes. Para cada um, mostre:
   • Achado [N]: o que a revisão aponta.
   • Sugestão de correção, se houver.
   • Opções:
     • A) Aplicar a correção como está.
     • B) Aplicar uma correção modificada (a pessoa descreve).
     • C) Descartar, com o motivo.
     • D) Adiar.

Aguarde a pessoa responder todos antes de continuar.

Passo 2: confirmar

Resumo das decisões
────────────────
[N] <título> → aplicar / modificado / descartado / adiado

Pergunte: "Você confirma estas decisões antes de eu aplicá-las?" Não prossiga sem confirmação.

Passo 3: aplicar

1. Aplique apenas as alterações confirmadas (A e B), e apenas nos artefatos revisados. Não toque em mais nada.
2. No arquivo de revisão, abaixo de cada achado, anote a decisão tomada:
   • para descartados, o motivo;
   • para adiados, o que ainda está pendente.
3. Informe a pessoa sobre a situação:
   • Se nenhum achado bloqueante permanecer em aberto, o artefato está pronto para ela marcá-lo como approved, ou para outra passagem de review-spec.
   • Se houver achados bloqueantes adiados, ou descartados que tragam risco, aponte isso.

Passo 4: outras especificações afetadas

Verifique se alguma decisão do passo 2 afeta outras especificações em andamento:

1. Olhe em docs/specs/*/spec.md por aquelas com status: draft.
2. Para cada uma, avalie se alguma decisão introduz conflito, altera uma dependência ou invalida uma suposição.
3. Para cada especificação que possa ser afetada:
   • mostre qual especificação, qual seção e o que precisaria mudar;
   • pergunte: "Esta decisão a afeta? Devo propor uma alteração?". Aguarde um sim ou um não.
4. Se a resposta for sim, redija apenas a alteração mínima (a seção e linhas exatas), mostre o diff e aplique somente após aprovação.

Não melhore, estenda ou reformate qualquer outra coisa nessas especificações. Se em qualquer ponto não estiver claro o que fazer, pare e pergunte.