auditoria-cruzada-territorial - SKILL.md Agent Skill

name: auditoria-cruzada-territorial description: Operacionalizar auditoria cruzada de pipeline territorial interno contra instrumento externo qualificado (Tipologia Pentadimensional de Fontes Externas Tipos 1-5), via protocolo P1-P7 dual-ambiente Cowork↔CC, conforme ADR-033 candidata. Use sempre que for necessário cruzar indicadores de um pipeline territorial com instrumento externo reconhecido (IPS Brasil, InfraBr CONFEA, FIETO Estudos, CNI/FIETO Mapa, MGAS Banco Mundial), detectar divergências sistemáticas, corrigir zeros suspeitos, incorporar indicadores órfãos e cristalizar achados em ADR. Trigger quando o usuário mencionar 'auditoria cruzada territorial', 'auditoria IPS Brasil', 'instrumento externo qualificado', 'pipeline TO auditoria', 'Tipologia Pentadimensional', 'ADR-033', 'validação cruzada de pipeline', 'InfraBr CONFEA auditoria', 'FIETO Cadeias auditoria', 'CNI Mapa Estratégico auditoria', 'MGAS Banco Mundial auditoria'. version: 0.1

Auditoria Cruzada Territorial — v0.1

Status: v0.1 (2026-05-11 noite tarde). v1.0 condicionada a (i) D-033 (Cap. tese onde inserir o capítulo metodológico — Cap. 4 ou Cap. 6); (ii) D-034 (IPDT-TO + Eixo 1); (iii) primeira aplicação prospectiva (InfraBr CONFEA, FIETO Estudos, CNI Mapa, ou MGAS Banco Mundial). Documento-âncora: 02-pesquisa-acao/protocolos/protocolo-auditoria-cruzada-territorial.md. Caso fundador: 02-pesquisa-acao/casos-fundadores/auditoria-ips-brasil-pipeline-to-2026-05-11.md.

Quando usar

Esta skill é gatilhada quando o usuário sinaliza intenção de executar auditoria cruzada de um pipeline territorial interno contra um instrumento externo qualificado da Tipologia Pentadimensional. Casos típicos:

Tipo 1 — IPS Brasil 2025 × Pipeline TO (caso fundador 2026-05-11).
Tipo 2 — InfraBr CONFEA × Pipeline TO (TODO prospectivo, dependente de versão municipal do InfraBr).
Tipo 3 — FIETO Estudos Cadeias Produtivas × Pipeline TO Eixos 8+10 (TODO prospectivo).
Tipo 4 — CNI/FIETO Mapa Estratégico × Pipeline TO Eixos 1-10 (TODO prospectivo; protocolo adaptado por instrumento prospectivo sem indicadores históricos).
Tipo 5 — MGAS Tocantins Produtivo × Pipeline TO Eixos 1+4+5+8 (TODO prospectivo; caso paradigmático do framework F-T-{D}-I-C).

Pré-requisitos

Instrumento externo qualificado — verificar 5 critérios da disciplina de seleção (outcome-only, multidimensional, cobertura ≥95%, fonte qualificada, bias declarado). Classificar na Tipologia Pentadimensional (Tipo 1-5).
Pipeline interno auditável — schema explícito (preferencialmente tipado, e.g. TypeScript); ETL inspecionável; cobertura declarada por indicador.
Protocolo dual-ambiente operacional — ADR-010, ADR-018, ADR-019 ratificadas; skill handoff-cowork-cc v1.1+ operacional.
Cap temporal calibrado — 12-18h por ciclo P1-P7 completo, idealmente em janela ≤24h via Aceleração Oportunística.

Protocolo operacional — P1-P7

P1 — Qualificação do instrumento externo (1-2h)

Verificar URL canônica, formato de dados disponível, licença, último ano publicado.
Classificar na Tipologia Pentadimensional (Tipos 1-5). Calibrar protocolo conforme tipo.
Produzir ficha em 06-banco-insights/fichas/INS-XXX-...md (clone doutorado) com bias declarado + limitações estruturais (≥5 itens) + conexão com PS/OE.
Pattern 14 BRSR esperado — verificação empírica de cada referência; refutação de premissas declaradas pelo handoff bem-vinda.

P2 — Mapeamento de pares de indicadores (2-3h)

