DEC-008 — Adoção dos PRDs por incremento como fonte de construção

status: proposta — aguardando aceite. Enquanto não for aceita, a taxonomia do vault continua sendo a da DEC-007 Adoção do Sales Intelligence v0.3.

Os 8 conflitos e os 15 requisitos órfãos já têm decisão

A Reconciliação Final v0.3 × PRDs (2026-09-20) fechou os 9 pedidos de mudança abertos por esta decisão — ver ponto 5 e 6 abaixo — e deu origem à Orquestro — MVP Freeze Candidate Final v2. Isso resolve a ressalva dos pontos 5 e 6, mas não substitui a aceitação desta DEC-008: a fonte de construção continua sendo definida por esta decisão, ainda em proposta.

Contexto

Em 18/09/2026 chegou um pacote com sete PRDs por incremento, o documento-mãe Orquestro — MVP Freeze Candidate Final e as fontes que os originaram. São 1.447 requisitos, 582 testes e 29 testes ponta a ponta, com objetos de dados e critérios de aceite — muito mais detalhe do que o vault tem hoje.

O pacote é organizado por incrementos de construção (1 a 7) e 13 gates numerados. O vault segue a taxonomia do v0.3: etapas E0.CORE, E0.SALES e E1 a E6, com gates por nome. As duas convivendo confundem pessoas e agentes.

A comparação completa está em Análise PRDs × v0.3 e o mapeamento requisito a requisito em De-Para REQ × Incrementos.

Opções consideradas

  1. Manter o v0.3 como fonte e tratar os PRDs como anexo técnico. Preserva os conceitos do v0.3, mas deixa 1.447 requisitos fora do fluxo de trabalho.
  2. Adotar os PRDs como fonte e reclassificar o vault. Ganha detalhe, testes e rastreabilidade, mas perde conceitos do v0.3 e exige a terceira mudança de taxonomia em um mês.
  3. Fundir os dois em uma taxonomia nova. É a mais cara e a que mais atrasa a construção.

Decisão

Opção 2, com ressalvas:

  1. Os PRDs por incremento passam a ser a fonte de construção. O Orquestro — MVP Freeze Candidate Final é o documento-mãe.
  2. A propriedade etapa dos requisitos passa a registrar o incremento (I1 a I7 ou transversal) e a propriedade gate volta a ser número de 1 a 13.
  3. As sprints do Plano de Desenvolvimento passam a ser os incrementos.
  4. As notas Etapas v0.3 e Orquestro — Visão Geral v0.3 viram histórico, sem serem apagadas.
  5. Os 8 conflitos de regra listados na análise não são resolvidos por esta decisão. Cada um vira um pedido de mudança e é decidido separadamente antes da implementação do incremento correspondente.
  6. Os 8 requisitos sem correspondente (REQ-092, 093, 094, 095, 100, 102, 106 e 108) ficam suspensos até essa decisão caso a caso.

Consequências

  • AGENTS.md, o prompt de entrevista e o kit das sócias precisam de nova versão.
  • Os 113 requisitos mudam de propriedade mais uma vez; o histórico de cada um preserva as versões anteriores.
  • Os testes e critérios dos PRDs passam a valer como definição de pronto de cada incremento.
  • Fica pendente o documento Orquestro-TRV — Revisão Transversal Final do MVP, citado como herdado pelos sete PRDs e não localizado. Sem ele, as regras transversais precisam ser reconstruídas a partir do Freeze e dos requisitos REQ-001 a REQ-015.

Evidências / learnings relacionados

Histórico

DataO que mudouQuemReferência
2026-09-20Os 8 conflitos e os 15 requisitos órfãos (pontos 5 e 6) resolvidos pela reconciliação; as 9 PMs aprovadasJulioReconciliação Final v0.3 × PRDs
2026-09-18Proposta registrada a partir do pacote de PRDsJulioRegistro de Mudanças