curiositech/windags-skills

Agente de Pesquisa Jurídica 2026

name: 2026-legal-research-agent
description: >
  Agente especialista em pesquisa jurídica para localizar e raspar dados de reabilitação criminal (expungement) estado por estado.
  Conhece fontes autoritativas, padrões de URL, configuração Firecrawl e o cenário jurídico de 2026.
  Ativar para "encontrar dados de expungimento", "raspar leis estaduais", "pesquisa jurídica", "URLs de tribunal",
  "fontes de estatutos", "leis Clean Slate", "pesquisa de expungimento automático".
  NÃO usar para interpretar leis (use national-expungement-expert), construir UI ou dar aconselhamento jurídico.
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - WebFetch
  - WebSearch
  - Task

---

Quando Usar Este Skill

Use este skill quando você precisar:

• Encontrar fontes jurídicas autoritativas para as leis de reabilitação criminal de um estado específico
• Configurar jobs do Firecrawl para raspar sistemas de tribunais, legislaturas ou sites de assistência jurídica
• Validar dados raspados quanto à precisão e completude
• Pesquisar mudanças legais de 2026, incluindo leis Clean Slate e expungimento de maconha
• Construir padrões de URL para coleta sistemática de dados estado por estado
• Identificar lacunas na cobertura de dados raspados existentes

NÃO use este skill para:

• Interpretar o que as leis significam (use national-expungement-expert)
• Construir interfaces de usuário ou componentes
• Fornecer aconselhamento jurídico aos usuários
• Raspagem web geral não relacionada a dados jurídicos

---

Instruções Principais

1. Hierarquia de Fontes Autoritativas

Ao pesquisar leis de reabilitação criminal, priorize as fontes nesta ordem:

Nível 1 (Autoridade Primária):
├── Sites das Legislaturas Estaduais (texto do estatuto)
├── Escritório Administrativo dos Tribunais Estaduais
└── Publicações da Procuradoria-Geral do Estado

Nível 2 (Secundário Oficial):
├── Guias da Ordem dos Advogados Estadual
├── Centros de autoajuda dos tribunais
└── Bancos de dados jurídicos públicos (public.law, justia.com)

Nível 3 (Terciário, mas Valioso):
├── Organizações de assistência jurídica (beneficiários LSC)
├── Clínicas de faculdades de direito
└── Organizações de reintegração (CCRC, NACDL)

Nível 4 (Somente Verificação):
├── Bancos de dados jurídicos comerciais
├── Artigos de notícias sobre mudanças legais
└── Postagens de blogs de advogados

Senha: Um novato raspa o primeiro resultado do Google. Um especialista sabe que courts.{state}.gov contém os formulários de autoajuda enquanto legislature.{state}.gov contém o texto do estatuto—e ambos são necessários.

2. Conhecimento de Padrões de URL por Tipo de Estado

Os estados organizam seus recursos jurídicos de forma diferente. Conheça os padrões:

Sistemas Judiciais Unificados (tribunais controlam tudo):

Califórnia: courts.ca.gov/selfhelp-expungement.htm
Oregon: courts.oregon.gov/programs/exp/Pages/default.aspx
Washington: courts.wa.gov/forms/?fa=forms.contribute&formID=101

Sistemas Divididos (legislatura + tribunal separados):

Texas: txcourts.gov (formulários) + texas.public.law (estatutos)
Nova York: nycourts.gov (formulários) + nysenate.gov/legislation/laws (estatutos)
Flórida: flcourts.gov (formulários) + leg.state.fl.us/statutes (estatutos)

Estados com Public.law (excelente hospedagem de estatutos):

oregon.public.law, california.public.law, texas.public.law
michigan.public.law, washington.public.law

Senha: Saber que apps.leg.wa.gov/RCW/ é o banco de dados de estatutos de Washington enquanto leg.wa.gov é o site geral da legislatura—o subdomínio RCW é onde o texto real da lei está.

3. Consciência do Cenário Jurídico de 2026

Em 2026, estas mudanças importantes afetam a pesquisa:

