A estratégia técnica por trás do GSD: como os artefatos de planejamento funcionam como memória persistente, e como o monitor de contexto previne degradação em sessões longas.
O GSD resolve context rot não tentando "lembrar mais" — ele estrutura o conhecimento em arquivos que qualquer nova sessão pode ler para reconstruir o contexto completo.
| Arquivo | Papel na Engenharia de Contexto |
|---|---|
| PROJECT.md | Visão macro: objetivo, stack, decisões irreversíveis. Lido sempre no início. |
| research/ | Conhecimento de ecossistema pesquisado uma vez, reutilizado em todas as fases. |
| REQUIREMENTS.md | Escopo v1/v2 com IDs: impede o planer de descartar requisitos silenciosamente. |
| ROADMAP.md | Direção e progresso: onde estamos, o que vem a seguir. |
| STATE.md | Memória entre sessões: fase atual, últimas decisões, contexto crítico. |
| {fase}-PLAN.md | Tarefa atômica com XML: cada executor recebe exatamente o que precisa. |
| {fase}-SUMMARY.md | O que mudou: desvios do plano, decisões tomadas, riscos identificados. |
| todos/ | Ideias para depois: capturadas sem perder o fio do trabalho atual. |
| seeds/ | Ideias futuras com condição de surgimento — reaparecem no momento certo. |
Em vez de tentar manter todo o contexto do projeto na janela de tokens, o GSD externaliza o conhecimento em arquivos estruturados. A cada sessão, os agentes lêem apenas o que precisam. O executor de um plano específico lê PROJECT.md + PLAN.md — 2 arquivos, não a conversa inteira.
O GSD inclui um hook de monitoramento de janela de contexto que avisa quando você está se aproximando do limite, antes que context rot comece a degradar a qualidade.
EXEMPLO DE AVISO
⚠️ Context: 78% used (156K/200K tokens)
Recommend: /gsd:pause-work to save state
Or: /gsd:next will start fresh session/gsd:pause-work
Salva o estado atual em continue-here.md para retomar depois
/gsd:resume-work
Restaura contexto completo após reset de sessão ou nova conversa
/gsd:progress
Mostra onde está no projeto e próximos passos ("onde estou?")
/gsd:session-report
Gera relatório pós-sessão com trabalho realizado e estimativa de custo
Desativar o monitor
Configure hooks.context_warnings: false no config.json para projetos onde o aviso é desnecessário.
Threads são armazenamentos de conhecimento cross-session para trabalho que atravessa múltiplas sessões mas não pertence a nenhuma fase específica. Mais leves que /gsd:pause-work.
/gsd:thread # Lista todos os threads
/gsd:thread fix-deploy-key-auth # Retoma thread existente
/gsd:thread "Investigate TCP timeout issue" # Cria novo thread