Para cada indicador do instrumento externo, identificar par candidato no pipeline interno via filtro por fonte comum + matching semântico-manual.
Classificar par em tipologia de 5: duplicata_exata | equivalencia_aproximada | gap_so_externo | gap_so_pipeline | ortogonal_nao_comparavel.
Salvar CSV data/auditoria-externa/mapeamento-{instrumento}-pipeline.csv com justificativa textual em cada linha.

P3 — Cruzamento por unidade territorial (2-3h)

Selecionar 3-5 pares prioritários para Onda 1 (mistura duplicata_exata + equivalencia_aproximada; cobertura ≥95%).
Extrair valores de ambos lados por unidade territorial; aplicar normalização documentada quando aplicável.
Salvar CSV data/auditoria-externa/cruzamento-valores-onda-N.csv (≈ N_pares × N_unidades linhas).

P4 — Detecção de anomalias estatísticas + flags qualitativas (1-2h)

Aplicar limiares de divergência (OK ≤5% < ATENÇÃO ≤15% < INVESTIGAR; LACUNA quando valor ausente em um lado).
Sweep exaustivo do pipeline (N indicadores × todos anos): detectar ≥95% zeros (severidade ALTA), ≥50% zeros ou queda abrupta ≥40pp (MÉDIA).
Salvar JSON data/auditoria-externa/sintese-divergencias.json + sweep-integridade-pipeline.json + relatório docs/auditoria-integridade-pipeline-onda-N.md.

P5 — Refinamento Cowork (Pattern 14 BRSR variante "Cowork-amplia-achado-CC") (1-2h Cowork)

Cowork-pesquisador lê PARECER+RELATÓRIO do CC. Identifica se o achado central é caso de uma família maior.
Registra D-NOVA em decisoes-pendentes.md com expansão. Decide ações (handoff CC complementar + reporte à fonte upstream).

P6 — Correção via handoff CC (Pattern 14 BRSR variante "fundamental" possível) (3-5h CC)

CC executa fact-finding obrigatório (Passo 0 da skill handoff-cowork-cc v1.1) antes de qualquer escrita.
Caso fact-finding refute premissa central do handoff (Pattern 14 BRSR variante "fundamental"), CC documenta no PARECER e reformula plano.
Estratégias de correção típicas:
- Mascaramento via omissão de chave (preserva retrocompat com tipagem TS estrita).
- Remoção de indicadores estruturalmente inviáveis (e.g. 100% zeros em todos os anos = bug upstream total).
- Incorporação de indicadores externos órfãos com campo via_auditoria_externa: true + mediacao_critica permanente.
Branch dedicada + commits sequenciais + merge --no-ff + cleanup + push (autorização explícita do pesquisador).

P7 — Cristalização em ADR + atualização do pipeline + comunicação upstream (1-2h Cowork+CC)

Cowork redige ADR candidata formalizando adoção do instrumento como camada de auditoria.
Cowork+CC atualiza CHANGELOG, README, CLAUDE.md, sumários internos (Pattern 18).
Cowork reporta achados sistêmicos à fonte upstream (issue ou e-mail).
Cowork agenda Onda 2+ da auditoria.

Critérios de qualidade

