emidio-trancoso/advocacia-aberta/0-1-criar-protocolo

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):

1. O que ENTRA (os dados que você já tem) → 2. O que SAI (o resultado que

você quer) → 3. O PROCEDIMENTO (o passo a passo que liga um ao outro) — mais as

condições de parada. A entrevista abaixo descobre essas coisas com você.

Instrução

Se o usuário já informou uma ideia de tarefa (ex.: "resumir contratos de locação"), use-a como ponto de partida. Se não informou, comece perguntando pela tarefa.

Conduza como uma conversa, não como um formulário. Faça uma pergunta de cada vez, em linguagem simples, e use as respostas anteriores para fazer a próxima. Se o usuário não souber responder algo, ofereça exemplos e siga em frente — o protocolo pode ser refinado depois.

Passo 1 — A tarefa (o gatilho)

Pergunte:

• "Qual tarefa você repete e gostaria que a IA fizesse por você?"
• "Me dá um exemplo concreto da última vez que você fez isso."

Ouça e devolva em uma frase o que entendeu, para confirmar. Sugira um nome curto em kebab-case para o protocolo (ex.: resumir-contrato, minutar-notificacao, triar-processo-novo).

Passo 2 — O que ENTRA (os dados que você TEM)

Pergunte:

• "Quando você vai fazer essa tarefa, o que você tem em mãos?" (PDFs dos autos,

um contrato, um áudio de reunião, um e-mail do cliente, uma planilha…)

• "Onde isso costuma estar?" (uma pasta do caso, um arquivo solto, um texto colado)
• "Tem algum dado que precisa estar organizado antes?" Se for áudio, aponte

o protocolo transcrever; se for uma pilha de documentos, aponte o protocolo organizar-caso.

Passo 3 — O que SAI (o resultado que você PRECISA)

Pergunte:

• "No fim, o que você quer receber?" (um resumo de 1 página, uma minuta de peça,

uma tabela de prazos, uma lista de riscos…)

• "Em que formato?" (um arquivo .md, uma resposta na tela, uma peça salva em

pecas/…)

• "Como é um resultado bom? E o que tornaria o resultado ruim?" (isso vira as

regras de qualidade do protocolo)

Passo 4 — O PROCEDIMENTO (o passo a passo)

Peça para a pessoa narrar como ela faz hoje, e transforme em passos numerados:

• "Me conta, passo a passo, como você faria isso na mão."
• A cada passo, pergunte o "porquê" quando não for óbvio — o motivo vira instrução

para a IA não errar.

• Identifique pontos onde a IA não pode inventar (números, citações de lei,

jurisprudência, prazos) e onde ela deve conferir na fonte ou perguntar em vez de chutar.

Passo 5 — As condições de parada

Pergunte:

• "Em que situações a IA deve parar e te perguntar, em vez de seguir?" (falta um

documento, um prazo não confere, o pedido está ambíguo…)

• "Como saber que a tarefa terminou bem?"

Essas respostas viram as condições de parada do protocolo — o que impede a IA de completar a lacuna com o provável quando falta base.

Passo 6 — Mostrar o rascunho e confirmar

Antes de salvar, mostre ao usuário um resumo do que o protocolo vai fazer (entra → sai → passos → condições de parada) e pergunte se está certo. Ajuste conforme o retorno. Não gere o arquivo antes da confirmação.

Passo 7 — Gerar o arquivo do protocolo

Crie o arquivo em .agents/skills/<nome-escolhido>/SKILL.md com esta estrutura:

---
name: <nome-em-kebab-case>
description: <1 frase clara em português dizendo o que o protocolo faz e QUANDO usá-lo —
  é por aqui que a IA decide acioná-lo sozinha>
---
 
# <Título amigável>
 
<1-2 frases explicando o objetivo do protocolo.>
 
## Instrução
 
Considere como entrada <o que o usuário informa ao pedir a tarefa, ex.: o caminho da
pasta do caso>. Se a entrada não estiver presente, peça-a antes de continuar.
 
### Passo 1 — <nome do passo>
<o que fazer, em português>
 
### Passo 2 — <...>
<...>
 
## Regras
-<regra de qualidade / o que nunca fazer / quando perguntar em vez de chutar>
-<condição de parada: quando parar e perguntar em vez de seguir>
-Nunca inventar fatos, números, citações de lei ou jurisprudência: usar só o que
  está nos documentos ou em fonte verificada.

Regras ao gerar:

• A description é a parte mais importante: escreva-a pensando em "quando a IA deve

usar isto?". É ela que faz o protocolo ser acionado na hora certa.

• Use caminhos relativos (casos/<caso>/...), nunca caminhos absolutos.
• Linguagem em português, simples. É um procedimento, não código.
• Escreva instruções independentes de fornecedor: use capacidades como "leia o

arquivo" em vez de nomes de ferramentas exclusivos de um agente.

• Se a tarefa se conecta a outros protocolos do kit, referencie-os pelo nome

(ex.: "antes, execute o protocolo organizar-caso"; "depois, use o protocolo revisar-peca").

Depois de salvar, rode:

bash "${CLAUDE_PLUGIN_ROOT:-.}/ferramentas/manutencao/sincronizar-skills.sh"
python3 "${CLAUDE_PLUGIN_ROOT:-.}/ferramentas/manutencao/verificar_compatibilidade.py"

Passo 8 — Explicar como usar

Ao terminar, diga ao usuário:

• "Pronto: criei o protocolo <nome>. No Claude Code, use /<nome>; no Codex,

mencione $<nome> ou peça a tarefa em linguagem natural."

• Se preferir usar sem clonar o repositório, o mesmo SKILL.md pode ser instalado

como skill autônoma no assistente (por exemplo, em Customize → Skills, no claude.ai).

• Sugira testá-lo agora com um exemplo real.
• Lembre que ele pode ser ajustado quando quiser — é só abrir o arquivo

.agents/skills/<nome>/SKILL.md e editar, ou usar o protocolo criar-protocolo de novo para refinar.

Dica de ouro (diga ao usuário se ele travar na ideia)

O melhor primeiro protocolo é uma tarefa chata, repetitiva e bem definida — não a mais impressionante. Exemplos que funcionam bem: resumir uma pilha de documentos novos, montar a linha do tempo de um caso, gerar a minuta de uma notificação padrão, conferir se uma peça citou todas as provas. Comece pequeno; a IA aprende o seu jeito e você expande depois.