# Context Manager

> |

- **Type:** Skill
- **Install:** `agentstack add skill-felvieira-claude-skills-fv-08-context-manager`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [felvieira](https://agentstack.voostack.com/s/felvieira)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [felvieira](https://github.com/felvieira)
- **Source:** https://github.com/felvieira/claude-skills-fv/tree/main/skills/08-context-manager

## Install

```sh
agentstack add skill-felvieira-claude-skills-fv-08-context-manager
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Context Manager - Gerenciamento de Contexto e Tarefas

O Context Manager mantem foco, rastreabilidade e continuidade sem inflar contexto.

## Governanca Global

Esta skill herda comportamento base de `GLOBAL.md` e destas policies:

- `policies/execution.md`
- `policies/persistence.md`
- `policies/token-efficiency.md`
- `policies/handoffs.md`
- `policies/evals.md`

Se houver conflito entre instrucoes, a hierarquia global do kit prevalece.

## Quando Usar

- criar ou reorganizar lista de tarefas
- registrar mudanca de foco, bloqueio ou decisao relevante
- resumir estado atual para continuidade entre sessoes
- manter dependencias entre frentes visiveis

## Quando Nao Usar

- para substituir a logica do Orquestrador
- para persistir conversa operacional longa sem valor futuro
- para registrar detalhes triviais que nao ajudam a proxima etapa

## Entradas Esperadas

- pedido atual do usuario
- plano ou pipeline em execucao
- estado atual das tarefas
- dependencias, bloqueios e decisoes relevantes

## Saidas Esperadas

- lista de tarefas atualizada
- foco atual resumido
- historico enxuto quando houver troca de contexto
- handoff curto para o Orquestrador ou proxima skill

## Responsabilidades

1. Criar listas de tarefas a partir de specs, issues ou pedidos do usuario
2. Atualizar status das tarefas em tempo real conforme progresso
3. Detectar mudanca de foco quando o usuario muda de assunto
4. Resumir e persistir apenas o que ajuda a proxima sessao
5. Tornar dependencias e blockers visiveis

## Ciclo de Vida de uma Tarefa

Usar o mecanismo disponivel no ambiente:

`Criar item (pending) -> Atualizar para in_progress -> Execucao -> Atualizar para completed -> Revisar lista geral`

## Regras de Operacao

- titulo no imperativo e curto
- uma tarefa `in_progress` por vez quando possivel
- no maximo 15 tarefas ativas antes de priorizar ou arquivar
- bloquear ruido e manter so o necessario para continuidade

## Mudanca de Foco

Quando o pedido sair do escopo atual:

- identificar se o novo pedido compete com o trabalho ativo
- confirmar com o usuario apenas se arquivar puder ocultar algo ainda importante
- persistir resumo curto do contexto anterior
- registrar o novo foco com tarefas iniciais

## Persistencia Recomendada

Preferencia de mecanismos:

1. ferramenta nativa de task ou memoria do ambiente
2. arquivo local sob `docs/context/` quando o ambiente for stateful
3. resumo curto em handoff quando nao houver persistencia entre sessoes

Se usar arquivo local, preferir `docs/context/current-focus.md` e `docs/context/history.md`.

## Integracao com Orchestrator

- o Orquestrador decide qual skill executa
- o Context Manager acompanha progresso, dependencias e blockers
- cada etapa concluida gera estado resumido e pronto para handoff

## Evidencia de Conclusao

- lista de tasks coerente com o foco atual
- estado atual resumido sem ruido operacional
- dependencias e blockers visiveis para a proxima etapa

## Skills Utilitárias (context: fork)

Quando uma sub-operação desta skill for puramente mecânica — ler cache, gravar estado,
checar arquivo — sem necessidade de raciocínio do modelo, preferir o padrão:

```yaml
# frontmatter da sub-skill utilitária
context: fork
disable-model-invocation: true
```

Isso isola a execução e evita consumir contexto do agente principal para tarefas
que são essencialmente I/O. Padrão observado em [addozhang/mem9](https://github.com/addozhang/mem9)
(Apache-2.0) nas skills `recall`, `store` e `setup`.

**Quando aplicar:** sub-skills de leitura de vault, gravação de estado de sessão,
verificação de auth, fetch de memória externa. **Não aplicar** quando a operação
requer julgamento contextual (ex: decidir o que salvar, priorizar tasks).

## Handoff

Seguir `policies/handoffs.md` e, quando util, `templates/handoff.md`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [felvieira](https://github.com/felvieira)
- **Source:** [felvieira/claude-skills-fv](https://github.com/felvieira/claude-skills-fv)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-felvieira-claude-skills-fv-08-context-manager
- Seller: https://agentstack.voostack.com/s/felvieira
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.