FrancoStino Context Agent
Este guia e intencionalmente escrito em portugues brasileiro. O cabecalho Os cabecalhos
When to UseeLimitationspermanecem em ingles apenas para compatibilidade com a descoberta e a validacao automatica do catalogo.
[!WARNING] Esta skill escreve contexto, registros, um banco SQLite e
MEMORY.mdem caminhos locais; a manutencao tambem pode arquivar e remover resumos antigos. Confirme os caminhos, mantenha um backup e obtenha aprovacao explicita antes de executarinit,save,archiveoumaintain.
Visao Geral
Agente de contexto para continuidade entre sessoes. Salva resumos, decisoes, tarefas pendentes e carrega briefing automatico na sessao seguinte.
When to Use This Skill
- Quando o usuario mencionar "salvar contexto" ou assuntos relacionados
- Quando o usuario mencionar "salva o contexto" ou assuntos relacionados
- Quando o usuario mencionar "proxima sessao" ou assuntos relacionados
- Quando o usuario mencionar "briefing sessao" ou assuntos relacionados
- Quando o usuario mencionar "resumo sessao" ou assuntos relacionados
- Quando o usuario mencionar "continuidade sessao" ou assuntos relacionados
Quando Nao Usar Esta Skill
- A tarefa nao estiver relacionada a continuidade de contexto
- Uma ferramenta mais simples e especifica puder atender ao pedido
- O usuario precisar apenas de assistencia geral, sem esta especializacao
Como Funciona
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
Boas Praticas
- Forneca contexto claro e especifico sobre o projeto e seus requisitos
- Revise todas as sugestoes antes de aplica-las em codigo de producao
- Combine esta skill com outras skills complementares quando necessario
Armadilhas Comuns
- Usar esta skill em tarefas fora de seu dominio
- Aplicar recomendacoes sem entender o contexto especifico
- Fornecer contexto insuficiente para uma analise precisa
Skills Relacionadas
context-guardian- Skill complementar para preservar contexto antes da compactacao
Limitations
- Use esta skill somente quando a tarefa corresponder claramente ao escopo acima.
- A implementacao incluida usa caminhos absolutos especificos do Windows e do autor; adapte e valide todos os caminhos antes de qualquer execucao.
- Nao trate a saida como substituta de validacao, testes ou revisao especializada.
- Pare e peca esclarecimentos quando faltarem entradas, permissoes, limites de seguranca ou criterios de sucesso.