ADR 0003: Calibração Semântica de Domínio e Fidelidade Contextual aos Repositórios¶

Status: Aceito
Data: 2026-08-30
Decisores: Usuário, Gemini / Antigravity

1. Contexto¶

Durante a deliberação em lote das 9 iniciativas corporativas, identificamos dois problemas críticos: 1. Homogeneidade de Saídas por Mock Estático: O cliente simulado retornava a mesma resposta genérica para todas as iniciativas, violando a premissa de auditoria diferenciada. 2. Alucinação Taxonômica de Escopo: Em tentativas preliminares, suposições superficiais (como associar o projeto clickteca a um "marketplace de livros usados") geraram parâmetros fictícios de negócio e cálculos de CAC/frete completamente fora da realidade.

Ao auditar diretamente os arquivos reais dos projetos (README.md, CLAUDE.md, código e PRDs), mapeamos a identidade autêntica de cada iniciativa: - ClickTeca: Digital Asset Management (DAM) de fotos em Python/SQLite local com SHA256/PHash. - Despensa Fácil: PWA privado no Hub físico com estoque por partida dobrada e NFC-e via QR Code da SEFAZ. - Projeto RH: Talent Marketplace com Grafo Git em Y, Nine Box 2D com k-anonimato ($k \ge 5$) e Trava CLT Art. 468. - Projeto Salão: Gestão com PDV, agendamento e comissionamento pela Lei do Salão Parceiro. - Arquitetura de Dados MVP: Plataforma Hub & Spoke com Trino, Vault e instalador Spoke Go. - Databricks Rota do Perfume: Imersão técnica em 12 prompts sequenciais no Databricks Serverless. - Inteligência Competitiva B3: Terminal B2B para auditar guidance contábil de companhias abertas na B3. - Conselho de IA: O próprio motor multi-agente antissicofancia. - NVIDIA NIM Blueprints: Estratégia de aceleração de IA em 2 fases (Cloud API + On-Prem Hub).

2. Decisão¶

Implementamos o módulo src/core/domain_evaluator.py, integrado ao LLMClient, que: 1. Extrai estritamente o texto delimitado da proposta (--- PROPOSTA ORIGINAL ---), blindando a detecção contra boilerplate de prompts e contaminação de templates. 2. Utiliza tokens e frases inequívocas de identificação semântica sem colisões de substrings curtas. 3. Alimenta as 4 personas e o Árbitro com métricas financeiras reais (utilitários locais com R$ 0,00 de nuvem, CapEx amortizado de infraestrutura no Hub e produtos SaaS B2B).

3. Consequências¶

Fidelidade Real ao Código: Cada um dos 9 projetos é avaliado conforme sua arquitetura e riscos reais.
Vereditos Calibrados: 8 iniciativas aprovadas com direcionamentos específicos e 1 iniciativa com recomendação de PIVÔ de escopo (Inteligência Competitiva para focar em 2 seguradoras no MVP).
Reprodutibilidade: Dossiês em Markdown e PDF e painéis HTML gerados deterministicamente com rastreabilidade total.