Começar
Aparência

Vale na hora e fica lembrada neste navegador.

Decisões

ORG-0008 — OpenSpec para toda mudança

Contexto

Sem um passo de proposta revisada, o código chega antes do acordo sobre o que fazer, e a especificação, se existe, é escrita depois para descrever o que saiu.

Decisão

  1. Ciclo de toda change: explore (opcional) → propose → revisão do mantenedor → apply → sync → archive. Nenhum código de produto antes da aprovação.
  2. Também são change: atualizar o design system, atualizar a arquitetura, subir a versão maior de uma dependência central e corrigir um bug (uma change pequena: o teste que reproduz e a correção).
  3. Uma change em apply por vez; change grande se divide antes do apply.
  4. A versão do OpenSpec CLI é fixa (eng/tools.versions), e openspec validate --strict roda na CI quebrando o build.

Alternativas consideradas

AlternativaPor que não
Issues e PRs sem especificaçãoPor que não: o comportamento esperado fica espalhado em conversas
Especificação escrita depois do códigoPor que não: descreve o que saiu, não o que se queria

Consequências

  • As specs em openspec/specs/ são a verdade viva do comportamento.
  • Toda change tem rastro: proposta, tarefas, decisões e o arquivo final.

Mais

O detalhe está na documentação da arquitetura.