Context Agent

Overview

Agente de contexto para continuidade entre sessoes. Salva resumos, decisoes, tarefas pendentes e carrega briefing automatico na sessao seguinte.

When to Use This Skill

When the user mentions "salvar contexto" or related topics
When the user mentions "salva o contexto" or related topics
When the user mentions "proxima sessao" or related topics
When the user mentions "briefing sessao" or related topics
When the user mentions "resumo sessao" or related topics
When the user mentions "continuidade sessao" or related topics

Do Not Use This Skill When

The task is unrelated to context agent
A simpler, more specific tool can handle the request
The user needs general-purpose assistance without domain expertise

How It Works

Continuidade perfeita entre sessões do Claude Code. Captura, comprime e restaura contexto automaticamente — tópicos, decisões, tarefas, erros, arquivos modificados e descobertas técnicas.

Localização

C:\Users\renat\skills\context-agent\
├── SKILL.md
├── scripts/
│   ├── config.py               # Paths e constantes
│   ├── models.py               # Dataclasses
│   ├── session_parser.py       # Parser JSONL do Claude Code
│   ├── session_summary.py      # Gerador de resumos
│   ├── active_context.py       # Gerencia ACTIVE_CONTEXT.md
│   ├── project_registry.py     # Registro de projetos
│   ├── compressor.py           # Compressão e arquivamento
│   ├── search.py               # Busca FTS5
│   ├── context_loader.py       # Carrega contexto
│   └── context_manager.py      # CLI entry point
├── references/
│   ├── context-format.md       # Especificação de formatos
│   └── compression-rules.md    # Regras de compressão
└── data/
    ├── sessions/               # session-001.md, session-002.md, ...
    ├── archive/                # Sessões arquivadas
    ├── ACTIVE_CONTEXT.md       # Contexto consolidado (max 150 linhas)
    ├── PROJECT_REGISTRY.md     # Status de todos os projetos
    └── context.db              # SQLite FTS5 para busca

Inicialização (Primeira Vez)

python C:\Users\renat\skills\context-agent\scripts\context_manager.py init

Salvar Contexto Da Sessão Atual

Quando a sessão está terminando ou antes de uma tarefa longa, salvar o contexto:

python C:\Users\renat\skills\context-agent\scripts\context_manager.py save

O que faz:

Encontra o arquivo JSONL mais recente da sessão
Analisa todas as mensagens, tool calls e resultados
Gera resumo estruturado (session-NNN.md)
Atualiza ACTIVE_CONTEXT.md com novas informações
Sincroniza com MEMORY.md (carregado no system prompt)
Indexa para busca full-text

Carregar Contexto (Briefing)

No início de uma nova sessão, carregar o contexto:

python C:\Users\renat\skills\context-agent\scripts\context_manager.py load

Gera briefing com: projetos ativos, tarefas pendentes (por prioridade), bloqueadores, decisões recentes, convenções e resumo das últimas sessões.

Status Rápido

python C:\Users\renat\skills\context-agent\scripts\context_manager.py status

Resumo em poucas linhas: projetos, pendências críticas, bloqueadores.

Buscar No Histórico

python C:\Users\renat\skills\context-agent\scripts\context_manager.py search "rate limit"

Busca full-text (SQLite FTS5) em todas as sessões — tópicos, decisões, erros, arquivos, etc.

Manutenção

python C:\Users\renat\skills\context-agent\scripts\context_manager.py maintain

Arquiva sessões antigas, comprime arquivo, ressincroniza MEMORY.md, reconstrói índice de busca.

Fluxo De Trabalho

[Sessão termina]
  → save → session-NNN.md + ACTIVE_CONTEXT.md + MEMORY.md

[Nova sessão começa]
  → MEMORY.md já está no system prompt (automático)
  → load → briefing detalhado com tudo que precisa saber

[Contexto cresce demais]
  → maintain → arquiva sessões antigas, comprime, otimiza

O Que É Capturado Em Cada Sessão

Tópicos: assuntos discutidos
Decisões: escolhas técnicas e de arquitetura
Tarefas concluídas: o que foi feito
Tarefas pendentes: o que falta (com prioridade)
Arquivos modificados: quais arquivos foram editados/criados
Descobertas: insights técnicos importantes
Erros resolvidos: problemas e suas soluções
Questões em aberto: perguntas sem resposta
Métricas: tokens consumidos, mensagens, tool calls

Integração Com Memory.Md

O ACTIVE_CONTEXT.md é automaticamente copiado para: C:\Users\renat\.claude\projects\C--Users-renat-skills\memory\MEMORY.md

Como o MEMORY.md é incluído no system prompt de toda sessão, o Claude sempre começa sabendo o estado atual dos projetos, tarefas pendentes e decisões tomadas — sem precisar de nenhuma ação manual.

Referências

Para formato detalhado dos arquivos: references/context-format.md
Para regras de compressão e arquivamento: references/compression-rules.md

Best Practices

Provide clear, specific context about your project and requirements
Review all suggestions before applying them to production code
Combine with other complementary skills for comprehensive analysis

Common Pitfalls

Using this skill for tasks outside its domain expertise
Applying recommendations without understanding your specific context
Not providing enough project context for accurate analysis

Related Skills

context-guardian - Complementary skill for enhanced analysis