Guardião de Contexto

Este guia foi intencionalmente escrito em português brasileiro. Os cabeçalhos When to Use e Limitations permanecem em inglês apenas para compatibilidade com a descoberta e validação automática de catálogo.

[!WARNING] Esta skill cria snapshots e pode removê-los durante a poda. Confirme o diretório de dados, mantenha um backup e obtenha aprovação explícita antes de executar save ou prune; nunca presuma autorização para alterar MEMORY.md ou outros arquivos de contexto do usuário.

Visão Geral

Guardião de contexto que preserva dados críticos antes da compactação automática. Snapshots, verificação de integridade e zero perda de informação.

Quando Usar Esta Skill

• Quando o usuário mencionar "compactação de contexto" ou assuntos relacionados
• Quando o usuário mencionar "perda de contexto" ou assuntos relacionados
• Quando o usuário mencionar "snapshot de contexto" ou assuntos relacionados
• Quando o usuário mencionar "preservar contexto" ou assuntos relacionados
• Quando o usuário mencionar "contexto crítico" ou assuntos relacionados
• Quando o usuário mencionar "antes de compactar" ou assuntos relacionados

Quando Não Usar Esta Skill

• A tarefa não estiver relacionada à preservação de contexto
• Uma ferramenta mais simples e específica puder atender ao pedido
• O usuário precisar apenas de assistência geral, sem esta especialização

Como Funciona

Sistema de integridade de contexto que protege projetos técnicos complexos contra perda de informação durante a compactação automática do Claude Code. Enquanto o context-agent atua APÓS as sessões (save/load), o context-guardian atua DURANTE a sessão, detectando quando a compactação está próxima e executando protocolos de preservação com verificação redundante.

Por Que Isto Existe

O Claude Code compacta automaticamente mensagens antigas quando o contexto se aproxima do limite da janela. Essa compactação é heurística — ela resume mensagens para liberar espaço, mas inevitavelmente perde detalhes. Para projetos simples, isso funciona bem. Mas para projetos técnicos pesados (como ecossistemas com 21+ skills, auditorias de segurança, refatorações de arquitetura), a perda de um único detalhe pode causar regressões, retrabalho ou inconsistências graves.

O context-guardian resolve isso criando uma camada de proteção PRÉ-compactação: extrai, classifica, verifica e persiste todas as informações críticas ANTES que a compactação automática as destrua.

Localização

C:\Users\renat\skills\context-guardian\
├── SKILL.md                          # Este arquivo
├── references/
│   ├── extraction-protocol.md        # Protocolo detalhado de extracao
│   └── verification-checklist.md     # Checklist de verificacao e redundancia
└── scripts/
    └── context_snapshot.py           # Script de snapshot automatico

Integração Com O Ecossistema

context-guardian (PRE-compactacao)    context-agent (POS-sessao)
         │                                    │
         ├── Detecta contexto grande          ├── Salva resumo ao final
         ├── Extrai dados criticos            ├── Atualiza ACTIVE_CONTEXT.md
         ├── Verifica integridade             ├── Sincroniza MEMORY.md
         ├── Salva snapshot verificado        ├── Indexa busca FTS5
         └── Gera briefing de transicao       └── Arquiva sessoes antigas

O context-guardian e o context-agent são complementares:

• context-guardian: proteção em tempo real, DURANTE a sessão
• context-agent: persistência entre sessões, APÓS a sessão

Ativação Automática (O Claude Deve Iniciar Sozinho)

1. Limite de contexto: quando perceber que já consumiu ~60-70% da janela de contexto (indicadores: mensagens começando a ser resumidas, aviso de compactação)
2. Projetos pesados: sessões com muitos arquivos editados, muitas tool calls, ou projetos com dependências complexas entre componentes
3. Antes de tarefas longas: quando uma próxima tarefa pode gerar output extenso que empurraria o contexto para além do limite

Ativação Manual (Usuário Solicita)

• "salva o estado antes de comprimir"
• "faz um checkpoint"
• "snapshot do contexto"
• "não quero perder nada dessa sessão"
• "prepara pra compactação"
• "o contexto está grande, protege"

Fase 1: Extração Estruturada

Percorrer toda a conversa até o momento e extrair categorias críticas. Para cada categoria, classificar por prioridade (P0 = perda fatal, P1 = perda grave,

…