NEXUS Brainstorm Multi-Agente (MAD Engine v3.0)

Plataforma autônoma de deliberação técnica e debate adversarial entre múltiplos agentes de Inteligência Artificial. O NEXUS Brainstorm coloca personas especializadas de IA (Tech Lead, Arquiteto de Software, Cético de Riscos, Especialista em Segurança, QA/Edge Cases, Jurídico e Moderador) para discutir decisões arquiteturais complexas, validar conformidade e convergir matematicamente para um consenso auditável sem loops infinitos.

Resumo técnico

O NEXUS Brainstorm (MAD Engine v3.0) é um orquestrador avançado de debates multi-agente construído em PHP 8.3 e MySQL 8, com interface reativa em Alpine.js e Tailwind CSS. Incorpora 5 camadas anti-loop (SPRT de Wald, Poda RUMAD, Detecção de Impasse por Similaridade de Cosseno, Threshold de Entropia e Hard Caps de Rodadas/Tokens), 10 modos de discussão (ADR, Primeiro Princípios, Estudo de Caso de 12 seções, War Room, Red Team vs Blue Team, etc.), Plenário & Votação formal das IAs, 19+ templates pré-configurados com i18n dinâmico e integração nativa com o AI Hub do NEXUS (OpenAI, Anthropic Claude, Google Gemini, Groq, Ollama e nós satélites OCI).

Escopo executado

• plugin.json: v1.0.0, slug nexus-brainstorm, name "Brainstorm Multi-Agent", categoria "IA & Produtividade", autor "Percio Andrade".
• **Backend Modular (includes/*.php)**:

- includes/api.php: 20+ endpoints REST autenticados via Bearer Token (nx-key-*) para ciclo de vida de sessões, execução de turnos, votação do plenário, memória decisória e templates. - includes/runner.php: Motor de execução de turnos da arena, orquestração de falas, síntese de argumentos e moderação contextual. - includes/antiloop.php: Implementação matemática do algoritmo SPRT de Wald (Sequential Probability Ratio Test) para parada antecipada ao detectar convergência e Poda de Personas Redundantes (RUMAD) economizando até 80% de tokens. - includes/voting.php: Sistema de Plenário e Votação formal onde cada IA emite seu parecer (agree, disagree, neutral), score de concordância (0 a 100%) e justificativa técnica antes do veredito final. - includes/memory.php: Catálogo semântico de decisões passadas com pontuação de relevância e similaridade para impedir que novos debates repitam erros já deliberados. - includes/templates.php: Catálogo bilíngue/trilíngue com 19+ frameworks prontos de engenharia de software, segurança ofensiva, compliance e finanças. - includes/personas.php: Registro de 18+ personas com posturas e vieses cognitivos predefinidos (Linus Torvalds, Nassim Nicholas Taleb, Kelsey Hightower, Mikko Hyppönen, Kevin Mitnick, Carl Sagan, Ada Lovelace, etc.).

• Interface Reativa (views/):

- Live Arena (arena.php): Painel de debate em tempo real com timeline de falas coloridas por persona, métricas em tempo real (Convergência %, Entropia de Shannon, Rodada Atual, Consumo de Tokens), Plenário & Votação e sintetizador de consenso. - Launchpad Hub: Central de início com 4 cartões de ação rápida (Novo Debate, Estudo de Caso 12 Seções, Frameworks & Templates, Histórico). - Histórico de Sessões (sessions.php): Tabela com filtros de status (converged, running, impasse, collapsed), busca textual e paginação. - Templates (templates.php): Grade de modelos pré-configurados com preenchimento assistido de variáveis de contexto. - Memória Decisória (memory.php): Histórico indexado de conclusões e vereditos passados. - Configurações (config.php): Roteamento multi-modelo (IA Fixa, Rotação Aleatória AI Hub, Modelo por Persona), toggles de algoritmos anti-loop e limites de tokens.

• Internacionalização Dinâmica (lang.json): Suporte nativo e completo a Português (pt_BR), Inglês (en_US) e Espanhol (es_ES) em 100% dos botões, tooltips, modais e templates.

Stack e ferramentas

• PHP 8.3 (sem frameworks pesados, strict_types)
• MySQL 8 (tabelas brainstorm_sessions, brainstorm_messages, brainstorm_votes, brainstorm_templates, brainstorm_memory)
• Alpine.js v3 + Tailwind CSS v4.3
• AI Hub & MCP Server (integração direta com LLMs locais e em nuvem)
• Algoritmos de Inferência Bayesiana e SPRT de Wald
• REST API com Bearer Tokens (nx-key-*)

As 5 Camadas Anti-Loop do MAD Engine

1. Wald's SPRT (Sequential Probability Ratio Test): Avalia a razão de verossimilhança cumulativa a cada fala. Quando o nível de concordância atinge o limiar estatístico (A ou B), o debate para automaticamente com veredito de convergência.
2. RUMAD Agent Pruning: Detecta quando uma persona repete argumentos prévios e poda dinamicamente sua participação nas rodadas subsequentes, reduzindo o custo de tokens em até 80%.
3. Detecção de Impasse Semântico: Identifica polarização estéril (ex: duas IAs presas em premissas incompatíveis) e aciona intervenção forçada da persona Moderadora.
4. Monitoramento de Entropia de Shannon: Mede a densidade de nova informação introduzida por turno. Quando a entropia cai abaixo de 0.15, o debate é encaminhado para síntese.
5. Hard Caps de Segurança: Limites estritos de rodadas máximas (1 a 8) e teto de orçamento de tokens por sessão.

Módulos e Subtelas

• 🏟️ Live Arena: Espaço de deliberação ao vivo, execução interativa de turnos, plenário de votação e exportação de ADR/Markdown.
• 📜 Histórico de Sessões: Registro detalhado com busca, telemetria de tokens, status de encerramento e retomada de debates pausados.
• 📋 Templates Pré-Configurados: Biblioteca de 19+ casos práticos (ADR de Banco de Dados, Redução Radical de Custos, Triagem de Vulnerabilidades, Estudo de Caso Oficial NEXUS de 12 seções).
• 🧠 Memória Decisória: Repositório semântico para consulta cruzada de decisões passadas.
• ⚙️ Configurações & AI Hub: Seleção de modelos fixos, cascata de provedores ou modelo dedicado por agente.

Segurança e Governança

• Sanitização rigorosa de entradas com nx_sn_*() e execução segura de queries parametrizadas via PDO.
• Ausência total de dados mockados em produção — chamadas reais a modelos com fallback elegante em caso de indisponibilidade de chave.
• Isolamento por workspace no NEXUS com histórico auditável de cada deliberação.