OpenSpec no Vault

O que e isso?

Cada pasta em openspec/changes/ e uma change -- uma feature, fix ou
refatoracao em andamento. Os agentes criam e editam esses artefatos durante
o trabalho.

Estrutura de uma change

openspec/changes/<nome>/
  proposal.md    <- por que e o que (leia primeiro)
  specs/*.md     <- requisitos: ADDED / MODIFIED / REMOVED
  design.md      <- como (arquitetura, schema, decisoes tecnicas)
  tasks.md       <- checklist de implementacao -> issues no Linear

Sem pasta intermediaria de projeto. Nome da change deve ser descritivo o suficiente.

Fluxo

proposal -> specs -> design -> tasks -> implement -> archive

Agentes nao pulam fases. Se voce ver tasks.md sem proposal.md, o protocolo nao foi seguido.

Por que fica no vault e nao nos repos?

Agentes rodam em containers Docker efemeros. O vault e volume persistente.
openspec/changes/ dentro do container e um symlink para brain/openspec/changes/ no vault.
O que o agente escreve, persiste automaticamente.

Como acompanhar

Sidebar do vault: openspec > changes > <nome-da-change>
Cada artefato e um markdown navegavel. tasks.md mostra progresso com [ ] / [x].

Changes arquivadas

Concluidas vao para openspec/changes/archive/. Historico preservado, nunca deletado.