Arquitetura para agentes jurídicos
Dia de estudar um projeto de detecção e estruturar documentação, arquitetura, Docker e decisões para extração de citações.
O dia foi centrado em entender e estruturar um projeto de agentes para análise de documentos jurídicos. Antes de codar mais, precisei deixar a arquitetura explicável.
Base do projeto
Comecei lendo o repositório, identificando a stack e criando documentação de orientação para agentes. O projeto ganhou AGENTS.md, CLAUDE.md, diagramas em Mermaid, visão de design system e uma descrição mais clara da comunicação entre backend, frontend e agentes.
Também preparei uma estrutura de Docker para rodar backend e frontend com portas separadas. A ideia era reduzir o custo de entrada: qualquer agente ou pessoa precisa conseguir subir o sistema, entender as peças e saber onde mexer.
Extração de citações
O tema técnico principal foi extração de citações em documentos. A pergunta não era só "como usar um agente", mas onde o código determinístico deve entrar. Para grande volume, padrões previsíveis precisam ser tratados com parsing, validação e testes. O agente pode ajudar em casos ambíguos, mas não deve ser a primeira ferramenta para tudo.
Também comecei a transformar a intenção do produto em PRD e especificação. Isso ajudou a separar objetivo, arquitetura e tarefas.
Foi um dia bom para lembrar que agentes trabalham melhor quando o projeto já tem mapa, fronteiras e vocabulário comum.