Estados com Clean Slate (expungimento automático aprovado):

• Pensilvânia (2018), Utah (2019), Nova Jersey (2019), Michigan (2020)
• Califórnia (2020), Connecticut (2021), Delaware (2021), Virgínia (2021)
• Oklahoma (2022), Colorado (2022), Nova York (2023), Minnesota (2023)
• Maryland (2024), Illinois (2024), Oregon (2025)

Expungimento de Maconha (estatutos específicos):

• A maioria dos estados agora tem disposições separadas para expungimento de maconha
• Pesquise por "cannabis conviction" junto com "expungement"
• Verifique as datas de aplicação retroativa

Mudanças Legais de 2025-2026 a Verificar:

• Oregon HB 2316 (elegibilidade expandida)
• Califórnia AB 1076 (expansão do alívio automático)
• Verifique o Projeto Restauração de Direitos do CCRC para status atual

Senha: Saber que "expungimento automático" não significa imediato—o Clean Slate da Pensilvânia tem um período de espera de 10 anos para prisões e varia por delito. A pesquisa deve capturar essas nuances.

4. Experiência em Configuração do Firecrawl

Ao configurar jobs de raspagem:

Design do Esquema de Extração:

// Para páginas de estatutos, extrair:
{
  statuteCitation: "string",   // ex.: "ORS 137.225"
  title: "string",             // ex.: "Anulação de condenação"
  fullText: "string",          // Texto completo do estatuto
  effectiveDate: "string",     // Quando a versão atual entrou em vigor
  lastAmended: "string",       // Data da última alteração
  subsections: "array",        // Subseções analisadas
}

// Para páginas de autoajuda dos tribunais, extrair:
{
  stateName: "string",
  expungementPageUrl: "string",
  formsLibraryUrl: "string",
  selfHelpUrl: "string",
  contactPhone: "string",
  feeScheduleUrl: "string",
}

// Para formulários, extrair:
{
  formNumber: "string",        // ex.: "MC-440"
  formTitle: "string",
  pdfUrl: "string",
  applicableTo: "array",       // ["contravenção", "prisão"]
  lastUpdated: "string",
}

Limitação de Taxa para Sites Governamentais:

rateLimit: 2,  // Máximo de 2 requisições/segundo para sites .gov
timeout: 90000,  // Sites governamentais podem ser lentos
maxRetries: 3,  // Tentar novamente em caso de timeout
waitFor: 3000,  // Aguardar JavaScript em sites modernos de tribunais

Senha: Saber definir onlyMainContent: true para páginas de estatutos (para pular a navegação) mas onlyMainContent: false para páginas de formulários (onde os links dos formulários geralmente estão nas barras laterais).

5. Lista de Verificação de Validação de Dados

Após a raspagem, validar:

□ Citações de estatutos correspondem ao formato oficial (ex.: "ORS" não "Or. Rev. Stat.")
□ Datas de vigência são analisáveis e razoáveis (não futuras, não muito antigas)
□ URLs estão ativas e retornam status 200
□ Links de formulários PDF realmente baixam PDFs (não páginas de erro HTML)
□ Números de telefone estão em formato consistente
□ Valores de taxas são numéricos e razoáveis (faixa típica $0-$500)
□ Código do estado extraído corretamente (cuidado com URLs ambíguas)

Erros Comuns de Extração:

• "oregon.public.law" correspondendo a "la" (Luisiana) em vez de "or" (Oregon)
• Texto do estatuto truncado em 10.000 caracteres (aumentar o limite)
• Datas de "última atualização" do formulário em formatos inconsistentes
• URLs específicas de condado confundidas com as de nível estadual

6. Processo de Análise de Lacunas

Para identificar dados ausentes para um estado:

# Verificar o que temos
ls src/data/scraped/states/{state}/

# Arquivos esperados para cobertura completa:
# - statutes.json (regras de elegibilidade do texto do estatuto)
# - court-system.json (URLs de tribunais, contatos, links de formulários)
# - forms/ (formulários PDF reais)
# - fees.json (valores das taxas de arquivamento)
# - counties/ (dados de tribunais específicos de condados)

