## Overview

A context agent for continuity across sessions. Saves summaries, decisions, and pending tasks, and loads an automatic briefing in the next session.

## 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

Perfect continuity between Claude Code sessions. It captures, compresses, and
restores context automatically — topics, decisions, tasks, errors,
modified files, and technical findings.

## Location

```
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
```

## Initialization (First Time)

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

## Save The Current Session's Context

When the session is ending or before a long task, save the context:

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

What it does:
1. Finds the most recent JSONL file for the session
2. Analyzes all messages, tool calls, and results
3. Generates a structured summary (session-NNN.md)
4. Updates ACTIVE_CONTEXT.md with new information
5. Syncs with MEMORY.md (loaded in the system prompt)
6. Indexes for full-text search

## Load Context (Briefing)

At the start of a new session, load the context:

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

Generates a briefing with: active projects, pending tasks (by priority),
blockers, recent decisions, conventions, and a summary of the latest sessions.

## Quick Status

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

A few-line summary: projects, critical pending items, blockers.

## Search The History

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

Full-text search (SQLite FTS5) across all sessions — topics, decisions,
errors, files, etc.

## Maintenance

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

Archives old sessions, compresses the archive, re-syncs MEMORY.md,
and rebuilds the search index.

## Workflow

```
[Session ends]
  → save → session-NNN.md + ACTIVE_CONTEXT.md + MEMORY.md

[New session begins]
  → MEMORY.md is already in the system prompt (automatic)
  → load → detailed briefing with everything you need to know

[Context grows too large]
  → maintain → archives old sessions, compresses, optimizes
```

## What Is Captured In Each Session

- **Topics**: subjects discussed
- **Decisions**: technical and architectural choices
- **Completed tasks**: what was done
- **Pending tasks**: what remains (with priority)
- **Modified files**: which files were edited/created
- **Findings**: important technical insights
- **Resolved errors**: problems and their solutions
- **Open questions**: unanswered questions
- **Metrics**: tokens consumed, messages, tool calls

## Integration With Memory.Md

ACTIVE_CONTEXT.md is automatically copied to:
`C:\Users\renat\.claude\projects\C--Users-renat-skills\memory\MEMORY.md`

Because MEMORY.md is included in the system prompt of every session, Claude
always starts knowing the current state of projects, pending tasks,
and decisions made — with no manual action needed.

## References

- For the detailed file format: `references/context-format.md`
- For compression and archiving rules: `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