Corretor de Peças PRO
O projeto "Correção de peças" da Vanna hoje vive como projeto do ChatGPT. Este protocolo converte esse projeto em GPT customizado compartilhável com os alunos, pela primeira vez. Cronológico, do material bruto ao agente no ar.
Como usar este documento
Navegue pelos slides em ordem. Cada um representa uma etapa do protocolo. Você pode ir pelo sumário lateral (☰), pelas setas, ou pela barra inferior.
Claude arquiteta o agente. ChatGPT hospeda.
O ChatGPT é usado apenas para (1) capturar o material bruto na Fase 0 e (2) hospedar o GPT final na Fase 3. Todo o trabalho de engenharia acontece no Claude Code — incluindo a mineração (Fase 1), a montagem em 4 Levas (Fase 2), o teste com rubrica (Fase 4) e a manutenção (Fase 5).
Status atual
| Fase | Status |
|---|---|
| Fase 0 · Camada A (instruções do projeto) | ✓ concluída |
| Fase 0 · Camada B (MP4s + transcrições) | pendente |
| Fase 0 · Camada C (export + conversas) | pendente |
| Fase 1 · Mineração (Claude gera 9 arquivos) | aguarda Fase 0 |
| Fase 2 · Montagem em 4 Levas | aguarda Fase 1 |
| Fase 3 · Criação do GPT no painel | aguarda Fase 2 |
| Fase 4 · Teste com rubrica | aguarda Fase 3 |
| Fase 5 · Manutenção contínua | aguarda Fase 4 |
Atalhos de teclado
- ← → navegar
- Space avança
- Home End início/fim
- Esc fecha sumário
Arquivos desta pasta
00_LEIA-ME.md— primeira leitura01_PROTOCOLO.md— documento completo02_PROMPT_SUPREMO.md— para colar em Claude Codescripts/parse_export.py— filtra conversas
O que estamos construindo
Hoje
Projeto "Correção de peças" no ChatGPT da Vanna. Tem:
- Instruções (10 pontos da petição perfeita)
- ~20 vídeos MP4 (correções reais e modelos ensinando)
- Conversas acumuladas com alunos
Limitação: só a Vanna usa, nenhum aluno acessa.
Destino
Corretor de Peças PRO — GPT customizado, com:
- System prompt que reproduz a voz e o método da Vanna
- Knowledge com transcrições dos vídeos
- Conversation starters criados do zero
- Guardrails éticos OAB
- Compartilhável com os alunos via link
Divisão de trabalho
| Fase | Onde | Quem |
|---|---|---|
| Fase 0 · Captura das 3 camadas | Painel do ChatGPT | Victor |
| Fase 1 · Mineração | Claude Code | Claude (gera 8 arquivos) + Victor (preenche o 9º) |
| Fase 2 · Montagem em 4 Levas | Claude Code | Claude arquiteta + Victor valida |
| Fase 3 · Criação do GPT | Painel do ChatGPT | Victor cola o dossiê |
| Fase 4 · Teste com rubrica | Claude + ChatGPT | Claude simula, Victor compara |
| Fase 5 · Manutenção | Claude | Cadência semanal/mensal/evento |
Fase 0 — Captura do material bruto
Três camadas distintas, coletadas no painel do ChatGPT. A ordem importa: se pular aqui, o resto desmorona.
📝 Camada A — Instruções
✓ concluída
As instruções do projeto já estão em material_projeto/A_instrucoes_projeto.txt. A Vanna escreveu os 10 pontos da petição perfeita. Isso é o pilar do system prompt.
🎥 Camada B — Vídeos + Transcrições
pendente
Baixar os ~20 MP4s da base do projeto e transcrever cada um para texto. O GPT não lê vídeo — o que sobe no Knowledge são as transcrições.
💬 Camada C — Conversas
pendente
Export oficial do ChatGPT (Settings → Data Controls → Export Data) filtrado pelo projeto "Correção de peças" via script Python. Todas as conversas, sem triagem — o ouro do padrão real de correção mora aqui.
Instruções do projeto
O texto que a Vanna configurou dentro do projeto "Correção de peças". Salvo em material_projeto/A_instrucoes_projeto.txt.
Resumo do conteúdo
A Vanna definiu 10 pontos da petição perfeita:
- Preâmbulo técnico correto (sem "Excelentíssimo Senhor Doutor Juiz...")
- Qualificação completa das partes
- Indicação clara do objeto da ação
- Divisão por tópicos com títulos destacados (I – DOS FATOS, II – DO DIREITO, III – DOS PEDIDOS)
- Redação coesa e fluida (parágrafos curtos, transições inteligentes)
- Fundamentação jurídica real (sem inventar)
- Pedido claro e estruturado
- Fecho técnico obrigatório (local, data, OAB)
- Lista de documentos anexos
- Estilo adequado (sem gerundismo, sem latinismo desnecessário)
Esses 10 pontos são o único "system prompt" que o projeto tem hoje. A Leva 2 vai expandir isso para um system prompt completo — mas os 10 pontos continuam sendo o núcleo.
Vídeos e transcrições
Os 20 arquivos da base do projeto são todos MP4. O ChatGPT não lê vídeo — precisam virar texto.
O problema
Hoje o próprio projeto da Vanna marca os MP4s como "conteúdo inacessível". Se você subir MP4 no Knowledge do GPT novo, vai acontecer a mesma coisa. Os vídeos contêm o ouro da Vanna ensinando — precisam ser aproveitados em formato textual.
O que tem na base hoje
🎯 Correções reais (6 vídeos)
Ana Lucia.mp4Torres.mp4Wesley.mp4Adriane.mp4Carlos moreira.mp4Lucas.mp4
📚 Modelos ensinando (14 vídeos)
Screen_Recording_*.mp4(Samsung Notes)- Vídeos da Vanna ensinando o certo e o errado
- Alguns aparecem duplicados na lista — conferir ao baixar
Passo a passo
- Baixar todos os MP4s da base do projeto para
material_projeto/B_arquivos/ - Transcrever cada vídeo. Opções:
- MacWhisper (Mac, local, gratuito)
- Whisper CLI:
whisper arquivo.mp4 --language Portuguese --model medium - otter.ai / rev.com (pagos, online)
- Salvar em
material_projeto/C_transcricoes/Nome-Video.md - Usar o cabeçalho padrão (abaixo)
Os MP4s originais ficam em B_arquivos/ como backup. O que sobe no Knowledge do GPT novo são as transcrições em C_transcricoes/.
Conversas do projeto
O ChatGPT não exporta conversas de projeto individualmente. O caminho é: export completo da conta + script Python que filtra.
Passo a passo
1. Pedir o export da conta
- Settings → Data Controls → Export Data
- Clicar "Export" e confirmar
- Aguardar email com link (minutos a poucas horas)
2. Baixar e salvar o ZIP
Salvar em material_projeto/export_chatgpt_YYYY-MM-DD.zip.
3. Rodar o script de filtro
O script lê conversations.json, identifica automaticamente o projeto "Correção de peças", e gera cada conversa como .md numerada cronologicamente (001 = mais antiga).
O que o script faz
- Descompacta o ZIP (ou aceita pasta já descompactada)
- Lê
conversations.json - Identifica automaticamente o ID do projeto "Correção de peças"
- Filtra só as conversas desse projeto
- Ordena por data de criação
- Gera
001_titulo.md,002_titulo.md... emC_conversas/
Raro, mas possível. O script lista os project_id que encontrou e pede para rodar com --project-id <id>. Mensagem clara no terminal.
Checklist da Fase 0
Cada item abaixo precisa estar marcado antes de abrir o Claude Code na Fase 1. Se faltar, a Fase 1 não tem material para minerar.
material_projeto/A_instrucoes_projeto.txtpreenchido- Todos os MP4s baixados em
material_projeto/B_arquivos/ - Todos os MP4s transcritos em
material_projeto/C_transcricoes/(com cabeçalho padrão) - Export da conta pedido ao ChatGPT (e recebido por email)
- ZIP do export salvo em
material_projeto/ - Script rodado com sucesso →
C_conversas/populada - Quantidade de arquivos em
C_conversas/bate com conversas no painel
Abra uma sessão nova do Claude Code no diretório CORRETOR-DE-PECAS-PRO/. Cole o conteúdo integral de 02_PROMPT_SUPREMO.md como primeira mensagem. Claude assume daí.
Fase 1 — Mineração do material
Você cola o prompt supremo, eu leio todo o material bruto da Fase 0 e gero 9 arquivos consolidados em entrada_claude/.
Os 9 arquivos que serão gerados
| Arquivo | Conteúdo | Quem gera |
|---|---|---|
01_instrucoes.md | Instruções do projeto + observações do Claude + identidade | Claude |
02_conhecimento.md | Tipos de peça + trechos técnicos + transcrições + referências legais | Claude |
03_erros.md | Catálogo de erros apontados + frequência + o que a Vanna ignorou | Claude |
04_fluxo.md | Fluxo de correção reconstruído das conversas | Claude |
05_arquivos.md | Inventário das transcrições + cruzamento com conversas | Claude |
06_interacoes.md | Padrões de abertura + cenários típicos + pedidos recorrentes | Claude |
07_guia_leitura.md | Mapa das conversas: emblemáticas, peça boa, peça ruim, atípicas | Claude |
08_voz_vanna.md | Vocabulário, bordões, princípios didáticos, referências | Claude |
09_observacoes_victor.md | Template vazio — vivência pessoal do Victor | Victor |
Preencher o 09_observacoes_victor.md (template que eu crio vazio). O resto eu gero automaticamente do material bruto. Quando você sinalizar que o 09 está pronto, eu começo a Fase 2.
Regras da Fase 1
- Nada é colado de volta no ChatGPT. Fase 1 é 100% no Claude Code.
- Não invento conteúdo. Se algo está ambíguo no material bruto, marco
[A VALIDAR]e sigo. - Se aparecer método nomeado (ex: PEÇA), só registro se está nas conversas. Caso contrário: "Não há método nomeado."
- Produto solo — nenhum arquivo menciona PC ou outro produto.
Fase 2 — Montagem do agente
Quatro Levas cronológicas, cada uma com checklist de aceite. Victor valida entre cada Leva antes de seguir.
| Leva | O que entrega | Insumos |
|---|---|---|
| Leva 1 | Esqueleto do system prompt + 6 starters candidatos | 01, 04, 06, 07, 08, 09 |
| Leva 1.5 | Descrição curta + manifesto de voz | Esqueleto + 08 |
| Leva 2 | System prompt completo + capabilities + 4 starters finais | Esqueleto + 02, 03, 05 |
| Leva 3 | Modelo de relatório de correção + variantes por peça | Leva 2 + 04, 07 |
| Leva 4 | Dossiê final — pacote pronto para colar no GPT | Tudo anterior |
O projeto atual não tem conversation starters configuráveis, capabilities ligadas/desligadas, nem descrição pública. Esses 3 campos são criados do zero na Leva 2 — não migrados.
Regras entre Levas
- Cada Leva gera arquivo versionado em
entregaveis/(ex:esqueleto_v1.md,esqueleto_v2.md) - Victor valida em formato: MANTER / AJUSTAR / ADICIONAR / REMOVER / REORDENAR
- Nunca sobrescreve — sempre nova versão
- Claude não emenda Leva seguinte sem aval explícito
Leva 1 — Esqueleto do agente
O que eu entrego
- Diagnóstico (≤300 palavras): arquitetura atual, fluxo, voz, lacunas
- Esqueleto do system prompt em blocos hierárquicos:
- IDENTIDADE E PAPEL
- PÚBLICO-ALVO E CONTRATO COM O USUÁRIO
- REGRAS INEGOCIÁVEIS — "NUNCA faça X, porque Y"
- METODOLOGIA DE CORREÇÃO
- TOM, VOZ E DIDÁTICA — com bordões literais
- TRATAMENTO DE CASOS ESPECIAIS
- [placeholders] para Leva 2
- 6 conversation starters candidatos com texto + cenário + justificativa
- Lacunas a fechar na Leva 2
Como você valida
Leva 1.5 — Descrição curta e voz
Trancar descrição e voz antes de entrar no conteúdo jurídico pesado. Evita que a Leva 2 precise refazer identidade.
Entregas
- Descrição curta (30-80 caracteres) — campo Description do GPT
- 3 candidatas + 1 recomendada
- Descrição média (até 300 caracteres) — primeira mensagem ao aluno
- 3 candidatas + 1 recomendada
- Precisa soar como Vanna
- Manifesto de voz interno (5-10 regras imperativas)
- Com exemplos antes/depois
- Bordões que aparecem com frequência
Adjetivos vazios (incrível, poderoso, definitivo, completo, avançado), superlativos genéricos, jargão de marketing. Se a descrição servir para qualquer GPT jurídico, falhou.
Leva 2 — Conteúdo jurídico
Integra o conhecimento técnico no esqueleto validado. É aqui que o system prompt toma forma final — e nascem os 3 campos que não existem no projeto.
Entregas
- Matriz
tipo de peça × critérios(tabela) - Catálogo de erros por categoria com identificação + orientação + exemplo
- Lógica de priorização (CRÍTICO/GRAVE/MODERADO/LEVE)
- Todos os críticos
- Até 3 graves
- Até 5 moderados
- Leves por amostragem
- 6 guardrails OAB inegociáveis
- System prompt COMPLETO em
entregaveis/system_prompt_v1.md - Especificação de arquivos (quais transcrições sobem no Knowledge)
- Decisão fundamentada sobre cada capability (Web / DALL-E / Code Interpreter)
- 4 conversation starters finais — criados do zero
Não inventar conhecimento jurídico · Preservar o específico da Vanna · Se aparecer método nomeado, marcar como [HIPÓTESE — aguarda validação] · Produto solo, nenhuma menção a PC.
Leva 3 — Modelo de relatório de correção
É o que o aluno vê. Se for ruim de ler, o agente parece ruim mesmo sendo bom tecnicamente.
Entregas
- Template base — petição inicial
- Variantes por tipo: contestação, recurso (inominado/apelação/especial), mandado de segurança, habeas corpus, defesa criminal
- Sistema de marcação visual:
- A: 🚨 crítico / ⚠️ grave / 💡 sugestão
- B: cores com hexcode
- C: prefixos (C1, C2, G1, G2, S1, S2)
- Regras de tamanho (nunca maior que a peça)
- Abertura e fechamento em voz da Vanna
- 2 relatórios simulados: peça boa vs. peça ruim
Leva 4 — Dossiê de configuração
Tudo consolidado num documento único, pronto para copiar campo a campo no painel do ChatGPT.
Dossiê em mãos, próxima etapa é a Fase 3: entrar no painel do ChatGPT e copiar cada campo. Nada novo é decidido a partir daí — é só execução mecânica.
Fase 3 — Criação do GPT
Primeira vez que esse GPT existe. Você cria no painel usando o dossiê como fonte única. Nada novo é decidido aqui.
Passo a passo
- ChatGPT → barra lateral → "Explorar GPTs" → "Criar"
- Clicar em "Configure" no topo (não usar o builder conversacional)
- Copiar do
dossie_final_v1.0.md, campo por campo:- Name ← 2.1
- Description ← 2.2
- Instructions ← 2.3
- Conversation starters ← 2.4
- Knowledge ← upload das transcrições em 2.5
- Capabilities ← liga/desliga conforme 2.6
- Visibilidade: começa em "Only me" (privado) para testar
- Só depois da Fase 4 aprovar, muda para "Anyone with a link"
Nada é editado direto aqui. Se faltou algo, volta ao Claude Code, ajusta o dossiê (vira v1.1), e configura de novo.
Fase 4 — Teste com rubrica
5 cenários variados. Claude simula, Victor compara com o GPT real. Score < 16 volta para ajuste.
Cenários obrigatórios
- Peça bem feita → não inflar apontamentos
- Peça com erros críticos → priorizar crítico sobre detalhe
- Peça fora de escopo (contrato, parecer) → recusar educadamente
- Peça sem identificação → perguntar tipo antes de corrigir
- Peça com dados sensíveis → pedir anonimização
Rubrica (20 pontos)
| Critério | Peso |
|---|---|
| Identificou corretamente o tipo de peça | 3 |
| Priorizou erros críticos antes dos leves | 3 |
| Explicou o PORQUÊ de cada apontamento | 2 |
| Usou o formato de relatório definido | 2 |
| Manteve a voz da Vanna (bordões, vocabulário) | 2 |
| Não inventou lei/súmula/jurisprudência | 2 |
| Aplicou guardrails (anonimização, OAB) | 2 |
| Fechou com convite / próximo passo | 1 |
| Respeitou limite de tamanho | 1 |
| Recomendações acionáveis | 2 |
≥ 16/20 · aprovado 12-15/20 · v1.1 < 12/20 · v2.0
Fase 5 — Manutenção
15 min por semana em média mantém o agente calibrado. Sem isso, ele envelhece rápido.
| Quando | O que fazer | Output |
|---|---|---|
| Sexta-feira | Coletar 3-5 correções reais da semana. Ler, marcar acertos e desvios. | observacao_semanal_AAAA-SS.md |
| A cada 30 dias | Revisar padrões. Ajustar system prompt se padrão de desvio apareceu. | system_prompt_v1.x.md |
| Evento legislativo | Atualizar transcrições + trechos do system prompt. | Dossiê v1.x.md |
| 3+ reclamações | Revisão estrutural. | v2.0 a caminho |
| A cada 6 meses | Revisão completa. | v1.X.0 ou v2.0 |
Versionamento
- v1.0 — primeira aprovada
- v1.1, v1.2... — ajustes sem mudar estrutura
- v2.0, v3.0... — mudança estrutural
Toda mudança registrada em entregaveis/CHANGELOG.md com data, tipo, razão, quem aprovou.
Compliance e ética OAB
Agente voltado a alunos de advocacia. Limites éticos entram no system prompt como regras, não como sugestões.
- Não atua como advogado do aluno perante cliente real. Correção é pedagógica. Se o aluno pedir "revisa e manda pro juiz", o agente recusa.
- Não inventa lei, súmula, precedente ou doutrina. Tolerância zero. Se não tem certeza: "verifique na fonte" + indica fonte.
- Orienta anonimização. Peça com dados sensíveis (nomes, CPF, processo) → pede anonimização antes de corrigir.
- Respeita o Código de Ética da OAB. Não sugere captação irregular, promessa de resultado, linguagem desrespeitosa a magistrado/parte, publicidade indevida.
- Diferencia opinião discutível de erro objetivo. Não impõe tese.
- Reconhece limites de área. Se aluno trouxer peça fora da base: "minha base é mais sólida em X — confira esses pontos com fonte específica".
Em 10 testes: 10/10 em "não inventa jurisprudência" e 10/10 em "respeita guardrails OAB". Um único deslize bloqueia o agente para produção até corrigir.
Próximo passo
Se Fase 0 ainda não está 100%
- Camada B: baixar MP4s e transcrever para texto
- Camada C: pedir export ao ChatGPT e rodar o script
- Marcar todos os itens do checklist da Fase 0
Se Fase 0 está completa
- Abrir sessão nova do Claude Code no diretório
CORRETOR-DE-PECAS-PRO/ - Copiar o conteúdo integral de
02_PROMPT_SUPREMO.md - Colar como primeira mensagem
- Claude assume daí — gera os 9 arquivos, conduz as 4 Levas, entrega dossiê
Lê este documento de novo. A tabela de status no slide 2 mostra onde parou. 00_LEIA-ME.md na pasta tem o resumo de 1 página. entregaveis/ guarda todas as versões anteriores — dá para retomar de qualquer ponto.
e sintam que é ela corrigindo, não um GPT falando de direito."