antigravity-skills-reference/skills/context-guardian/references/extraction-protocol.md

Protocolo de Extracao Detalhado

Guia passo a passo para extrair TODAS as informacoes criticas de uma sessao antes da compactacao. Siga na ordem — cada secao depende da anterior.

Passo 1: Inventario de Arquivos

Listar TODOS os arquivos que foram:

• Criados: caminho absoluto, proposito, tamanho aproximado
• Modificados: caminho, secao alterada (linhas), natureza da mudanca
• Lidos (para referencia): caminho, por que foi lido, informacao extraida
• Deletados: caminho, motivo

Formato:

### Arquivos Tocados
| Arquivo | Acao | Detalhes |
|---------|------|----------|
| C:\path\file.py | EDIT L40-119 | Adicionou 5 categorias a CAPABILITY_KEYWORDS |
| C:\path\new.md | CREATE | Nova skill com 14 modulos |
| C:\path\old.bak | DELETE | Backup obsoleto |

Passo 2: Decisoes e Seus Motivos

Para cada decisao tecnica tomada na sessao:

### Decisoes
- **O que**: [descricao da decisao]
  **Por que**: [motivo tecnico]
  **Alternativas descartadas**: [opcoes que nao foram escolhidas e por que]
  **Impacto**: [o que muda por causa dessa decisao]

Decisoes incluem: escolha de tecnologia, padrao de codigo, arquitetura, naming conventions, estrategia de teste, prioridade de tarefas.

Passo 3: Bugs e Correcoes

Para cada bug encontrado e corrigido:

### Correcoes
- **Sintoma**: [como o bug se manifestou]
  **Causa raiz**: [por que acontecia]
  **Arquivo**: [caminho:linha]
  **Correcao**: [o que foi feito, em 1-2 linhas de codigo se relevante]
  **Verificacao**: [como confirmou que esta corrigido]

Passo 4: Estado de Progresso

### Progresso
- Total de tarefas: X
- Concluidas: Y (lista)
- Em andamento: Z (lista com % e proximo passo)
- Pendentes: W (lista com prioridade e dependencias)
- Bloqueadas: V (lista com motivo do bloqueio)

Passo 5: Codigo Critico

Trechos de codigo que sao FUNDAMENTAIS para o entendimento do projeto. Nao copiar arquivos inteiros — apenas os trechos que representam decisoes ou logica nao-obvia.

### Trechos Criticos
**match_skills.py:40-119** — Categorias de capacidade:
- legal: ~70 keywords cobrindo todas as areas do direito brasileiro
- auction: leilao judicial/extrajudicial
- security: owasp, pentest, vulnerabilidades
- image-generation: stable diffusion, comfyui, midjourney
- monitoring: health, status, audit, sentinel

Passo 6: Padroes e Convencoes

### Padroes Observados
- [padrao]: [descricao] — [onde se aplica]

Exemplos: "ZIPs devem conter {skill-name}/ E .claude/skills/{skill-name}/", "SQL usa ? placeholders, nunca f-strings", "Tokens mascarados com [:8]...masked".

Passo 7: Dependencias Criticas

Conexoes entre componentes que NAO sao obvias:

### Dependencias
- scan_registry.py CAPABILITY_MAP === match_skills.py CAPABILITY_KEYWORDS
  (devem ser identicos, senao matching quebra)
- SKILL.md frontmatter DEVE ter: name, version, description
  (scan_registry.py valida esses campos)

Passo 8: Contexto do Usuario

### Contexto
- Objetivo do usuario: [o que ele quer alcançar no macro]
- Nivel tecnico: [como interage, que termos usa]
- Preferencias: [idioma, formato, nivel de detalhe]
- Proxima acao esperada: [o que o usuario provavelmente vai pedir]

Formato do Snapshot Final

O arquivo snapshot-YYYYMMDD-HHMMSS.md deve conter TODAS as secoes acima nesta ordem, precedidas por um cabecalho:

# Context Guardian Snapshot — YYYY-MM-DD HH:MM:SS
**Sessao**: [identificador ou slug]
**Projeto**: [nome do projeto]
**Modelo**: [claude-opus-4-6 etc]
**Contexto consumido**: ~X% (estimativa)

[Todas as secoes do Passo 1-8]

---
*Snapshot gerado por context-guardian v1.0.0*
*Para restaurar: leia este arquivo + MEMORY.md + context_manager.py load*