emidio-trancoso/advocacia-aberta

# Organizar Caso — Sumário dos Documentos

Esta skill orienta o agente a organizar a pilha de documentos de um caso. "Caso" aqui é qualquer conjunto de material jurídico: os autos de um processo judicial, mas também os documentos de um contrato, as peças de uma due diligence, um dossiê de investigação ou os anexos que um cliente enviou.

O resultado é um único arquivo — `casos/<caso>/analise/SUMARIO.md` — que serve de mapa do caso: uma tabela com todos os documentos, quem são as pessoas envolvidas, as datas que importam e quais documentos merecem atenção.

## Instrução

Esta skill funciona em dois modos, conforme o que você tem em mãos. Escolha pelo que o
usuário forneceu; na dúvida, pergunte.

- **Modo repositório** — você trabalha sobre a pasta de um caso no espaço de trabalho
  aberto no agente. Os documentos ficam em `casos/<caso>/autos/` e o resultado é
  gravado em `casos/<caso>/analise/SUMARIO.md`. Use este modo quando o usuário indicar

# Diagnosticar — Forças e Fragilidades do Caso

Esta skill faz um diagnóstico honesto e adversarial de uma matéria jurídica: mapeia, lado a lado, as **forças** e as **fragilidades** da sua posição e da posição contrária (quando houver). Funciona para um litígio, mas também para avaliar a viabilidade de uma tese, os riscos de um contrato ou os pontos fracos de um parecer.

O coração da skill é o espírito **red-team**: atacar a própria posição como se você fosse o adversário. É desconfortável, e é exatamente por isso que dá valor — você descobre os furos antes que a parte contrária (ou o juiz, ou o cliente) os descubra. Cada ponto forte vira algo a blindar com fundamentação; cada ponto fraco vira algo a corrigir ou contornar.

A skill lê o `SUMARIO.md` do caso (produzido pela skill `organizar-caso`) e os
documentos relevantes, e produz o `DIAGNOSTICO.md`.

## Instrução

Esta skill funciona em dois modos, conforme o que você tem em mãos. Escolha pelo que o
usuário forneceu; na dúvida, pergunte.

# Busca de fontes jurídicas — base local

Busca súmulas, jurisprudência em teses e temas repetitivos na base jurídica local e
filtra os resultados relevantes para o caso em discussão.

## Instrução

Considere `<consulta>` o tema ou os termos de pesquisa informados pelo usuário. Se não
houver consulta, peça-a antes de continuar.

Esta skill busca no mesmo acervo (Vade Mecum) por dois caminhos, conforme o que estiver
disponível. Use o primeiro que existir:

- **Modo ferramentas** — quando as ferramentas de busca do Vade Mecum estiverem

# Redigir Peça — do plano à redação

Esta skill é o seu procedimento de escrita jurídica colocado por escrito. Ela transforma o material já organizado do caso em uma peça pronta para revisar — em **duas fases**:

1. **PLANEJAR** — decidir o que dizer: silogismo central, hierarquia das teses e estrutura da peça. O plano é apresentado a você para validação **antes** de qualquer redação.
2. **REDIGIR** — escrever a peça aplicando boa técnica, depois que você aprova o plano.

Serve para **qualquer peça**: petição inicial, contestação, réplica, recurso, contrarrazões, parecer, contrato, notificação extrajudicial, alegações finais, etc. A estrutura se adapta ao tipo.

## Regra-raiz: nunca inventar — leia antes de tudo

Esta é a regra mais importante. Violá-la é pior do que omitir um argumento.

- **Fatos:** só use o que está nos documentos do caso (autos, transcrições, SUMARIO, DIAGNOSTICO). Nunca invente datas, valores, nomes ou acontecimentos.

# Revisar peça — auditoria adversarial

Esta skill é o seu procedimento de revisão escrito em português. Ela lê uma peça já redigida — petição, contestação, recurso, parecer, contrato, notificação, alegações finais, qualquer uma — linha por linha e citação por citação. Confere se cada afirmação de fato está sustentada pelos documentos do caso, se cada citação de lei e de jurisprudência é precisa e existe de fato, se os argumentos são honestos e bem enquadrados, e se há fragilidades que o adversário ou a contraparte exploraria. No final, entrega um relatório claro com os achados priorizados por gravidade e a ação recomendada para cada um.

