Pular para o conteúdo
em estudodocumentação
↑ ↓ navegarEnter abrirbusca no próprio site, sem serviço externo

0001 · Arquivos em tasks/<id>/ como fonte da verdade

  • Status: Aceito (local e retenção detalhados no ADR-0007)
  • Data: 2026-11-14

Contexto

Seção intitulada “Contexto”

Cada tarefa que passa pelo Prumo gera coisas: a tarefa de origem, a especificação, o plano, as decisões dos gates, o consumo de tokens. Precisamos decidir onde esse estado mora de verdade.

O Prumo roda na máquina de quem usa (ADR-0006), quer ser estudado e auditado por qualquer pessoa e não pode depender de serviço pago (ADR-0005).

Decisão

Seção intitulada “Decisão”

O estado de cada tarefa mora em arquivos de texto numa pasta própria, fora do repositório do projeto e sem versionamento (local exato e retenção no ADR-0007):

tasks/<id>/
  tarefa.md      # a tarefa de origem, como foi recebida
  spec.md        # saída da etapa SPEC
  plan.md        # saída da etapa PLAN
  gates.jsonl    # uma linha por decisão de gate (aprovar, pedir ajuste, refazer)
  usage.jsonl    # uma linha por chamada de IA (etapa, modelo, tokens, custo)
  etapas/<n>-<nome>/etapa.json  # rastro de cada etapa (ADR-0007)
  tarefa.json    # agregado das etapas
  entrega.md     # resumo final

Qualquer banco ou índice que vier depois (pra tela, busca ou relatórios) é derivado desses arquivos e pode ser apagado e reconstruído a partir deles.

Alternativas consideradas

Seção intitulada “Alternativas consideradas”
  • Banco de dados como fonte principal: consultas mais fáceis desde o início, mas exige instalar e manter um banco, esconde o histórico de quem estuda e prende o Prumo a um formato que não se lê sem ferramenta.

Consequências

Seção intitulada “Consequências”
  • Dá pra ler, comparar e revisar tudo com ferramentas comuns. Quem estuda vê exatamente o que cada etapa produziu.
  • O C1 não precisa de banco.
  • Escrita concorrente na mesma tarefa precisa de cuidado (uma etapa por vez por tarefa no C1).
  • Mudança no formato dos arquivos é mudança de contrato: exige ADR e migração.
  • Dados sensíveis não podem cair nesses arquivos (ADR-0003).

Fontes

Seção intitulada “Fontes”