Pitch: Criei o pactx: Uma ferramenta Open Source para resolver a amnésia e perda de contexto de IAs em projetos longos
Fala pessoal!
Trabalhando no desenvolvimento de um projeto educacional de xadrez (o CheckMind Escolar) usando ChatGPT, Claude e Gemini, comecei a bater repetidamente no mesmo gargalo: a perda de contexto e a deriva das IAs em sessões longas.
O ritual de sempre pedir "Resuma o que fizemos até aqui" é falho, porque pedir para uma IA com amnésia lembrar do que esqueceu gera alucinações e perda de decisões arquiteturais.
A partir dessa dor, desenhei um protocolo e construí o pactx (@trsthales/pactx), um motor de continuidade de contexto em loop fechado (Closed-Loop) em TypeScript.
A Tese Central
"LLMs são motores de processamento sem estado (stateless compute). O repositório é estado persistente."
Como funciona:
- Egress (
npx @trsthales/pactx): Inspeciona a branch do Git, commits recentes e a pasta canônica.ai-context/(ADRs ativas, tarefas, regras e glossário) e gera um Context Pack compacto em Markdown no Clipboard. - Ingress (
npx @trsthales/pactx update): No final da sessão de chat, a IA emite um bloco estruturadopactx-update. Você roda o comando no terminal e o pactx valida o schema, impede vulnerabilidades de segurança (como Path Traversal e injeção de Markdown) e persiste as decisões de forma atômica no repositório.
A ferramenta está 100% aberta, testada e publicada no NPM:
Gostaria muito do feedback de vocês sobre a arquitetura e o modelo de estado!