Skip to content

Repository files navigation

/dossie

Transforma a análise de um caso jurídico feita na conversa com uma IA em dossiê estruturado e auditável: tabela de provas rastreável, quadro de requisitos, cronologia, grafo do caso e relatório.

Sem dependências de execução. Não exige pip, servidor, CDN ou biblioteca externa. Funciona no Codex, Claude Code, Claude Desktop, Cowork e ChatGPT.

Construído por Lucas Barkoski, advogado previdenciarista.

Versão 1.3

O plugin distribuído está na versão 1.3.0.

  • índice documental com início, fim, resumo e confiança da identificação;
  • famílias documentais estáveis e tipo normalizado, sem depender de uma enumeração rígida;
  • triagem com procedimento, assunto, questão central, controvérsias, palavras-chave e normas efetivamente invocadas;
  • comandos determinísticos documents e screening no validador CLI;
  • limites incertos preservados como ? ou INCERTA, sem inventar eventos ou páginas.

Recursos da versão 1.2

  • estado persistente e versionado em dossie.json;
  • atualização incremental com IDs estáveis e histórico de alterações;
  • consultas de entidade, caminho, contradições e lacunas;
  • validador determinístico opcional, sem bibliotecas externas;
  • exemplos fictícios completos em Markdown, JSON e HTML offline;
  • testes de regressão para persistência, consultas e segurança.

Melhorias herdadas da versão 1.1

  • origem da conversa separada da fonte probatória em todas as entidades;
  • conflitos preservados, sem escolher automaticamente a última versão;
  • validação de integridade entre tabelas, grafo, cronologia e relatório;
  • proteção do HTML contra conteúdo executável vindo da conversa ou dos autos;
  • controles de acessibilidade e navegação por teclado;
  • barras de requisitos sem transformar quantidade de documentos em chance de êxito;
  • metadados e instruções de instalação para o Codex.

O problema

Você passa uma hora analisando um processo com uma IA. Ao final tem uma conversa longa, cheia de achados bons — e nada que dê para levar para os autos, arquivar ou revisar depois.

Pior: no meio dessa conversa há afirmações sólidas, com página citada, misturadas com afirmações que a IA soltou sem fonte nenhuma. Do jeito que ficam na tela, as duas parecem iguais.

O que ele faz

Lê a conversa e devolve a análise estruturada, separando o que tem lastro do que não tem.

Saída Conteúdo
Índice documental Família, tipo normalizado, evento e página inicial/final, resumo e confiança da identificação
Triagem Procedimento, assunto principal, questão central, controvérsias, palavras-chave e normas citadas nos autos
Tabela de provas Documento, conteúdo concreto, data, titular, localização, qualidade da leitura, o que prova, marcação de conferência
Quadro de requisitos Situação de cada requisito, fatos que o sustentam, lacuna e risco
Cronologia Evento, grau de comprovação, fonte e localização
Grafo do caso Partes, documentos, fatos, requisitos e teses, com as relações afirmadas na conversa
Relatório Texto corrido gerado a partir do que foi estruturado, pronto para copiar ou imprimir
Pendências Três blocos: sem fonte, pendente de leitura, confirmar antes de usar

O princípio

O dossiê não produz conhecimento novo. Ele estrutura o que já existe na conversa.

Nada de inferir data, valor, página ou documento que não foi dito. Quando algo essencial falta, o dossiê mostra a falta — e essa é a sua função mais útil.

Todo fato entra com um de quatro graus:

FATO COMPROVADO         sustentado por documento identificado, com localização
ALEGACAO                afirmado por alguém, sem documento que sustente
INFERENCIA              deduzido do conjunto, com registro de onde
SEM FONTE NA CONVERSA   apareceu na análise e nada diz de onde veio

O quarto grau é o produto. Em teste com um processo real, quatro afirmações caíram nele — todas citações legais que a IA tinha marcado "de memória" e nunca confirmou. A análise parecia sólida nos fatos, e estava; mas as regras jurídicas que sustentavam o quadro de requisitos inteiro estavam penduradas no vazio. O dossiê expôs isso em quatro linhas.

A mesma disciplina vale no grafo: aresta só existe se a relação foi afirmada. Nada de ligar nós por semelhança de tema ou coincidência de data. E clicar num nó abre o painel com a origem — sem isso, grafo é enfeite.

Comandos

/dossie                # dossiê completo
/dossie provas         # só a tabela de provas
/dossie documentos     # índice, limites e classificação dos documentos
/dossie triagem        # classe, assunto e questões do caso
/dossie requisitos     # só o quadro requisito-prova-lacuna
/dossie linha          # só a cronologia
/dossie grafo          # só o grafo do caso
/dossie relatorio      # relatório em prosa
/dossie --md           # forçar saída só em markdown
/dossie --html         # forçar o dossiê visual
/dossie salvar         # persistir em dossie.json
/dossie atualizar      # incorporar apenas mudanças novas
/dossie explicar R1    # explicar entidade e conexões
/dossie caminho D1 T1  # mostrar caminho entre entidades
/dossie contradicoes   # listar conflitos registrados
/dossie lacunas        # listar requisitos e leituras pendentes

Não é preciso preparar nada. Analise o caso normalmente e depois chame o comando ou peça em linguagem natural para organizar a análise como dossiê.

