Guia de transformação do PJe-Calc Agente para replicar o CalcMACHINE v1.6.1. Use SEMPRE ao implementar ou refatorar o pjecalc-agente: arquitetura 3 camadas, pipeline sentença→.PJC, extração com IA (Claude), automação Playwright JSF, deploy Railway/Docker, SSE, validação. REGRA INVIOLÁVEL: .PJC só pode ser gerado pelo PJe-Calc Cidadão via Playwright — NUNCA gerar nativamente (Python/ZIP/XML). Use também quando a automação falhar e precisar de orientação baseada no CalcMACHINE em produção. Skill orquestradora central que coordena calcmachine-patterns, pjecalc-automator, playwright-jsf-automator e demais skills.
O CalcMACHINE v1.6.1 (SuitePlus/EnsinoPlus) é a prova de que automatizar o PJe-Calc Cidadão de ponta a ponta funciona em produção. Esta skill documenta como transformar o pjecalc-agente para replicar essa arquitetura e esse sucesso, baseando-se na análise completa do CalcMACHINE feita em abril/2026.
O pjecalc-agente precisa deixar de ser um conjunto de scripts avulsos e se tornar um sistema com a mesma disciplina do CalcMACHINE: separação clara de camadas, validação antes de automação, ordem estrita de preenchimento, e tratamento robusto de erros JSF.
O arquivo .PJC só pode ser gerado pelo PJe-Calc Cidadão, executado via automação Playwright.
Gerar .PJC de forma nativa (Python gerando ZIP+XML) é PROIBIDO neste projeto. O motivo é prático e definitivo: o PJe-Calc Institucional (sistema do TRT para inserção do cálculo no processo judicial) somente aceita importação de arquivos gerados pelo próprio PJe-Calc ou PJe-Calc Cidadão, marcando como inválidos quaisquer outros — independentemente de o XML estar sintaticamente correto.
Portanto:
pjc-file-generator neste contextoEsta regra não tem exceções. Código que gere .PJC fora do PJe-Calc é código morto — o arquivo resultante será rejeitado na importação.
O pjecalc-agente deve adotar a mesma separação de responsabilidades do CalcMACHINE:
┌──────────────────────────────────────────────────────────┐
│ CAMADA 1 — FRONTEND │
│ Responsabilidades: │
│ • Receber sentença (texto/PDF upload) │
│ • Exibir formulário de revisão do JSON (HITL) │
│ • Validação client-side (espelha backend) │
│ • Monitor SSE de progresso em tempo real │
│ • NÃO executa automação — apenas observa │
│ Tecnologias sugeridas: React/Next.js ou HTML+JS simples │
└────────────────────────┬─────────────────────────────────┘
│ REST API (JSON)
▼
┌──────────────────────────────────────────────────────────┐
│ CAMADA 2 — BACKEND │
│ Responsabilidades: │
│ • Extração com IA (Claude API, temperature=0) │
│ • Validação completa do JSON │
│ • Persistência (banco de dados) │
│ • Automação SERVER-SIDE (Playwright → PJe-Calc) │
│ • Streaming de progresso via SSE │
│ • Coleta e entrega do .PJC gerado pelo PJe-Calc │
│ Tecnologia sugerida: FastAPI (Python) ou Flask │
└────────────────────────┬─────────────────────────────────┘
│ HTTP (Playwright → localhost:9257)
▼
┌──────────────────────────────────────────────────────────┐
│ CAMADA 3 — PJe-Calc Cidadão (JSF/Tomcat porta 9257) │
│ • JavaServer Faces com ViewState + AJAX │
│ • IDs dinâmicos (j_idt42, javax.faces.ViewState) │
│ • PrimeFaces para dropdowns e calendários │
│ • Única fonte autorizada para geração de .PJC │
└──────────────────────────────────────────────────────────┘
Princípio central: a automação roda no servidor, nunca no navegador do usuário. O frontend é apenas interface de revisão e monitoramento.
O pipeline transforma uma sentença trabalhista em arquivo .PJC pronto para importação:
Sentença (PDF/texto)
│
▼
Fase 1 — Ingestão ............... Extrair texto do PDF/receber texto colado
│
▼
Fase 2 — Extração com IA ........ Claude API → JSON estruturado
│
▼
Fase 3 — Validação + HITL ....... Validar JSON + revisão humana obrigatória
│
▼
Fase 4 — Pré-verificações ....... 6 checks antes de iniciar automação
│
▼
Fase 5 — Automação Playwright ... 9 fases contra PJe-Calc (server-side)
│
▼
Fase 6 — Exportação ............. PJe-Calc gera .PJC → backend coleta e entrega
Cada fase tem seu próprio arquivo de referência detalhado. Consulte-os conforme a