# AGENTE ORQUESTRADOR — Pesquisa Jurídica SAVE Company
**Projeto:** Cristiano Vasconcelos / SAVE Company  
**Versão:** 2026.06  
**Função:** Instrução mestre — como rodar qualquer agente editorial nesta pasta

---

## O QUE EXISTE AQUI

Esta pasta contém um sistema de **parameterização editorial** para transformar decisões jurídicas reais em conteúdo estratégico para o Cristiano Vasconcelos.

### Agentes disponíveis

| Arquivo | Tema | Dados locais | Volume |
|---|---|---|---|
| `AGENTE-BANCARIO.md` | Banco vs Empresa | `banco-vs-empresa/todos_empresa_venceu.json` | 9.135 casos |
| `AGENTE-CARF.md` | Receita Federal / CARF | `carf-dados/carf_*.json` + `receita-vs-empresa/` | 576k acórdãos |
| `AGENTE-TRABALHISTA.md` | TRT — Empregador venceu | `receita-vs-empresa/trt_empresa_venceu.json` | 12.499 casos |
| `AGENTE-TRABALHISTA-MPT.md` | MPT + MTE Administrativo | `pesquisa-juridica/mte_empregador_venceu.json` | 424 casos (FGTS + Multas)¹ |
| `AGENTE-NULIDADES-CARF.md` | Nulidades formais CARF | `carf-dados/carf_*.json` | 576k (filtrar) |
| `AGENTE-PESQUISA-CARF.md` | Pesquisa temática CARF | `carf-dados/carf_*.json` | 576k (filtrar) |
| `AGENTE-ENGENHARIA-REVERSA.md` | Base metodológica (5 blocos) | — | — |
| `INSTRUCOES-AGENTE.md` | Tom de voz + ICP | — | — |

---

## COMO RODAR UM AGENTE

### Sequência padrão

1. **Ler obrigatoriamente antes de qualquer execução:**
   - `INSTRUCOES-AGENTE.md` → tom de voz, ICP, o que evitar
   - `AGENTE-ENGENHARIA-REVERSA.md` → estrutura dos 5 blocos obrigatórios

2. **Carregar o agente temático:**
   - Ler o agente específico (`AGENTE-BANCARIO.md`, etc.)
   - Carregar o JSON de dados indicado no agente
   - Selecionar casos conforme os critérios do agente

3. **Para cada caso, aplicar os 5 blocos:**
   - BLOCO 1: O caso (3-5 frases, contexto PME)
   - BLOCO 2: Por que venceu (fundamento em linguagem direta + ementa real)
   - BLOCO 3: O que foi decisivo (máx. 5 documentos)
   - BLOCO 4: O que o adversário violou (norma específica)
   - BLOCO 5: Protocolo preventivo (4 ações concretas e executáveis)

4. **Salvar output:**
   - HTML → `pesquisa-juridica/[tema]-engenharia-reversa.html`
   - Markdown → `pesquisa-juridica/posts-[tema]/caso_[numero].md`

---

## DADOS DISPONÍVEIS NA VPS

```
/home/cristiano/meus-projetos/
│
├── banco-vs-empresa/
│   ├── banco_vs_empresa_v2.json        # 1.419 TJSP com EMENTA REAL (usar primeiro)
│   └── todos_empresa_venceu.json       # 9.135 total (TJSP + 9 TJs + STJ)
│
├── receita-vs-empresa/
│   ├── carf_contribuinte_venceu.json   # 1.682 CARF com ementa real (filtrado: vitórias)
│   ├── trf_empresa_venceu.json         # 12.361 TRF1–TRF6 + STJ (metadados)
│   └── trt_empresa_venceu.json         # 12.499 TRT1–TRT24 + TST (metadados)
│
├── carf-dados/
│   ├── carf_2026.json                  # 6.677 acórdãos — EMENTA REAL
│   ├── carf_2025.json                  # 19.416 acórdãos — EMENTA REAL
│   ├── carf_2024.json                  # 25.916 acórdãos — EMENTA REAL
│   ├── carf_2023.json                  # 22.467 acórdãos — EMENTA REAL
│   └── carf_[2010-2022].json           # em download — EMENTA REAL
│
└── pesquisa-juridica/
    └── mte_empregador_venceu.json      # 424 casos FGTS/Multas nos TRFs — ⚠️ não é MTE puro (ver nota no agente)
```

### Qual usar quando

