Como Elaborar Planos de Implementação (/plan)

Todo avanço estrutural no ecossistema multi-repo exige a formalização prévia de um Plano de Implementação (Definition of Ready - DoR) versionado em .agents/plan/<escopo>/.

Estrutura Mandatória do Plano

O documento deve seguir rigorosamente o padrão com timestamp monotônico (YYYYMMDDHHMMSS_descricao.md) e conter:

  1. Contexto Delimitado & Resumo Executivo: O problema de engenharia a ser resolvido.

  2. Raio de Impacto Restrito (Blast Radius): Escopo permitido (In-Scope) e expressamente proibido (Out-of-Scope).

  3. Matriz de Conformidade com os 5 Pilares: Auditoria formal contra HITL, SecOps, IaC, Validação Empírica e Resiliência.

  4. Mapeamento Cirúrgico de Arquivos: Listagem de arquivos modificados ([MODIFY]), novos ([NEW]) ou deletados ([DELETE]).

  5. Matriz de Verificação & Quality Gates: Comandos exatos de teste com asserções mensuráveis.

  6. Decisões Arquiteturais Consolidadas: Lista numerada de premissas acordadas.