CommunityEscrita e Ediçãogithub.com

shadow-mentor (Conselho de IA on-device para bancos regulados)

Shadow — Conselho de IA e cadeia de auditoria on-device para fluxos bancários regulados. Um motor, 4 clientes de dispositivo, 5 pacotes de persona.

O que é shadow-mentor (Conselho de IA on-device para bancos regulados)?

Shadow Mentor é uma skill de IA projetada para criar um conselho de compliance com cinco vozes para processos de empréstimo regulados, executando inteiramente no dispositivo do usuário sem chamadas de rede. Utilizando o protocolo MCP (Model Context Protocol), ela se integra a ferramentas como Claude Desktop, Cursor, Zed, OpenCode e OpenClaw, oferecendo seis ferramentas MCP que transformam um chat LLM em uma superfície de compliance defensável para originação de crédito. A skill inclui um conselho determinístico de empréstimo que bloqueia pontuações FICO abaixo de 700, ferramentas de risco institucional (VaR, Expected Shortfall, concentração HHI/Gini), memória de sessão, calibração Brier por persona e rastreabilidade de atribuição para regulamentações como CFPB e ECOA. Seu design de três arquivos de código e quatro arquivos de teste garante que a equipe de compras de um banco possa auditar a lógica em minutos, com 308/308 testes passando e um Shadow Agentic Score de 87 ± 3. A skill também defende contra ameaças MCP de 2026, como o advisory OX Security STDIO, o benchmark MCPTox e o vazamento de informações MosaicLeaks, usando um modelo de segurança em camadas com gate de regex e verificação de tokens canários.

Funciona com✓Claude Code~Codex CLI✓Cursor✓Antigravity✓OpenCode
npx skills add alex-jb/shadow-mentor

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

shadow-mentor

Conselho de compliance de IA com 5 vozes para crédito regulado. Integre-se ao Claude Desktop / Cursor / Zed / OpenCode / OpenClaw via MCP. Proposta para bancos de médio porte: US$ 1.800 / assento de oficial de compliance / ano. Código aberto MIT.

O que faz

Seis ferramentas MCP que transformam um chat LLM em uma superfície de compliance defensável para originação de crédito:

  • shadow_loan_council — Veredito determinístico de 5 vozes (bloquear / escalar / aprovar) + justificativa por voz + pacote de risco + limites aplicados. FICO < 700 é um if codificado com um teste fixo.
  • shadow_risk_tools — Primitivas de risco institucional: VaR (histórico / paramétrico / MC), Expected Shortfall, concentração (HHI / Gini), exposição setorial, correlação (Pearson / Spearman / EWMA), exposições a fatores, decomposição beta
  • shadow_recall — Recuperação de memória entre sessões, indexada por persona + cenário
  • shadow_calibration — Estatísticas de calibração Brier por persona (para monitoramento de risco de modelo SR 26-2)
  • shadow_scenarios — Enumeração de superfície (5 personas × 4 cenários × 4 clientes de dispositivo × 2 provedores)
  • shadow_traceability — Atribuição de fonte para qualquer limite (BRD vs Adendo vs Nota de Apetite de Risco) conforme CFPB / ECOA / SR 26-2

Todas as ferramentas são executadas em processo. Nenhuma chamada de rede dentro do corpo da ferramenta. Os códigos de ação adversa AA01–AA05 correspondem ao Boletim CFPB 2024-09.

Por que a equipe de compras de um banco pode fazer grep em 10 minutos

Três arquivos de código + quatro arquivos de teste:

  1. lib/audit-guardrail.js — Gate de saída com regex de 12 padrões (Segurança em Camada de Esquema)
  2. lib/run-loan-council.js — if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... } (Piso de Determinismo)
  3. installer/tools.json — Catálogo de instalação por alvo × escopo (pronto para EMA)

Superfície de teste:

  • test/mcptox-canary.test.js — 28 testes de contrato cobrindo as categorias de ataque MCPTox §3 + cobertura MosaicLeaks
  • test/oauth-scaffold.test.js + test/oauth-loan-council-wiring.test.js — Catálogo de escopo do Enterprise Managed Auth + fiação ativa
  • test/glm-call.test.js — Contrato multiprovedor (Anthropic + GLM-5.2)
  • test/tools-catalog.test.js — Gate de deriva de catálogo

308/308 testes aprovados. Shadow Agentic Score 87 ± 3 (n=6).

Instalação rápida

git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs                          # veja quais hosts MCP são detectados
node bin/install.mjs --host cursor --dry-run  # visualize a configuração mesclada
node bin/install.mjs --host cursor            # escreva-a

Defende-se contra ameaças MCP nomeadas de 2026

  • Advisory OX Security MCP STDIO sobre cadeia de suprimentos (Maio 2026) — Os corpos das ferramentas do Shadow chamam apenas módulos congelados de lib/; nenhuma entrada de shell não confiável atinge o corpo de uma ferramenta
  • Benchmark MCPTox (arXiv 2508.14925) — Shadow retorna vereditos de enumeração JSON estritos, não narrativos; descrições envenenadas não conseguem ampliar a superfície de resposta além do esquema
  • Vazamento de informações em múltiplas voltas MosaicLeaks — testes de contrato com token canário fixam o invariante de que um atacante não pode exfiltrar um canário através do limite da ferramenta
  • OAuth Enterprise MCP (EMA) — SHADOW_REQUIRE_BEARER=1 opcional impõe escopo shadow:council em /api/loan-council; funciona com formatos de declaração OAuth2 / Azure AD

Links

Habilidades Relacionadas