Administrativo e judicial

Serve aos dois. As cinco entidades — parte, documento, fato, requisito, tese — são de litígio em geral.

Administrativo Judicial
Localização página do PDF, ID do anexo evento, ID do documento, folha
Requisito requisito legal do benefício requisito legal + pressuposto processual
Tese tese do requerente, motivo do indeferimento tese de cada polo, fundamento da decisão

Em processo judicial, juízo e perito entram como partes quando produzem ato relevante, e a decisão judicial entra como documento — é fonte de fato como qualquer peça.

O dossiê visual

Um único arquivo HTML, sem nenhuma dependência externa. Abre com duplo clique, funciona offline, renderiza como artifact.

O grafo é desenhado à mão em SVG e JavaScript puro — biblioteca de CDN é bloqueada em artifact e quebra offline. Layout dirigido por forças, calculado na carga.

Sete abas: grafo, índice documental e triagem, provas com busca e filtro, requisitos em barras, cronologia, pendências e relatório com copiar e imprimir.

Tema claro e escuro. Paleta em tons médios, e cor nunca é o único portador de significado — todo estado vem acompanhado de rótulo em texto.

Exemplo completo

O diretório examples/ contém o mesmo caso inteiramente fictício em três formatos:

  • caso-ficticio.md — entrega legível e copiável;
  • caso-ficticio.json — estado canônico persistente;
  • caso-ficticio.html — visual interativo e offline.

Para validar e consultar o exemplo, use Python 3.9 ou superior. O script utiliza somente a biblioteca padrão:

python skills/dossie/scripts/dossie_tool.py validate examples/caso-ficticio.json --html examples/caso-ficticio.html
python skills/dossie/scripts/dossie_tool.py explain examples/caso-ficticio.json R1
python skills/dossie/scripts/dossie_tool.py path examples/caso-ficticio.json D1 T1
python skills/dossie/scripts/dossie_tool.py contradictions examples/caso-ficticio.json
python skills/dossie/scripts/dossie_tool.py gaps examples/caso-ficticio.json
python skills/dossie/scripts/dossie_tool.py documents examples/caso-ficticio.json
python skills/dossie/scripts/dossie_tool.py screening examples/caso-ficticio.json

Instalação

Claude Code

Instale pelo marketplace do próprio repositório:

/plugin marketplace add Barkoski/dossie
/plugin install dossie@barkoski-skills

O catálogo barkoski-skills traz também a skill Advocacia Previdenciária Barkoski, que lê autos e processo administrativo do INSS com rastreabilidade documental — o passo que vem antes do dossiê:

/plugin install advocacia-previdenciaria-barkoski@barkoski-skills

O mesmo catálogo é publicado nos dois repositórios, então /plugin marketplace add Barkoski/advocacia-previdenciaria-barkoski leva ao mesmo resultado.

Quem já instalou uma versão anterior deve atualizar o catálogo e o plugin:

/plugin marketplace update barkoski-skills
/plugin update dossie@barkoski-skills
/reload-plugins

Como alternativa manual, baixe o repositório e copie a pasta skills/dossie para ~/.claude/skills/ (no Windows, C:\Users\SEU_USUARIO\.claude\skills\). Reinicie a sessão.

O resultado final deve ser .claude/skills/dossie/SKILL.md.

Codex

Baixe o repositório e copie a pasta skills/dossie para ~/.codex/skills/ (no Windows, C:\Users\SEU_USUARIO\.codex\skills\). Reinicie o Codex ou inicie uma nova tarefa.

O resultado final deve ser .codex/skills/dossie/SKILL.md. A skill também inclui agents/openai.yaml para nome, descrição e prompt sugerido na interface.

Claude Cowork

Baixe o arquivo dossie.plugin, arraste para uma conversa do Cowork e confirme.

Para gerar o .plugin a partir do repositório: selecione o conteúdo da pasta (.claude-plugin, skills, README.md) — não a pasta que os contém —, compacte e renomeie de .zip para .plugin. O plugin.json precisa ficar na raiz do arquivo compactado.

O fluxo automático do GitHub também gera um pacote dossie-plugin testado a cada atualização.

ChatGPT

Cole o conteúdo de SKILL.md e dos seis arquivos de references/ nas instruções de um GPT personalizado. Depois é só analisar o caso e pedir o dossiê.

Limites

  • Só estrutura o que está na conversa. Não abre processo, não lê PDF, não pesquisa. Para isso existem outras ferramentas; esta entra depois delas.
  • Não confere nada. Toda linha sai marcada para conferência humana. A tabela é roteiro de conferência, não certificado de veracidade.
  • Não decide. Organiza a análise; a conclusão é do advogado.
  • Não busca fora. Nenhum dado do caso sai para serviço externo. O dossiê gerado contém dados sigilosos e deve ser tratado como tal.

Autoria

Lucas Barkoski — github.com/Barkoski. Publicada no catálogo barkoski-skills.

Licença

MIT — ver LICENSE.

About

Transforma a analise de um caso juridico feita em conversa com IA em dossie auditavel: tabela de provas com fonte, grafo do caso, cronologia e relatorio. Nao instala nada.

Resources

Code of conduct

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages