Pior que vocês tocaram no ponto central: a ideia toda do projeto é justamente resgatar esse feijão com arroz clássico da engenharia de software (ADRs, requisitos claros e invariantes de negócio). Ninguém aqui tá tentando reinventar a roda da computação.

Tanto que a pasta .ai-context não tem nada de formato proprietário ou mirabolante: são literalmente arquivos Markdown normais (decisions/DEC-001.md, requirements.md, glossary.md) que qualquer desenvolvedor humano lê e edita direto no VS Code.

A única razão de ter construído a CLI foi eliminar o trabalho braçal e a fricção no fluxo diário:

• No início do chat: em vez de ficar copiando e colando regras na mão toda vez (ou jogar a pasta docs/ inteira no prompt e queimar 20k tokens à toa), a CLI empacota só o que está ativo em ~400 tokens em 1 segundo.
• No final do chat: em vez de você ter que parar no meio do fluxo para criar o arquivo da ADR, numerar e formatar o markdown na mão, a CLI recebe a proposta estruturada da IA e atualiza os arquivos locais de forma atômica no Git.

Essa prática que o @batataQuente comentou de manter um resumo sequencial do que foi feito e os motivos é exatamente o caminho certo. O PactX é só o script/ferramenta que automatiza esse processo repetitivo pra gente focar em programar em vez de ficar organizando markdown manualmente a cada troca de sessão.

Valeu demais pelo contraponto, vocês resumiram a essência da coisa!