130 lines
3.7 KiB
Markdown
130 lines
3.7 KiB
Markdown
# 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:
|
|
|
|
```markdown
|
|
### 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:
|
|
|
|
```markdown
|
|
### 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:
|
|
|
|
```markdown
|
|
### 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
|
|
|
|
```markdown
|
|
### 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.
|
|
|
|
```markdown
|
|
### 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
|
|
|
|
```markdown
|
|
### 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:
|
|
|
|
```markdown
|
|
### 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
|
|
|
|
```markdown
|
|
### 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:
|
|
|
|
```markdown
|
|
# 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*
|
|
```
|