> Quem redige olha para o argumento que quer defender. Quem revisa olha para a prova e para a fonte. Esta skill executa o segundo papel. Presuma que pode haver erro, confirme tudo por leitura direta da fonte e registre o que está certo com a mesma disciplina com que registra o que está errado.

---

## Como começar

Considere `<arquivo-da-peca>` o caminho relativo do arquivo `.md` informado pelo
usuário. Exemplo: `casos/joao-silva/pecas/contestacao-v1.md`.

Se o caminho não tiver sido informado, peça-o ao usuário. Sem o arquivo, não há o que

# Criar Protocolo — construa o seu primeiro protocolo, sem programar

Esta é a skill que cria outros protocolos. Ela conduz uma **entrevista curta** para
transformar um procedimento que você já faz na cabeça (ou no automático) em um
`SKILL.md` que a IA passa a executar sempre do mesmo jeito.

Um **protocolo** é o seu procedimento escrito em português; a **skill** (`SKILL.md`) é o
formato em que esse protocolo é entregue a um agente de IA. Você não vai programar nada.

A ideia central: **todo trabalho jurídico já é um procedimento.** Você já sabe ler
um processo, montar uma petição, analisar um contrato. Só não escreveu esse caminho
para a IA.

> Todo protocolo responde a três perguntas (a anatomia de qualquer automação):

# Preparar ambiente

A maioria das skills deste kit é texto puro e funciona sem instalar nada. Apenas quatro
skills dependem de programas externos. Esta skill instala esses programas **sob demanda**,
ou seja, só o que for realmente necessário para o que você quer fazer:

- **`transcrever`** (transcrever áudio/vídeo de audiência) precisa do `whisper-cli`, do
  `ffmpeg` e de um modelo de inteligência artificial de voz (um arquivo de cerca de 539 MB).
- **`buscar-fontes`** (busca na base jurídica local) precisa do programa `bun`.
- **`buscar-tjpr`** (busca de acórdãos no portal do TJPR) precisa do programa `uv` com
  Python 3.12. Na primeira busca, ele baixa cerca de 400 MB de um navegador automatizado.
- **`diagramar-peca`** (geração do PDF final) precisa do programa `typst`.

Use esta skill quando uma das skills acima avisar que está faltando uma ferramenta, ou

# Organizar Caso — Sumário dos Documentos

Esta skill orienta o agente a organizar a pilha de documentos de um caso. "Caso" aqui é qualquer conjunto de material jurídico: os autos de um processo judicial, mas também os documentos de um contrato, as peças de uma due diligence, um dossiê de investigação ou os anexos que um cliente enviou.

O resultado é um único arquivo — `casos/<caso>/analise/SUMARIO.md` — que serve de mapa do caso: uma tabela com todos os documentos, quem são as pessoas envolvidas, as datas que importam e quais documentos merecem atenção.

## Instrução

Esta skill funciona em dois modos, conforme o que você tem em mãos. Escolha pelo que o
usuário forneceu; na dúvida, pergunte.

- **Modo repositório** — você trabalha sobre a pasta de um caso no espaço de trabalho
  aberto no agente. Os documentos ficam em `casos/<caso>/autos/` e o resultado é
  gravado em `casos/<caso>/analise/SUMARIO.md`. Use este modo quando o usuário indicar

# Transcrever — Áudio e Vídeo em Texto

Esta skill transforma uma gravação em texto. Serve para **qualquer** gravação:
reunião com cliente, audiência, depoimento, sustentação oral, áudio de WhatsApp,
gravação de consulta ou ligação. O resultado é uma legenda (`.srt`) e uma
transcrição (`.md`) limpa, com a hora de cada fala entre colchetes (`[HH:MM:SS]`)
e um marcador `[?]` no lugar do nome de quem fala.

A transcrição roda **100% no seu computador** (offline). Nenhum áudio sai da sua
máquina — bom para sigilo profissional.

> **Aviso honesto de tempo:** transcrever 1 hora de áudio leva cerca de **15 a 25
> minutos** de processamento. É normal. O computador fica trabalhando esse tempo.

# Diagnosticar — Forças e Fragilidades do Caso

Esta skill faz um diagnóstico honesto e adversarial de uma matéria jurídica: mapeia, lado a lado, as **forças** e as **fragilidades** da sua posição e da posição contrária (quando houver). Funciona para um litígio, mas também para avaliar a viabilidade de uma tese, os riscos de um contrato ou os pontos fracos de um parecer.

