---
name: agent-context-injector
description: Injeccao dinamica de contexto (MCPs e Skills) nos agentes via script Python + hook SessionStart com deteccao de staleness.
user-invocable: false
allowed-tools: Read, Glob, Grep, ToolSearch
---

# Agent Context Injector

Regeneracao automatica das seccoes "Your Available MCPs" e "Your Available Skills" em todos os agentes.

## Como funciona

1. **Hook SessionStart** (`~/.claude/hooks/agent-context-refresh.sh`) calcula hash dos inputs
2. Se hash mudou → executa `~/.claude/scripts/regenerate-agent-context.py`
3. Script le frontmatter de cada agente, inventario MCPs, mapeamento domain e skills dos plugins
4. Gera seccoes entre marcadores `<!-- BEGIN:AUTO-CONTEXT -->` / `<!-- END:AUTO-CONTEXT -->`
5. Guarda novo hash em `~/.claude/.agent-context-hash`

## Ficheiros

| Ficheiro | Funcao |
|----------|--------|
| `~/.claude/scripts/regenerate-agent-context.py` | Script principal de regeneracao |
| `~/.claude/hooks/agent-context-refresh.sh` | Hook SessionStart com staleness |
| `~/.claude/_resources/domain-mcp-map.json` | Mapeamento domain -> MCPs recomendados |
| `~/.claude/_resources/mcps.json` | Inventario de 34+ MCPs |
| `~/.claude/.agent-context-hash` | Hash MD5 dos inputs (staleness) |

## Dados de entrada

- **Agentes:** `~/.claude/agents/*.md` — frontmatter com `domain`, `skills`
- **MCPs:** `~/.claude/_resources/mcps.json` — lista com `id`, `name`, `category`
- **Domain map:** `~/.claude/_resources/domain-mcp-map.json` — primary/recommended por domain
- **Skills:** `descomplicar-plugins/*/skills/*/SKILL.md` — frontmatter com `name`, `description`

## Performance

| Cenario | Tempo |
|---------|-------|
| Sem mudancas (hash match) | ~66ms |
| Com regeneracao (61 agentes) | ~2-3s |

## Manutencao

- **Adicionar MCP:** actualizar `mcps.json` e `domain-mcp-map.json` → proximo SessionStart regenera
- **Adicionar skill:** criar SKILL.md no plugin → proximo SessionStart regenera
- **Adicionar agente:** criar .md com frontmatter `domain:` → proximo SessionStart gera contexto
- **Mudar domain map:** editar `domain-mcp-map.json` → proximo SessionStart regenera

## Tarefa Desk

#1996 — Sistema injeccao Skills e MCPs nos agentes

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*