Pular para o conteúdo principal

Status: Approved · v2 · SPEC-PHILOSOPHY-001

Filosofia do repositório

O código é uma implementação das specs. As specs registram o entendimento vigente do produto. A evolução ocorre por ciclos curtos: decisão, spec, contrato, mock, execução, teste, revisão e aprendizado.

O que isso evita​

  • regras escondidas em componentes;
  • contratos duplicados;
  • telas que dependem de fixtures;
  • decisões arquiteturais por preferência pessoal;
  • mudanças de escopo silenciosas;
  • documentação que apenas descreve o código depois do fato.

O que isso exige​

  • disciplina para atualizar a fonte da verdade;
  • separação explícita entre MVP e pós-MVP;
  • revisão orientada por risco e não por gosto;
  • rastreabilidade entre spec, IS, EP e implementação.