Pattern 14 BRSR esperado em ≥2 etapas — ausência total é sinal de alerta (CC operou sem fact-finding empírico).
Cap calibrado por bloco (cf. tempos acima); excesso em ≥2 etapas → retroalimentação para handoff-cowork-cc v1.2+.
Honestidade epistemológica — limitações declaradas; achados negativos registrados; falsos positivos documentados.
Verificação multicamadas — quantitativa + estrutural + metodológica.
Staging cross-cutting refs pré-handoff — Cowork verifica empiricamente cada ref antes de fixar premissa (Lei de Ferro #2).

Anti-padrões a evitar

Importar score agregado do instrumento externo como diagnóstico do pipeline — viola ADR-033 candidata. Use o Caminho 3 (propor agregado próprio do pipeline calibrado ao território) quando a lacuna do diagnóstico interno motivar essa tentação.
Tratar zeros literais como dado válido sem verificação empírica — pode mascarar bug upstream (subnotificação SIM/DATASUS no ano-fim; bug estrutural de extração no basedosdados; etc.). Investigar antes de aceitar.
Modificar ETL sem fact-finding — refute premissa do bug ETL via leitura empírica do código antes de tocar. No caso fundador, premissa "bug NaN→0 no ETL" foi falsa empiricamente (Pattern 14 BRSR variante "fundamental").
Inserir null no JSON quando frontend declara Record<string, Record<string, number>> (TS estrito) — quebra silenciosamente operações aritméticas. Use omissão de chave.

Articulação teórica

Camadas (ii)+(iii) do §3.7 anti-tecno-solucionismo do framework F-T-{D}-I-C (ADR-031 ratificada plena 2026-05-08) — a auditoria cruzada operacionaliza empiricamente a defesa estrutural em três camadas articuladas (anti-Bowker & Star direta operacional + anti-Kitchin condicional + condições materiais lat-am).
Caminho 3 da Frente C (não importar scores agregados; propor agregado próprio calibrado ao território) é operacionalização concreta da camada (ii) §3.7.
ADR-033 candidata declara explicitamente: o instrumento externo opera como espelho de auditoria, NÃO como diagnóstico substituto — função NÃO declarada que protege o framework contra captura por instrumento externo.

Referências cruzadas

Documento-âncora (protocolo detalhado): 02-pesquisa-acao/protocolos/protocolo-auditoria-cruzada-territorial.md.
Caso fundador: 02-pesquisa-acao/casos-fundadores/auditoria-ips-brasil-pipeline-to-2026-05-11.md.
ADR-031 (framework F-T-{D}-I-C ratificado pleno): 02-pesquisa-acao/03-dados/adrs/ADR-031-framework-ftdic.md.
ADR-032 (publicação em camadas ratificada plena): 02-pesquisa-acao/03-dados/adrs/ADR-032-publicacao-em-camadas.md.
ADR-033 candidata (IPS Brasil como camada de auditoria externa — em decisions.md ou em arquivo dedicado padrão dual): preserva função NÃO declarada como diagnóstico substituto.
INS-013 (Banco de insights — IPS Brasil): 06-banco-insights/fichas/INS-013-ips-brasil-auditoria-externa-diagnostico-territorial.md (TODO de sincronização entre Cowork-local e clone doutorado).
Tipologia Pentadimensional de Fontes Externas: consolidada 2026-05-09; auto-memory Cowork project_tipologia_pentadimensional_fontes_externas.md (TODO de migração para 02-pesquisa-acao/03-dados/ em sessão Cowork futura).
Skill complementar: handoff-cowork-cc v1.1+ (com Passo 0 Fact-finding obrigatório) — usar para preparação de handoffs Cowork→CC dentro das etapas P5/P6.
Skill complementar: ciclo-completo-ae v2.0 — usar para orquestrar ciclo A→I completo quando a auditoria for parte de plano de incorporação MVP.

TODOs para evolução v0.1 → v1.0

TODO 1 — Aplicar protocolo a primeiro caso prospectivo (InfraBr CONFEA quando versão municipal sair; ou FIETO Estudos Eixos 8+10; ou MGAS Banco Mundial Eixos 1+4+5+8). Revisar protocolo conforme adaptações necessárias.
TODO 2 — Resolver D-033 (Cap. tese — Cap. 4 vs. Cap. 6) e atualizar §7 do protocolo com articulação detalhada com Reflect+IA.
TODO 3 — Resolver D-034 (IPDT-TO + Eixo 1) e atualizar Caminho 3 da Frente C como caso completo (implementação + validação).
TODO 4 — Cross-repo ia-collab-os v2.10 — promover Pattern 14 BRSR (com 3 variantes documentadas), Pattern 18 (CC como curador, 6+ instâncias), Aceleração Oportunística (9+ instâncias), sub-pattern "Triangular Methodological Crystallization" (autorreferência registrada no caso fundador) para confirmados. Handoff CC dedicado posterior — NÃO objeto desta sessão.
TODO 5 — Calibração quantitativa dos limiares 5%/15% em P4 via análise empírica de N≥3 casos prospectivos.

Skill v0.1 produzida por Claude Code em 2026-05-11 noite tarde, sob protocolo ADR-019, sessão CC autônoma de cristalização. Pareada com caso fundador + protocolo (documento-âncora). v1.0 aguarda D-033 + D-034 + primeira aplicação prospectiva.