Será que o problema aí é a IA ou a falta de engenharia básica no dia a dia? 😅
Requisitos, Invariantes e Decisões são documentos canônicos que qualquer projeto sério já deveria manter para humanos, não .ai-context.
Às vezes sinto que estão tentando criar soluções super rebuscadas quando o "feijão com arroz" da engenharia de software já resolveu esse problema a 50 anos!
Concordo, um readme no qual a IA atualiza um resumo sequêncial do que foi feito e porque foi realizado dessa forma, já garantiu o andamento confiável de vários projetos meus, alguns nos quais troquei de modelo e de harness ou revisitei depois de meses para lembrar o que foi feito.
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:
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!
Faz todo sentido o seu questionamento! E no fundo a premissa do projeto parte exatamente desse princípio: a base de tudo continua sendo a boa engenharia tradicional de 50 anos atrás (ADRs, requisitos claros e invariantes de negócio).
Tanto que a pasta .ai-context não tem nada de formato proprietário ou mirabolante: são literalmente arquivos Markdown comuns (decisions/DEC-001.md, requirements.md, glossary.md) que qualquer humano lê, revisa e edita direto no VS Code.
A questão é que programar no dia a dia com IAs trouxe duas fricções práticas novas que a engenharia clássica não precisava resolver antes:
O limite e o custo da janela de contexto: se você jogar a documentação inteira do projeto num chat toda vez que for codar, você queima 20k ou 30k tokens à toa e a IA sofre com perda de atenção no meio do texto. A CLI só existe para inspecionar o repositório e montar um pacote enxuto com apenas o que está ativo (~400 tokens) para a sessão atual.
A fricção de manter a documentação viva: no ritmo acelerado de codar com IA, quase ninguém para a cada meia hora para criar manualmente um novo arquivo de ADR, checar numeração e formatar markdown. O PactX só automatiza a proposta e a escrita atômica no Git para garantir que o time realmente mantenha essas decisões registradas, em vez de deixar a documentação virar arquivo morto que ninguém atualiza.
Ou seja: a ferramenta não tenta inventar uma teoria nova de engenharia, ela só automatiza o trabalho braçal para que o feijão com arroz seja praticado de verdade sem atrito. Valeu pelo contraponto!