Melhores práticas para manter contexto e evitar perda de “estado” com Auto-Compact / transições pro Plan Mode (Claude CLI)

[gregdalzotto]

Olá pessoal!

Estou utilizando AIOS Framework + Claude CLI em um projeto real (fluxo com PM → Architect → Dev → QA → Gates → Review) e tenho enfrentado um padrão recorrente relacionado a Auto-Compact e manutenção de contexto.

Queria entender como vocês lidam com isso de forma estruturada e repetível.

---

📌 Cenário observado

Em ciclos de trabalho mais longos:

• Muitas interações entre squads
• Revisões de stories + geração de gates
• Alterações sucessivas em múltiplos arquivos
• Conversa extensa no terminal

Depois de certo volume de contexto:

• Ocorre Auto-Compact
• A qualidade das decisões parece cair
• Parte do “estado mental” do agente parece se perder
• Em alguns momentos, o fluxo sai do padrão AIOS e entra em algo semelhante a Plan Mode do Claude

Isso acaba gerando:

• decisões menos consistentes
• perda de continuidade
• necessidade de reorientar o agente manualmente

---

🎯 O que estou buscando

Gostaria de aprender quais práticas vocês usam para:

1️⃣ Preservar estado antes do compact

• Vocês usam arquivos como:

  • .aios/gotchas.md
  • decisions.md
  • state.md

• Fazem checkpoints periódicos?

• Existe um “ritual” recomendado?

---

2️⃣ Estruturar melhor handoffs entre squads

Exemplo:

• PM gera story
• QA gera gates
• Dev implementa
• Architect revisa

Existe uma forma ideal de estruturar isso para que o agente não dependa tanto da memória da conversa?

---

3️⃣ Reduzir risco de “escape” para Plan Mode

• Existe algum gatilho comum que provoca isso?
• Excesso de instrução aberta?
• Falta de comando explícito de squad?
• Alguma técnica para manter o fluxo estritamente AIOS?

---

4️⃣ Estratégias operacionais

Vocês seguem algo como:

• “A cada X interações, gerar resumo estruturado”
• “Sempre persistir decisões importantes em arquivo”
• “Nunca confiar no estado implícito da conversa”

Existe algum playbook que funcione bem?

---

🔍 O que seria uma resposta ideal

• Boas práticas repetíveis
• Estrutura mínima de arquivos para manter estado
• Sinais de que o Auto-Compact vai prejudicar o fluxo
• Estratégias preventivas (não só corretivas)

Obrigado desde já 🙏

[guscherer]

Acho que usando os agentes quem geram as especificações em EPICS e stories tem me dado bons resultados de continuidade nos projetos mesmo depois de um contexto muito longo e retomada de ações em dias posteriores. Pra mim tem funcionado, deve ter melhores práticas alternativas visto que acabo gastando mais tokens do meu plano nessas etapas do que na implementação em si.