| Preciso de... | Usar |
|---|---|
| Ementa real TJSP (bancos) | `banco_vs_empresa_v2.json` — campo `ementa` |
| Volume grande banco vs empresa | `todos_empresa_venceu.json` |
| Ementa real CARF (qualquer tributo) | `carf-dados/carf_2025.json` ou `carf_2026.json` |
| Só vitórias do contribuinte no CARF | `carf_contribuinte_venceu.json` |
| Trabalhista com detalhes de categoria | `trt_empresa_venceu.json` — campo `motivo` |
| MTE administrativo | `mte_empregador_venceu.json` |

---

## ATUALIZAÇÃO DOS DADOS

### Cron diário (3h da manhã)
O sistema coleta automaticamente casos novos de todas as fontes:
```bash
# Ver próxima execução:
crontab -l | grep atualizar

# Rodar manualmente:
python3 /home/cristiano/meus-projetos/cron_save.sh

# Ver log da última execução:
tail -50 /home/cristiano/meus-projetos/cron.log
```

### CARF bulk (em andamento)
Download completo de 576k acórdãos em progresso:
```bash
# Ver status:
ls -lah ~/meus-projetos/carf-dados/
# Ver progresso:
tail -5 ~/meus-projetos/carf-dados/download.log
```

---

## CHECKLIST UNIVERSAL (antes de qualquer entrega)

- [ ] Número do processo/acórdão é real (copiado do JSON — nunca inventado)
- [ ] Ementa transcrita literalmente (quando disponível) — nunca parafraseada como se fosse real
- [ ] Quando não há ementa: descrever o caso com base em `assuntos` + `motivo` + `tipo_decisao`
- [ ] Protocolo preventivo: 4 ações específicas e executáveis (não genéricas)
- [ ] Zero juridiquês — se precisar citar artigo: "O art. X diz que..." em português direto
- [ ] Recuperação Tributária NÃO mencionada (é do Marcos Adriano)
- [ ] O empresário leu e pensou "esse caso poderia ser meu"?
- [ ] As 4 ações preventivas ele consegue fazer essa semana sem contratar ninguém?

---

## EXEMPLOS DE PROMPT PARA ATIVAR UM AGENTE

### Para um LLM externo (Claude, GPT, etc.):

```
Leia os seguintes arquivos em ordem:
1. /home/cristiano/meus-projetos/pesquisa-juridica/INSTRUCOES-AGENTE.md
2. /home/cristiano/meus-projetos/pesquisa-juridica/AGENTE-ENGENHARIA-REVERSA.md
3. /home/cristiano/meus-projetos/pesquisa-juridica/AGENTE-CARF.md

Depois carregue o arquivo:
/home/cristiano/meus-projetos/carf-dados/carf_2026.json

Selecione 10 acórdãos onde o contribuinte venceu (campo `decisao` contém
"provimento ao recurso do contribuinte" ou "cancelar o lançamento").

Para cada um, gere um card completo com os 5 blocos obrigatórios.
Output em HTML, seguindo o padrão visual do AGENTE-ENGENHARIA-REVERSA.md.
Salve em: /home/cristiano/meus-projetos/pesquisa-juridica/carf-decisoes-contribuinte-venceu.html
```

### Para rodar automaticamente (script Python):
```python
# Ver: /home/cristiano/meus-projetos/receita-vs-empresa/gerar_cards_receita.py
# Adaptar para o agente que quiser usar
```

---

## MÉTRICAS DO SISTEMA

| Instância | Decisões coletadas | Com ementa real |
|---|---|---|
| TJSP (bancos) | 1.419 | ✅ 473 com ementa CJSG |
| TJ estaduais (8) | 7.971 | ❌ só metadados |
| TRT (24 + TST) | 12.499 | ❌ só metadados |
| TRF (6 + STJ) | 12.361 | ❌ só metadados |
| MTE via TRF (FGTS+Multas) | 424 | ❌ metadados — ⚠️ não é MTE puro |
| CARF (filtrado) | 1.682 | ✅ ementa real |
| CARF (bulk 2023-26) | ~74.000+ | ✅ ementa real |
| CARF (bulk total) | 576.495 | ✅ ementa real |
| **TOTAL** | **~690.000** | — |

---

*SAVE Company — sistema de parameterização editorial v2026.06*  
*Pasta: `/home/cristiano/meus-projetos/pesquisa-juridica/`*