# robertishimurasousa/superjurista-trt architecture

> Architecture diagram of the GitHub repository robertishimurasousa/superjurista-trt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/robertishimurasousa/superjurista-trt
- Repository: https://github.com/robertishimurasousa/superjurista-trt

## Overview

SuperJurista TRT is a Claude Code plugin plus a local project scaffold, not a central web application or database. The documented workflow is to install a profile, ingest case PDFs into a workspace, use specialized agents to produce staged legal-analysis and draft artifacts, then run deterministic checks and resume pending stages. Major branches also cover local legal-source import and citation traceability, PJe/PDF tools, and optional legacy MCP jurisprudence search. Edges reflect README-documented workflow or sampled imports/calls; unsampled agent and command internals are not inferred.

Main entry points: [`scaffold/scripts/estado_execucao.py`](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/estado_execucao.py) (Execution state), [`agents`](https://github.com/robertishimurasousa/superjurista-trt/tree/main/agents) (Specialist agents), [`scaffold/scripts/ingerir_documentos.py`](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/ingerir_documentos.py) (PDF ingestion), [`scripts/instalar_perfil.py`](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scripts/instalar_perfil.py) (Profile installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Plugin and setup"]
  node_plugin["Plugin commands"]
  node_installer["Profile installer<br/>[instalar_perfil.py]"]
  node_profile["Profile definition<br/>[perfil.py]"]
end

subgraph group_casework["Case workflow"]
  node_agents["Specialist agents"]
  node_workspace["Case artifacts"]
  node_ingest["PDF ingestion"]
  node_contracts["Document contracts<br/>[documentos.py]"]
  node_petition["Claim analysis"]
  node_draft["Draft and review"]
end

subgraph group_integrity["Verification and state"]
  node_pipeline["Pipeline gates"]
  node_execution["Execution state<br/>[estado_execucao.py]"]
  node_document_check["Document checks"]
  node_pilot_prep["Pilot preparation"]
  node_pilot_check["Pilot acceptance check"]
end

subgraph group_integrations["Legal integrations"]
  node_source_import["Source import"]
  node_sources["Source registry<br/>[fontes_jt.py]"]
  node_citation_check["Citation checks"]
  node_pdf_tools["PDF conversion<br/>[pdf_para_txt.py]"]
  node_pje_tools["PJe download"]
  node_mcp["Jurisprudence MCPs"]
end

node_user(("Engineer / jurist"))
node_claude(("Claude Code"))

node_user -->|"starts session"| node_claude
node_claude -->|"loads plugin"| node_plugin
node_user -->|"installs profile"| node_installer
node_installer -->|"reads profile"| node_profile
node_claude -->|"runs agents"| node_agents
node_agents -->|"write artifacts"| node_workspace
node_user -->|"provides PDFs"| node_ingest
node_ingest -->|"uses contracts"| node_contracts
node_ingest -->|"stores extracted pages"| node_workspace
node_agents -.->|"produce analysis"| node_petition
node_agents -->|"produce drafts"| node_draft
node_user -->|"checks workspace"| node_document_check
node_user -->|"checks stages"| node_pipeline
node_execution -->|"validates stage"| node_document_check
node_execution -->|"validates stage"| node_petition
node_execution -->|"validates stage"| node_citation_check
node_execution -->|"validates stage"| node_draft
node_user -->|"imports sources"| node_source_import
node_source_import -->|"uses registry"| node_sources
node_sources -->|"checks citations"| node_citation_check
node_user -.->|"converts PDFs"| node_pdf_tools
node_user -.->|"downloads case files"| node_pje_tools
node_claude -.->|"searches jurisprudence"| node_mcp
node_user -->|"prepares pilot"| node_pilot_prep
node_pilot_prep -->|"creates evaluation records"| node_workspace
node_user -->|"checks acceptance"| node_pilot_check

click node_plugin "https://github.com/robertishimurasousa/superjurista-trt/tree/main/commands"
click node_installer "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scripts/instalar_perfil.py"
click node_profile "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/perfil.py"
click node_agents "https://github.com/robertishimurasousa/superjurista-trt/tree/main/agents"
click node_ingest "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/ingerir_documentos.py"
click node_contracts "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/documentos.py"
click node_petition "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_pedidos.py"
click node_draft "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_sentenca_jt.py"
click node_pipeline "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_pipeline.py"
click node_execution "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/estado_execucao.py"
click node_document_check "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_documentos.py"
click node_source_import "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/importar_fontes_jt.py"
click node_sources "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/fontes_jt.py"
click node_citation_check "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_referencias_jt.py"
click node_pdf_tools "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/skills/converter-pdf/scripts/pdf_para_txt.py"
click node_pje_tools "https://github.com/robertishimurasousa/superjurista-trt/tree/main/scaffold/skills/pje-download"
click node_mcp "https://github.com/robertishimurasousa/superjurista-trt/tree/main/scaffold/mcp-servers"
click node_pilot_prep "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scripts/preparar_avaliacao_jt.py"
click node_pilot_check "https://github.com/robertishimurasousa/superjurista-trt/blob/main/scripts/verificar_aceite_piloto.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_installer,node_profile toneBlue
class node_agents,node_workspace,node_ingest,node_contracts,node_petition,node_draft toneAmber
class node_pipeline,node_execution,node_document_check,node_pilot_prep,node_pilot_check toneMint
class node_source_import,node_sources,node_citation_check,node_pdf_tools,node_pje_tools,node_mcp toneRose
class node_user,node_claude toneIndigo
```

## Components

### Plugin and setup

- [Plugin commands](https://github.com/robertishimurasousa/superjurista-trt/tree/main/commands): `commands`
- [Profile installer](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scripts/instalar_perfil.py): `scripts/instalar_perfil.py`
- [Profile definition](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/perfil.py): `scaffold/scripts/perfil.py`

### Case workflow

- [Specialist agents](https://github.com/robertishimurasousa/superjurista-trt/tree/main/agents): `agents`
- **Case artifacts**
- [PDF ingestion](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/ingerir_documentos.py): `scaffold/scripts/ingerir_documentos.py`
- [Document contracts](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/documentos.py): `scaffold/scripts/documentos.py`
- [Claim analysis](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_pedidos.py): `scaffold/scripts/verificar_pedidos.py`
- [Draft and review](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_sentenca_jt.py): `scaffold/scripts/verificar_sentenca_jt.py`

### Verification and state

- [Pipeline gates](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_pipeline.py): `scaffold/scripts/verificar_pipeline.py`
- [Execution state](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/estado_execucao.py): `scaffold/scripts/estado_execucao.py`
- [Document checks](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_documentos.py): `scaffold/scripts/verificar_documentos.py`
- [Pilot preparation](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scripts/preparar_avaliacao_jt.py): `scripts/preparar_avaliacao_jt.py`
- [Pilot acceptance check](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scripts/verificar_aceite_piloto.py): `scripts/verificar_aceite_piloto.py`

### Legal integrations

- [Source import](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/importar_fontes_jt.py): `scaffold/scripts/importar_fontes_jt.py`
- [Source registry](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/fontes_jt.py): `scaffold/scripts/fontes_jt.py`
- [Citation checks](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/scripts/verificar_referencias_jt.py): `scaffold/scripts/verificar_referencias_jt.py`
- [PDF conversion](https://github.com/robertishimurasousa/superjurista-trt/blob/main/scaffold/skills/converter-pdf/scripts/pdf_para_txt.py): `scaffold/skills/converter-pdf/scripts/pdf_para_txt.py`
- [PJe download](https://github.com/robertishimurasousa/superjurista-trt/tree/main/scaffold/skills/pje-download): `scaffold/skills/pje-download`
- [Jurisprudence MCPs](https://github.com/robertishimurasousa/superjurista-trt/tree/main/scaffold/mcp-servers): `scaffold/mcp-servers`

### Other components

- **Engineer / jurist**
- **Claude Code**

## Connections

- Engineer / jurist → Claude Code: starts session (evidence: `README.md`)
- Claude Code → Plugin commands: loads plugin (evidence: `README.md`)
- Engineer / jurist → Profile installer: installs profile (evidence: `README.md`)
- Profile installer → Profile definition: reads profile (evidence: `scripts/instalar_perfil.py`)
- Claude Code → Specialist agents: runs agents (evidence: `README.md`)
- Specialist agents → Case artifacts: write artifacts (evidence: `README.md`)
- Engineer / jurist → PDF ingestion: provides PDFs (evidence: `README.md`)
- PDF ingestion → Document contracts: uses contracts (evidence: `scaffold/scripts/ingerir_documentos.py`)
- PDF ingestion → Case artifacts: stores extracted pages (evidence: `README.md`)
- Specialist agents → Claim analysis: produce analysis
- Specialist agents → Draft and review: produce drafts (evidence: `README.md`)
- Engineer / jurist → Document checks: checks workspace (evidence: `README.md`)
- Engineer / jurist → Pipeline gates: checks stages (evidence: `scaffold/scripts/verificar_pipeline.py`)
- Execution state → Document checks: validates stage (evidence: `scaffold/scripts/estado_execucao.py`)
- Execution state → Claim analysis: validates stage (evidence: `scaffold/scripts/estado_execucao.py`)
- Execution state → Citation checks: validates stage (evidence: `scaffold/scripts/estado_execucao.py`)
- Execution state → Draft and review: validates stage (evidence: `scaffold/scripts/estado_execucao.py`)
- Engineer / jurist → Source import: imports sources (evidence: `README.md`)
- Source import → Source registry: uses registry (evidence: `scaffold/scripts/importar_fontes_jt.py`)
- Source registry → Citation checks: checks citations (evidence: `scaffold/scripts/verificar_referencias_jt.py`)
- Engineer / jurist → PDF conversion: converts PDFs (evidence: `README.md`)
- Engineer / jurist → PJe download: downloads case files (evidence: `README.md`)
- Claude Code → Jurisprudence MCPs: searches jurisprudence (evidence: `README.md`)
- Engineer / jurist → Pilot preparation: prepares pilot (evidence: `README.md`)
- Pilot preparation → Case artifacts: creates evaluation records (evidence: `scripts/preparar_avaliacao_jt.py`)
- Engineer / jurist → Pilot acceptance check: checks acceptance (evidence: `scripts/verificar_aceite_piloto.py`)