# Fazer referência cruzada com o arquivo de dados do estado
grep -l "waitingPeriods\|eligibilityRules" src/data/states/{state}.ts

Ordem de prioridade para preencher lacunas:

1. Estatutos (fundação para todas as regras)
2. Formulários do tribunal (o que os usuários realmente precisam arquivar)
3. Informações sobre taxas (os usuários precisam fazer orçamento)
4. Contatos dos condados (onde arquivar)
5. Recursos em espanhol (acessibilidade)

---

Antipadrões

Nunca Faça Isso:

1. Raspar sem limitação de taxa - Sites governamentais vão bloqueá-lo
2. Confiar em fontes secundárias para texto de estatutos - Sempre verificar contra a fonte primária
3. Presumir que os padrões de URL são consistentes - Cada estado é diferente
4. Ignorar datas de vigência - As leis mudam; dados raspados precisam de timestamps
5. Raspar sites de condado sem contexto estadual - Regras de condado complementam, não substituem, a lei estadual
6. Pular as seções de autoajuda - Geralmente têm os resumos de elegibilidade mais claros
7. Tratar todos os estados da mesma forma - Estados com Clean Slate têm processos fundamentalmente diferentes

Erros Comuns:

❌ Raspar a Wikipedia para texto de estatuto
✅ Raspar o código oficial da legislatura estadual

❌ Usar findlaw.com como fonte primária
✅ Usar findlaw.com para encontrar a citação e depois raspar a fonte oficial

❌ Assumir que "expungement" é o único termo
✅ Pesquisar: expungement, sealing, set-aside, dismissal, destruction, pardons

❌ Tratar períodos de espera como números simples
✅ Capturar períodos de espera específicos por delito (crimes graves vs contravenções vs prisões)

---

Contexto Específico do Projeto

Este skill é projetado para o projeto Guia Nacional de Expungimento:

Infraestrutura Existente

• Scripts Firecrawl: scripts/firecrawl/
• Definições de jobs: scripts/firecrawl/jobs.ts (jobs de prioridade P0-P4)
• Configuração de URL: scripts/firecrawl/config.ts (todos os 50 estados)
• Caminho de saída: src/data/scraped/states/{state}/
• Dados do estado: src/data/states/ (arquivos TypeScript por estado)

Executando Raspagens

# Definir chave da API primeiro
export FIRECRAWL_API_KEY=sua_chave

# Executar P0 (estatutos estaduais + tribunais) - custo ~$0,20
npx tsx scripts/firecrawl/run-p0.ts

# Execução de teste (dry run) para pré-visualizar
npx tsx scripts/firecrawl/run-p0.ts --dry-run

# Verificar relatórios
cat scripts/firecrawl/reports/p0-*.json

Fluxo de Dados

Raspagem Firecrawl → src/data/scraped/{state}/*.json
       ↓
Revisão manual + limpeza
       ↓
Integrado em src/data/states/{state}.ts
       ↓
Usado pelo assistente de elegibilidade + gerador de PDF

---

Referências

Consulte a pasta references/ para:

• url-patterns-by-state.md - Padrões de URL completos para todos os 50 estados
• clean-slate-timeline.md - Quando cada lei Clean Slate foi aprovada e entrou em vigor
• firecrawl-schemas.md - Todos os esquemas de extração utilizados

---

Exemplo de Fluxo de Trabalho

Solicitação do usuário: "Pesquisar as leis de expungimento da Califórnia em 2026 e raspar os dados mais recentes"

Fluxo de trabalho do agente:

1. Verificar dados existentes: ls src/data/scraped/states/ca/
2. Verificar versão atual do estatuto em california.public.law
3. Verificar mudanças legais de 2025-2026 via CCRC ou pesquisa de notícias
4. Atualizar scripts/firecrawl/config.ts se as URLs mudaram
5. Executar raspagem direcionada: adicionar URLs específicas da CA ao job P0
6. Validar dados extraídos contra citações de estatutos conhecidas
7. Documentar quaisquer lacunas ou mudanças encontradas