O coração da skill é o espírito **red-team**: atacar a própria posição como se você fosse o adversário. É desconfortável, e é exatamente por isso que dá valor — você descobre os furos antes que a parte contrária (ou o juiz, ou o cliente) os descubra. Cada ponto forte vira algo a blindar com fundamentação; cada ponto fraco vira algo a corrigir ou contornar.

A skill lê o `SUMARIO.md` do caso (produzido pela skill `organizar-caso`) e os
documentos relevantes, e produz o `DIAGNOSTICO.md`.

## Instrução

Esta skill funciona em dois modos, conforme o que você tem em mãos. Escolha pelo que o
usuário forneceu; na dúvida, pergunte.

# Busca de fontes jurídicas — base local

Busca súmulas, jurisprudência em teses e temas repetitivos na base jurídica local e
filtra os resultados relevantes para o caso em discussão.

## Instrução

Considere `<consulta>` o tema ou os termos de pesquisa informados pelo usuário. Se não
houver consulta, peça-a antes de continuar.

Esta skill busca no mesmo acervo (Vade Mecum) por dois caminhos, conforme o que estiver
disponível. Use o primeiro que existir:

- **Modo ferramentas** — quando as ferramentas de busca do Vade Mecum estiverem

# Busca de Jurisprudência TJPR

Busca acórdãos no Tribunal de Justiça do Paraná e filtra os relevantes para o caso em discussão.

## Instrução

Considere `<consulta>` o tema ou os termos de pesquisa informados pelo usuário. Se não
houver consulta, peça-a antes de continuar.

---

## Princípios gerais do motor

O motor do TJPR tem comportamento não-óbvio. Regras empíricas que você deve seguir:

# Redigir Peça — do plano à redação

Esta skill é o seu procedimento de escrita jurídica colocado por escrito. Ela transforma o material já organizado do caso em uma peça pronta para revisar — em **duas fases**:

1. **PLANEJAR** — decidir o que dizer: silogismo central, hierarquia das teses e estrutura da peça. O plano é apresentado a você para validação **antes** de qualquer redação.
2. **REDIGIR** — escrever a peça aplicando boa técnica, depois que você aprova o plano.

Serve para **qualquer peça**: petição inicial, contestação, réplica, recurso, contrarrazões, parecer, contrato, notificação extrajudicial, alegações finais, etc. A estrutura se adapta ao tipo.

## Regra-raiz: nunca inventar — leia antes de tudo

Esta é a regra mais importante. Violá-la é pior do que omitir um argumento.

- **Fatos:** só use o que está nos documentos do caso (autos, transcrições, SUMARIO, DIAGNOSTICO). Nunca invente datas, valores, nomes ou acontecimentos.

# Diagramar Peça — Legal Design simples

Pega uma peça já redigida (em `.md` ou texto) e gera um **PDF diagramado** usando
Typst e um template enxuto que acompanha esta skill. Serve para **qualquer peça**:
petição, contestação, recurso, parecer, contrato, notificação extrajudicial,
alegações finais.

## ⚠ Regra absoluta

**Não inventa, não adiciona, não parafraseia.** O conteúdo jurídico é exatamente o que
está na peça original. O que muda é só a forma visual — onde cada trecho fica mais
legível (um destaque, uma citação em bloco, uma linha do tempo). Nunca crie fatos,
números, citações de lei ou jurisprudência que não estejam no texto original.

# Revisar peça — auditoria adversarial

Esta skill é o seu procedimento de revisão escrito em português. Ela lê uma peça já redigida — petição, contestação, recurso, parecer, contrato, notificação, alegações finais, qualquer uma — linha por linha e citação por citação. Confere se cada afirmação de fato está sustentada pelos documentos do caso, se cada citação de lei e de jurisprudência é precisa e existe de fato, se os argumentos são honestos e bem enquadrados, e se há fragilidades que o adversário ou a contraparte exploraria. No final, entrega um relatório claro com os achados priorizados por gravidade e a ação recomendada para cada um.

> Quem redige olha para o argumento que quer defender. Quem revisa olha para a prova e para a fonte. Esta skill executa o segundo papel. Presuma que pode haver erro, confirme tudo por leitura direta da fonte e registre o que está certo com a mesma disciplina com que registra o que está errado.

---

## Como começar

Considere `<arquivo-da-peca>` o caminho relativo do arquivo `.md` informado pelo
usuário. Exemplo: `casos/joao-silva/pecas/contestacao-v1.md`.

Se o caminho não tiver sido informado, peça-o ao usuário. Sem o arquivo, não há o que