Arquitetura Cognitiva Multiagente — Pipeline Científico Integral + On-Device LLM
Uma arquitetura cognitiva completa que integra 205 agentes especializados, Pipeline Científico Agentivo, Motor de Inferência MoE Local via Colibri (OLMoE 1B/7B) em C nativo, Autocorreção em Circuito Fechado (Diagnóstico → Correção → Validação RED-GREEN → CORRIGENDUM.md), Guardião de Integridade Merkle Tree, Internal Audit Harness com Assinatura SHA-256, SuperRigor Pipeline (scanners epistemológicos), 6 Servidores MCP, Camada Epistêmica de Roteamento e Guardas de Tradução Cultural (R363–R369), e 186 ciclos de evolução contínua.
Ressalvas sobre métricas e alegações: consulte
CORRIGENDUM.md.
"A verdadeira ciência não nasce do acerto fortuito, mas da capacidade inabalável de colocar hipóteses à prova, autocorrigir falhas em circuito fechado e provar a integridade de cada linha de código com rigor imutável."
No início, o mundo dos agentes autônomos era fragmentado. Dezenas de agentes atuavam de forma isolada, gerando código e pesquisas sem alinhamento epistemológico ou garantias de reprodutibilidade. O desafio era monumental: Como construir um ecossistema inteligente em que 205 agentes trabalhem em harmonia, com governança metacognitiva e custo zero de tokens locais?
Dessa necessidade nasceu o orquestrador primário MarceloClaroOrchestrator e o motor de inferência local Colibri Engine (baseado em OLMoE 1B/7B em C nativo com otimização CIL e Lazy Auto-Start na porta 8090). O ecossistema passou a operar com autonomia local, reduzindo a dependência de APIs externas e realizando roteamento inteligente de modelos via ModelRouter.
Para eliminar alucinações e alegações infundadas, o ecossistema evoluiu com a Regra Anti-Overclaim (Regra 4 do AGENTS.md) e introduziu o SelfCorrectionEngine (Diagnóstico → Correção → Validação RED-GREEN via SpecVerifier → Registro transparente no CORRIGENDUM.md). Em seguida, nasceu o SuperRigorPipeline, unificando 8 scanners rigorosos (Falsificabilidade Popperiana, Análise de Falácias Epistemológicas, Viés Social, Requisitos Regulatórios e Cobertura Epistemológica).
Para garantir que a integridade do ecossistema não fosse apenas declarativa, mas matematicamente comprovável, foram criados o MerkleIntegrityGuard (gerando a Merkle Root SHA-256 de todos os arquivos do código-fonte) e o InternalAuditHarness (emitindo certificados digitais imutáveis). Agora, o agente orquestrador /marceloclaro audita, valida e certifica qualquer entrega com um único comando (audit_and_certify()).
Hoje, o OpenCode Ecosystem Core é uma fortaleza de rigor acadêmico e tecnológico, totalmente interoperável através de 6 Servidores MCP (litert-lm, metacognitive-interconnect, antigravity-bridge, pypi-search, colibri-mcp e scanners-mcp). Ele se conecta ao Claude Code, Antigravity CLI, VS Code e terminais remotos, servindo como uma verdadeira Universidade de Pesquisa Autônoma e Auditável rodando localmente na sua máquina.
Os 6 servidores estão registrados em
opencode.json(chavemcp) com esses nomes exatos — verificável compython3 -c "import json; print(list(json.load(open('opencode.json'))['mcp']))".
A última fronteira foi ensinar o roteamento a reconhecer o tipo de conhecimento por trás de cada tarefa — 6 regimes epistemológicos que dão peso brando ao match agente↔tarefa sem nunca excluir um candidato — e a vigiar honestamente a internacionalização editorial: um grafo terminológico que só humanos aprovam, um guardião da voz autoral, um verificador de retrotradução e um benchmark medido em corpus interno (nunca uma meta anunciada). Nasceu também a ponte entre os motores de raciocínio e a produção de artigos e obras literárias: toda alegação de "inédito" ou "inovador" agora exige ancoradouro de comparação na mesma frase — novidade se argumenta, não se decreta.
Imagine que você tem uma universidade inteira de pesquisa científica trabalhando 24h/dia dentro do seu computador:
- Pesquisador-Chefe (EvoSci): Gera hipóteses, decompõe problemas, coordena descobertas
- Deep Researcher: Explora milhares de artigos, constrói grafos de evidência, sintetiza conhecimento
- Revisor (Peer Review): Avalia com rubricas multi-dimensionais, detecta fraudes, audita evidências
- Editor (Paper Composer): Organiza, escreve e formata artigos completos em ABNT/APA/IEEE
- Revisor de Manuscrito (Revision Agent): Aplica correções, gera cartas de rebuttal, gerencia diffs
Você dá uma ordem como "Pesquise o impacto de ética quântica em IA" e o ecossistema orquestra dezenas de agentes especializados, testa rigorosamente (TDD), audita a qualidade (SDD gates) e entrega um artigo completo com revisão por pares embutida.
O OpenCode Ecosystem Core é uma implementação modular de sistemas multiagentes (MAS) com metacognição, governança científica, pipeline acadêmico fechado e infraestrutura de qualidade profissional.
Diferenciais arquiteturais:
- Pipeline Científico Fechado (R101→R105): Do problema à entrega do artigo — EvoSci (descoberta) → Deep Research (evidência) → Peer Review (avaliação) → Revision (correção) → Paper Composer (publicação)
- Fusão e loop científico (R108–R109):
scientific_discovery_pipeline()aplica o gate real do R103, calibra a confiança do próprio run e expõe estados terminais nomeados no loop de descoberta. - Raciocínio auditável (R113–R115): detector heurístico de falácias e vieses, ARCHE RLT com seis tipos de Peirce e revisão às cegas com anonimização, verificação de vazamento e conflito de interesse.
- Interfaces de produção (R116/R120): instalação multiplataforma, helpdesk, pesquisa acadêmica no CLI e fallback opcional de download visível no diagnóstico.
- Apresentações MIRA (R123–R126): manuscrito → deck HTML animado autocontido, com caminho direto, agente delegável
mira-presentere documentação em registros Leigo e PhD. - Evolutionary Memory (R97): Memória persistente de ideias, experimentos, estagnação e reflexão periódica
- Evidence Graph (R102): Grafo epistemológico de entidades, relações e evidências com proveniência
- MCP Security (R100): Guard model, audit trail, vetting de comandos e rate limiting
- CI/CD Quality Gates (R106): GitHub Actions com lint, matrix test e package build
Se você usa Windows 10/11, o instalador configura WSL2, Ubuntu, OpenCode CLI, Antigravity CLI, Claude Code CLI, Ollama e o ecossistema:
Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://raw.githubusercontent.com/MarceloClaro/opencode-ecosystem-core/main/installer/windows/Install-OpenCodeEcosystem.ps1 | iex(Para Linux nativo e macOS, veja o Guia de Instalação. Manual de uso: MANUAL.md.)
O ecossistema é organizado em 14 camadas interconectadas:
Barramento de eventos (Global Workspace) onde agentes compartilham memória, confiança calibrada e reflexões pós-execução. Inclui MetaBus (pub/sub), Blackboard (protocolo A2A), memória hierárquica e Reflexion middleware.
Pipeline fechado de 5 estágios que transforma um problema em artigo publicado:
[Problema]
↓
┌─ R101: AGENTIC SCIENCE V2 (EvoSci) ─────────────────┐
│ MentorAgent → PrimeResearcherAgent → ReviewerAgent │
│ → EvolutionManagerAgent → Evolutionary Engine │
│ (Selection → Crossover → Mutation → Inheritance) │
└──────────────────────────────────────────────────────┘
↓
┌─ R102: DEEP RESEARCH AGENT ─────────────────────────┐
│ EvidenceGraph (Entity/Relation/Evidence) │
│ BFRSAgent (exploração larga) │
│ DFRSAgent (cadeias multi-hop) │
│ OrchestratorAgent (planejamento + gate + síntese) │
└──────────────────────────────────────────────────────┘
↓
┌─ R103: AGENTIC PEER REVIEW ─────────────────────────┐
│ RubricEngine (8 meta-dimensões) │
│ ReviewLedger (claim-evidence-risk) │
│ AuditGraph (integrado R102) │
│ MultiCriticReviewer (4 especialistas) │
└──────────────────────────────────────────────────────┘
↓
┌─ R104d: AGENTIC MANUSCRIPT REVISION ────────────────┐
│ ReviewAnalyzer → SectionMapper → ProposalGenerator │
│ DiffEngine (com rollback) → RebuttalLetter │
└──────────────────────────────────────────────────────┘
↓
┌─ R105: AGENTIC PAPER COMPOSER ──────────────────────┐
│ StructurePlanner (ABNT/APA/IEEE) │
│ SectionWriter (6 seções) │
│ CitationFormatter (3 estilos) │
│ CrossConsistencyVerifier (5 verificações) │
└──────────────────────────────────────────────────────┘
↓
[Artigo Completo + MCP Tools + Skills Exportáveis]
Cada estágio possui spec formal (SDD), testes TDD, gate de qualidade e registro no EvolutionRegistry.
Pipeline científico com governança ética: OQS → HypothesisEngine → ExperimentDesigner → StatisticalValidator → AdversarialReviewer → ConfidenceCalibrator → VSEE → EGS → EvidenceGraph. Inclui Scientific RAG com grounding, citações auditáveis e abstenção.
Roteador de atenção (Multi-Head Attention com 4 cabeças: semântica, capacidade, confiança, carga), pipeline iterativo Gerar→Verificar→Revisar e memória hierárquica com Episodic Replay.
- Token Economy: Staking/slashing para agentes
- Trust Engine: Behavioral gates com confidence ledger
- SDD/TDD: SpecRegistry, SpecVerifier, TDDRunner
- MCP Security (R100): MCPGuard, AuditLogger, ToolVetter, RateLimiter
- CI/CD (R106): GitHub Actions, quality report, coverage gate
205 agentes especializados (contagem medida pelo doctor em 2026-08-02): Researcher, Coder, Reviewer, Academic Writer, 32 agentes MASWOS, Deep Research, Peer Review, Revision, Paper Composer, LLM Reduction, Colibri/OLMoE, GameTheory, Jinja2, DataKnowledgeHub, e especialistas jurídicos, de design e quânticos.
Esta tabela é gerada a partir do catálogo real (marceloclaro.catalog_loader.load_catalog_definitions()), não é uma lista escrita à mão — toda Descrição vem do próprio agent card, e toda Camada vem da Camada Epistêmica de Roteamento já implementada (R363/R368: transformer/episteme.py), que classifica cada agente em um de 6 regimes epistemológicos por inferência determinística sobre category/type/tags/nome — nunca chuta: sem sinal lexical suficiente, a camada fica em branco (—).
Transparência sobre os números: dos 205 registros carregados, 3 são artefatos não-agente (ver último grupo da tabela-resumo) — o catálogo real de agentes funcionais é 202. A camada epistêmica cobre 133/205 (65%) — os 72 restantes (35%) aparecem como — porque a heurística lexical não encontrou sinal suficiente nos metadados; isso não significa que o agente seja pior, só que a inferência automática não tem base para classificá-lo (ver Seção 8 para o critério exato).
Achado de auditoria e correção aplicada (SPEC-935-R380): ao gerar esta tabela pela primeira vez, 103 dos 205 registros (50%) tinham description placeholder mecânico ("Agente especializado NOME") com corpo apontando para um caminho Windows externo inexistente neste checkout. Os 46 agentes do grupo Catálogo Acadêmico MASWOS (00–53) já foram corrigidos: conteúdo real (missão, entradas, saídas, workflow) portado de um repositório-fonte confirmado, nunca fabricado — ver specs/SPEC-935-R380-maswos-catalog-enrichment.md. 57 registros ainda têm o placeholder (família reversa-* com fonte real localizada mas ainda não portada, auxjuris_*, ferramental de desenvolvimento genérico, médicos, e os 3 artefatos não-agente) — candidatos a um ciclo futuro (R375+). Para esses casos, a coluna Descrição traz um rótulo derivado mecanicamente do identificador (nunca uma descrição inventada), marcado explicitamente.
| Grupo | Quantidade | Camada predominante | Propósito |
|---|---|---|---|
| Catálogo Acadêmico MASWOS (00–53) | 46 | Empírico-analítico | Pipeline completo de redação científica: diagnóstico, busca, escrita, estatística, revisão cega e submissão Qualis A1 — um agente por etapa do método científico. |
| Reversa (Engenharia Reversa de Sistemas Legados) | 28 | Pragmático-técnico | Analisa um sistema de software legado e gera especificações executáveis por IA — do código nu ao contrato reproduzível. |
| Engenharia & Ferramental de Desenvolvimento | 28 | Pragmático-técnico | Suporte a desenvolvimento de software: arquitetura, revisão de código, debugging, DevOps, CI/CD e gestão de tarefas. |
| Apresentações MIRA (R123–R126) | 22 | Pragmático-técnico | Transforma um manuscrito em deck de slides animado autocontido — da extração de seções à validação de conformidade. |
| Ferramentas Determinísticas & Inferência Local | 16 | Pragmático-técnico | Motores zero-token (Colibri/OLMoE, LiteRT-LM, redução de LLM) e utilitários determinísticos que substituem chamadas de LLM quando possível. |
| Pesquisa & Redação (Workspace agents) | 12 | Pragmático-técnico | Busca, localiza e sintetiza informação — de código-fonte a literatura externa — para alimentar outros agentes com contexto verificado. |
| Literário (Molambudos / OpenCode Books) | 11 | Hermenêutico-interpretativo | Especialistas em voz autoral, psicologia de personagem, simbolismo, ética da representação e trauma para obras literárias. |
| Cloud & Infraestrutura de Dados | 8 | Pragmático-técnico | Especialistas em bancos de dados gerenciados (BigQuery, AlloyDB, Cloud SQL) e pipelines de dados na nuvem. |
| Publicação KDP / Editorial | 7 | Pragmático-técnico | Prepara um manuscrito para publicação real na Amazon KDP: capa, miolo, metadados/ISBN, preflight e QA final. |
| Guardas de Tradução Cultural (R359, R364-R366) | 4 | Hermenêutico-interpretativo | Gate fail-closed de internacionalização editorial PT-BR/EN/ZH-CN — equivalência cultural, terminologia, voz autoral e retrotradução. |
| Orquestradores Meta | 6 | Pragmático-técnico | Camada de controle de mais alto nível — coordenam outros agentes/orquestradores (o próprio /marceloclaro está aqui). |
| Médico Virtual Supremo | 6 | Empírico-analítico | Apoio clínico auditável multi-especialidade (clínico geral, cardiologia, infectologia, neurologia, radiologia) — nunca substitui médico humano. |
| Jurídico (AuxJuris) | 4 | Regulatório-normativo | Assistência jurídica auditável: pesquisa, resumo de documentos, redação de e-mails e assistência legal geral. |
| Outros / Utilitários | 4 | Pragmático-técnico | Agentes que não se encaixam nos grupos acima — utilitários pontuais e o orquestrador da Universidade Sintética. |
| Artefato não-agente (excluir da contagem funcional) | 3 | — (sem sinal suficiente) | Achado da auditoria desta tabela: 3 arquivos não-agente (README, template de handoff, um dispatcher de ativação) do próprio diretório agents/catalog/ foram varridos por um gerador automático de cards e ganharam frontmatter de agente — não são agentes funcionais. |
Abaixo, a lista completa dos 205 agentes por grupo (clique para expandir cada um):
Catálogo Acadêmico MASWOS (00–53) (46 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
00_editor_chefe_phd |
Editor-Chefe PhD / Gerente de Qualis A1. |
Crítico-reflexivo |
01_agente_diagnostico_escopo |
Transformar o tema do usuario em um problema de pesquisa claro, delimitado, auditavel e planejavel. | — |
02_agente_busca_curadoria |
Executar busca multipla, auditavel e suficientemente ampla para sustentar um artigo de alto nivel. | — |
03_agente_evidencias_citacoes |
Converter fontes em evidencias localizadas, com funcao argumentativa e limites de uso explicitados. | Empírico-analítico |
04_agente_estrutura_argumentativa |
Projetar a espinha argumentativa do artigo para que cada secao execute uma funcao precisa. | Crítico-reflexivo |
05_agente_revisao_literatura_teoria |
Construir uma revisao critica, dialogica e densa, em vez de uma lista de autores. | Crítico-reflexivo |
06_agente_metodologia_reprodutibilidade |
Escrever uma metodologia replicavel, justificada e auditavel. | Empírico-analítico |
07_agente_estatistica_analise |
Validar a adequacao dos testes, a completude dos reportes e o limite inferencial do manuscrito. | Empírico-analítico |
08_agente_visualizacao_evidencia_grafica |
Transformar resultados, metodo e comparacoes em visualizacoes com funcao argumentativa explicita. | Empírico-analítico |
09_agente_resultados |
Redigir os achados com precisao, ordem logica e neutralidade interpretativa. | Empírico-analítico |
10_agente_discussao_contribuicao |
Interpretar os achados em dialogo real com a literatura, explicando significado, limite e contribuicao. | Crítico-reflexivo |
11_agente_conclusao_coerencia_final |
Fechar o artigo respondendo a pergunta central, aos objetivos e as hipoteses sem introduzir nada novo. | — |
12_agente_auditoria_bibliografica_abnt |
Garantir consistencia total entre citacao no corpo, nota de rodape, referencia final e norma ABNT. | Regulatório-normativo |
13_agente_qa_qualis_a1 |
Avaliar se o manuscrito atende rigorosamente ao padrão MASWOS, o que significa EXIGIR | — |
14_agente_consistencia_interna |
Monitorar não apenas o contorno geral do artigo, mas aplicar auditoria micro e macro textual implacável (Padrão 10/10 MASWOS) | Crítico-reflexivo |
15_agente_resumo_abstract_palavras_chave |
Produzir resumo em portugues, abstract em ingles e palavras-chave que sintetizem fielmente o manuscrito completo, sem inventar... | Hermenêutico-interpretativo |
16_agente_integracao_editorial_docx |
Integrar todos os capitulos, apendices, figuras, referencias, resumo e metadados em um pacote editorial final coerente, pronto... | Pragmático-técnico |
17_agente_framework_reprodutivel_ambientes |
Transformar a parte computacional do artigo em um pacote reexecutavel, auditavel e explicito quanto a ambiente, dependencia,... | Pragmático-técnico |
18_agente_engenharia_dados_datasets_proveniencia |
Garantir que todo dado usado pelo artigo tenha origem, versao, papel analitico, restricao de uso e esquema documentalmente... | Empírico-analítico |
19_agente_auditoria_codigo_documentacao_tecnica |
Verificar se o codigo, os snippets, as bibliotecas e os pipelines tecnicos realmente correspondem ao que o artigo afirma e se... | Crítico-reflexivo |
20_agente_estatistica_avancada_inferencia |
Dar suporte inferencial de alto nivel a estudos quantitativos, incluindo cenarios frequentistas, bayesianos, causais,... | Empírico-analítico |
21_agente_matematica_aplicada_modelagem_formal |
Formalizar, derivar, verificar e delimitar modelos matematicos, equacoes, algoritmos numericos e estruturas simbolicas usadas... | Formal-dedutivo |
22_agente_ml_dl_datamining |
Projetar, auditar e comparar pipelines de aprendizado de maquina e mineracao de dados com rigor de baseline, generalizacao,... | Empírico-analítico |
23_agente_bioinformatica_omicas |
Dar suporte especializado a pipelines de DNA, RNA, epigenomica, proteomica, metabolomica, single-cell e multiomicas com foco... | Empírico-analítico |
24_agente_quimioinformatica_modelagem_molecular |
Auditar e estruturar pipelines de chemometrics, descritores, QSAR/QSPR, docking, dinamica molecular, espectrometria e... | Formal-dedutivo |
25_agente_ciencias_sociais_linguistica_computacional |
Dar suporte granular a estudos com surveys, psicometria, corpora, redes, NLP, estilometria, analise de discurso quantitativa e... | Hermenêutico-interpretativo |
26_agente_visao_computacional_multimodal |
Estruturar e auditar pipelines de imagem, video, OCR, segmentacao, deteccao, classificacao visual e modelos multimodais com... | Empírico-analítico |
27_agente_computacao_quantica_aplicada |
Dar suporte especializado a artigos com circuitos quanticos, simuladores, modelos hibridos, kernels quanticos, variational... | — |
28_agente_benchmarking_ablacao_robustez |
Verificar se o resultado computacional ou quantitativo resiste a comparacoes justas, seeds diferentes, ablations,... | Empírico-analítico |
29_agente_conformidade_internacional |
Garantir que o manuscrito cumpra rigorosamente as diretrizes internacionais exigidas por periódicos top-tier globais (Nature,... | Regulatório-normativo |
30_agente_traducao_nativa_proofreading |
Prover fluência e estilo em língua inglesa no limite máximo exigido por bancas editoriais internacionais Tier-1. | Hermenêutico-interpretativo |
31_agente_blind_peer_review_emulado |
Atuar como revisores contundentes (Reviewers 1, 2 e 3) e gerar comentários severos sobre falhas conceituais, metodológicas ou... | Crítico-reflexivo |
32_agente_etica_open_science |
Proteger legalmente e moralmente o estudo, além de submeter a coleta e guarda de dados aos Princípios FAIR (Findable,... | Crítico-reflexivo |
33_agente_automacao_multi_norma |
Transmutar qualquer citação (seja via UUID, bibtex ou harvard style brutas) para o estilo exato e minucioso da norma global... | Regulatório-normativo |
34_agente_identificacao_conflitos_similaridade |
Emular o relatório frio, robótico e inexorável de sistemas de verificação léxica como iThenticate, Turnitin ou CrossCheck. | — |
35_agente_coleta_datasets_reais |
Substituir absolutamente qualquer dataset sintético ou simulado por dados primários reais, coletados diretamente de APIs... | Empírico-analítico |
36_agente_exportacao_latex_pdf |
Converter o manuscrito consolidado em formatos de submissão profissional: LaTeX (com classe adequada ao periódico),... | Pragmático-técnico |
37_agente_apresentacao_slides_banca |
Produzir uma apresentação acadêmica de altíssimo nível visual e argumentativo, pronta para defesa perante banca Qualis A1 ou... | — |
38_agente_montagem_entrega_final |
Montar automaticamente, a partir dos fragmentos aprovados (manuscrito_secoes/00 a 07), um **documento completo, contínuo e... |
— |
39_agente_metodologia_multi_paradigma |
Garantir que a fundamentação e a execução metodológica do estudo estejam rigorosamente alinhadas ao paradigma epistemológico... | Empírico-analítico |
40_agente_marcos_teoricos_interpretacao |
Garantir que o artigo/TCC esteja ancorado em um marco teórico coerente, que a interpretação de resultados siga os cânones da... | Hermenêutico-interpretativo |
41_agente_gis_geoprocessamento_cartografia |
Produzir, auditar e integrar elementos geoespaciais de alta qualidade ao manuscrito: mapas temáticos, cartas, plantas, modelos... | Empírico-analítico |
42_agente_desenvolvedor_cientista_computacao |
Projetar, gerar, auditar e otimizar TODO o código utilizado no manuscrito — desde scripts de coleta de dados até pipelines de... | Empírico-analítico |
43_agente_satelite_bioinformatica_omics |
Coletar, tratar, processar e analisar dados de sensoriamento remoto (satélite, radar, LiDAR), dados biológicos (DNA, RNA,... | Empírico-analítico |
44_agente_correcao_textual_qualis |
Recebe textos reprovados ou com ressalvas dos agentes de validação (A13, A14) e os reescreve ativamente para atingir a nota 10/10. | — |
45_agente_refinamento_argumentacao |
Eleva a nota do critério 'Diálogo Crítico e Contribuição' (I2 e B1 da rubrica) para 10/10. | Crítico-reflexivo |
Reversa (Engenharia Reversa de Sistemas Legados) (28 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
reversa |
Ponto de entrada principal do Reversa. Orquestra a análise completa de um sistema legado, gerando especificações executáveis... | — |
reversa-agent-forum |
name: Agente Reversa: Agent Forum / Debate Moderator description: >- --- name: | — |
reversa-anp |
name: reversa-anp description: >- --- name: reversa-anp description: >- Agente especialista em | — |
reversa-archaeologist |
Analisa profundamente o código do projeto legado módulo a módulo — extrai algoritmos, fluxos de controle, estruturas de dados... | Empírico-analítico |
reversa-architect |
Sintetiza a análise do projeto legado em documentação arquitetural completa — diagramas C4, ERD completo, mapa de integrações... | Hermenêutico-interpretativo |
reversa-config-generator |
Subagente especializado em geracao de configuracoes complexas usando LLM em multiplas etapas com fallback heuristico. Conhece... | Pragmático-técnico |
reversa-data-master |
Documenta completamente o banco de dados do projeto legado — tabelas, relacionamentos, constraints, triggers, procedures e ERD... | Empírico-analítico |
reversa-design-system |
Extrai e documenta o sistema de design do projeto legado — paleta de cores, tipografia, espaçamentos, tokens e componentes a... | — |
reversa-detective |
Extrai conhecimento de negócio implícito do projeto legado — regras de negócio, ADRs retroativos via Git, máquinas de estado e... | Pragmático-técnico |
reversa-document-ir |
name: Agente Reversa: Document IR Report Pipeline description: >- --- name: reversa-document-ir | — |
reversa-entity-ner |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Entity Ner | — |
reversa-fileipc |
Agente de comunicação via filesystem do ecossistema Reversa. Orquestra a troca de mensagens entre processos usando o protocolo... | — |
reversa-graph-builder |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Graph Builder | — |
reversa-graphrag |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Graphrag | — |
reversa-hybrid-graph |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Hybrid Graph | — |
reversa-memory-updater |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Memory Updater | — |
reversa-oasis-profile |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Oasis Profile | — |
reversa-ontology-gen |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Ontology Gen | — |
reversa-planner |
Gera planos de engenharia reversa em etapas (Scope → Modules → Tasks → Dependencies → Resources), inspirado pelo... | — |
reversa-process-lifecycle |
name: Agente Reversa: Process Lifecycle Manager description: >- --- name: | — |
reversa-report-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Report Agent | — |
reversa-reviewer |
Revisa criticamente as especificações geradas pelo reversa-writer — encontra inconsistências, reclassifica confiança e gera... | Crítico-reflexivo |
reversa-scout |
Mapeia a superfície do projeto legado — estrutura de pastas, linguagens, frameworks, dependências e entry points. Use no... | Pragmático-técnico |
reversa-statemachine |
Agente de máquina de estados do pipeline Reversa. Gerencia transições de estado, valida dependências entre fases e mantém... | Pragmático-técnico |
reversa-swarm-review |
(sem descrição autoral no card — rótulo derivado do identificador) Reversa Swarm Review | Crítico-reflexivo |
reversa-synthesis |
Meta-agente sintetizador que coleta outputs de múltiplos agentes Reversa, cruza referências, identifica lacunas e produz... | — |
reversa-visor |
Documenta a interface do sistema legado a partir de screenshots — extrai componentes, layouts, fluxos de navegação e estados... | — |
reversa-writer |
Gera especificações executáveis do sistema legado como contratos operacionais, em formato de pasta-por-unit com... | — |
Engenharia & Ferramental de Desenvolvimento (28 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
adr-manager |
(sem descrição autoral no card — rótulo derivado do identificador) Adr Manager | — |
architect |
Projeta arquitetura de software e toma decisoes de design | Pragmático-técnico |
architecture-analyzer |
(sem descrição autoral no card — rótulo derivado do identificador) Architecture Analyzer | Pragmático-técnico |
batch-executor |
(sem descrição autoral no card — rótulo derivado do identificador) Batch Executor | — |
build-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Build Agent | Pragmático-técnico |
code-reviewer |
Revisa codigo para qualidade, seguranca e melhores praticas | Crítico-reflexivo |
codebase-analyzer |
Analyzes codebase implementation details. Call the codebase-analyzer agent when you need to find detailed information about... | Pragmático-técnico |
codebase-locator |
(sem descrição autoral no card — rótulo derivado do identificador) Codebase Locator | Pragmático-técnico |
codebase-pattern-finder |
codebase-pattern-finder is a useful subagent_type for finding similar implementations, usage examples, or existing patterns... | Pragmático-técnico |
context-manager |
(sem descrição autoral no card — rótulo derivado do identificador) Context Manager | — |
context-retriever |
(sem descrição autoral no card — rótulo derivado do identificador) Context Retriever | — |
contract-manager |
(sem descrição autoral no card — rótulo derivado do identificador) Contract Manager | — |
debugger |
(sem descrição autoral no card — rótulo derivado do identificador) Debugger | Pragmático-técnico |
devops-specialist |
(sem descrição autoral no card — rótulo derivado do identificador) Devops Specialist | Pragmático-técnico |
frontend-specialist |
(sem descrição autoral no card — rótulo derivado do identificador) Frontend Specialist | Pragmático-técnico |
git-manager |
Gerencia git - commits atomicos, PRs, mensagens convencionais | Pragmático-técnico |
openagent |
(sem descrição autoral no card — rótulo derivado do identificador) Openagent | — |
opencode-go-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Opencode Go Agent | — |
opencode-zen-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Opencode Zen Agent | — |
opencoder |
(sem descrição autoral no card — rótulo derivado do identificador) Opencoder | — |
optimizer |
(sem descrição autoral no card — rótulo derivado do identificador) Optimizer | — |
prioritization-engine |
(sem descrição autoral no card — rótulo derivado do identificador) Prioritization Engine | — |
reviewer |
(sem descrição autoral no card — rótulo derivado do identificador) Reviewer | Crítico-reflexivo |
security-auditor |
Realiza auditorias de seguranca e identifica vulnerabilidades | — |
simple-responder |
(sem descrição autoral no card — rótulo derivado do identificador) Simple Responder | — |
task-manager |
(sem descrição autoral no card — rótulo derivado do identificador) Task Manager | — |
test-engineer |
(sem descrição autoral no card — rótulo derivado do identificador) Test Engineer | — |
web-developer |
Develops Web UI components. | — |
Apresentações MIRA (R123–R126) (22 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
mira-3d |
Organiza elementos tridimensionais para cenas do MIRA | — |
mira-animated-metaphor |
Reexpressa conceitos como metáforas animadas MIRA | — |
mira-animator |
Gera animações centrais em loop para slides MIRA | — |
mira-builder |
Monta o deck MIRA em cards e seções navegáveis | — |
mira-chart |
Gera gráficos a partir de dados para apresentações MIRA | Empírico-analítico |
mira-chart-race |
Constrói corridas de gráfico e visualizações temporais MIRA | — |
mira-copywriter |
Refina textos e mensagens visuais do deck MIRA | — |
mira-extract |
Extrai briefing e estrutura inicial a partir das fontes do MIRA | — |
mira-get-videos |
Seleciona e organiza fundos em vídeo para apresentações MIRA | — |
mira-image |
Incorpora imagens existentes ao pipeline MIRA | Pragmático-técnico |
mira-image-template |
Cria templates MIRA a partir de imagens-base | — |
mira-new |
Porta de entrada conversacional do pipeline MIRA | Pragmático-técnico |
mira-planner |
Planeja a sequência de slides do deck MIRA | — |
mira-qrcode |
Insere QR codes escaneáveis em slides do MIRA | — |
mira-references |
Vincula fontes e referências ao tema do deck MIRA | Regulatório-normativo |
mira-size-animator |
Ajusta percepção de escala e tamanho nas animações MIRA | — |
mira-squared |
Gera versão quadrada 1:1 do deck MIRA | — |
mira-survey |
Cria enquetes e interações ao vivo no MIRA | — |
mira-thirds |
Reorganiza slides MIRA pela regra dos terços | — |
mira-validator |
Valida conformidade e consistência final do deck MIRA | Crítico-reflexivo |
mira-vertical |
Gera versão vertical 9:16 do deck MIRA | — |
mira-visuals |
Gera painéis e infográficos estáticos para o MIRA | — |
Ferramentas Determinísticas & Inferência Local (16 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
autoevolve |
AutoEvolve — engine de evolução autônoma do ecossistema OpenCode v5.1. Roteia subcomandos (/evolve... | — |
colibri-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Colibri Agent | Empírico-analítico |
data-knowledge-hub |
(sem descrição autoral no card — rótulo derivado do identificador) Data Knowledge Hub | Empírico-analítico |
docs-writer |
Escreve e mantem documentacao do projeto | Pragmático-técnico |
documentation |
(sem descrição autoral no card — rótulo derivado do identificador) Documentation | Pragmático-técnico |
gametheory-local |
(sem descrição autoral no card — rótulo derivado do identificador) Gametheory Local | Formal-dedutivo |
Image Specialist |
Specialized agent for image editing and analysis using Gemini AI tools | Empírico-analítico |
jinja2-templates |
(sem descrição autoral no card — rótulo derivado do identificador) Jinja2 Templates | Pragmático-técnico |
linguistic-corrector |
(sem descrição autoral no card — rótulo derivado do identificador) Linguistic Corrector | Hermenêutico-interpretativo |
litert-lm-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Litert Lm Agent | Empírico-analítico |
llm-reduction |
(sem descrição autoral no card — rótulo derivado do identificador) Llm Reduction | Pragmático-técnico |
OpenCopywriter |
Expert in persuasive writing, marketing copy, and brand messaging | — |
OpenTechnicalWriter |
Expert in documentation, API docs, and technical communication | Pragmático-técnico |
pdf2latex-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Pdf2Latex Agent | — |
PyPISearcher |
(sem descrição autoral no card — rótulo derivado do identificador) Pypisearcher | — |
quantum-nexus-phd |
(sem descrição autoral no card — rótulo derivado do identificador) Quantum Nexus Phd | Formal-dedutivo |
Pesquisa & Redação (Workspace agents) (12 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
contextscout |
(sem descrição autoral no card — rótulo derivado do identificador) Contextscout | — |
externalscout |
(sem descrição autoral no card — rótulo derivado do identificador) Externalscout | — |
honest-critic-agent |
Crítico antioverclaim que separa cobertura/processo de mérito de qualidade e recusa nota de topo sem validação externa (Honest... | Crítico-reflexivo |
story-mapper |
(sem descrição autoral no card — rótulo derivado do identificador) Story Mapper | — |
thoughts-analyzer |
The research equivalent of codebase-analyzer. Use this subagent_type when wanting to deep dive on a research topic. Not... | Pragmático-técnico |
thoughts-locator |
Discovers relevant documents in thoughts/ directory (We use this for all sorts of metadata storage!). This is really only... | — |
web-search-researcher |
Used to perform web searches from a URL and analyze the contents based on a query. | — |
ws-academic-pipeline |
Pipeline acadêmico LaTeX — compilação, fichamentos, cotejo, status e registro de aprendizado | Pragmático-técnico |
ws-coder |
Technical implementation specialist for writing and modifying code | — |
ws-researcher |
Knowledge architect for external research and documentation | Pragmático-técnico |
ws-reviewer |
Expert code reviewer for security, performance, and philosophy compliance | Crítico-reflexivo |
ws-scribe |
Human-facing content specialist for documentation and prose | Pragmático-técnico |
Literário (Molambudos / OpenCode Books) (11 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
Literary Character Psychology PhD |
Especialista PhD em personagens literários, psicologia narrativa, agência, desejo, conflito interno, transformação e relações... | Hermenêutico-interpretativo |
Literary Ethics & Trauma PhD |
Especialista PhD em ética literária da representação, trauma, alteridade, violência institucional, memória histórica e... | Hermenêutico-interpretativo |
Literary Image Sepia |
(sem descrição autoral no card — rótulo derivado do identificador) Literary Image Sepia | Hermenêutico-interpretativo |
Literary Innovation & Editorial PhD |
Especialista PhD em inovação formal literária, materialidade editorial, paratextos, hipertexto impresso, design narrativo e... | Hermenêutico-interpretativo |
Literary Narratology Architect PhD |
Especialista PhD em narratologia para arquitetura narrativa, enredo, temporalidade, focalização, rotas, partes e coerência... | Hermenêutico-interpretativo |
Literary Neurolinguistic Engineering PhD |
Especialista em engenharia neurolinguística literária — aplica padrões de hipnose ericksoniana, sugestão indireta e ancoragem... | Hermenêutico-interpretativo |
Literary Orchestrator PhD |
Orquestrador PhD de projetos literários para coordenar criação, estudo, crítica, scanners, pesquisa, revisão ética e... | Crítico-reflexivo |
Literary Research Scholar PhD |
Pesquisador PhD de busca e pesquisa literária para corpus comparativo, bibliografia, teoria, fontes, citações, lacunas e rigor... | Regulatório-normativo |
Literary Smoke Minimal |
Agente mínimo de smoke test literário para isolar falhas de runtime, slug, model routing e registry dos agentes literary-*. | Hermenêutico-interpretativo |
Literary Style & Voice PhD |
Especialista PhD em estilo literário, voz, ritmo, léxico, registro, dicção, musicalidade, revisão de prosa e assinatura... | Hermenêutico-interpretativo |
Literary Symbolic Imagery PhD |
Especialista PhD em símbolos, motivos recorrentes, imagens, campos sensoriais, metáforas, arquétipos e coesão simbólica literária. | Hermenêutico-interpretativo |
Cloud & Infraestrutura de Dados (8 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
Cloud AlloyDB Specialist |
Especialista em AlloyDB Omni e AlloyDB PostgreSQL — administração, saúde, monitoramento, otimização, performance, replicação e... | Pragmático-técnico |
Cloud BigQuery Specialist |
Especialista em BigQuery — SQL, ML/AI, BigFrames, Graph Analytics, Data Transfer Service, Dataform e dbt. Baseado em 4 skills... | Empírico-analítico |
Cloud Data Infra Generalist |
Generalista em infraestrutura de dados GCP — Firestore, Spanner, descoberta de assets, building data apps, ML best practices,... | Empírico-analítico |
Cloud Data Pipelines Specialist |
Especialista em pipelines de dados GCP — Dataflow, Cloud Composer/Airflow, Dataproc/Spark, orquestração de pipelines,... | Pragmático-técnico |
Cloud Security Specialist |
Especialista em segurança GCP — avaliação de postura GCS, prevenção de perda de dados, verificação de autenticação e análise... | Empírico-analítico |
Cloud SQL MySQL Specialist |
Especialista em Cloud SQL MySQL — administração, dados, ciclo de vida e monitoramento. Baseado em 4 skills do Antigravity... | Pragmático-técnico |
Cloud SQL PostgreSQL Specialist |
Especialista em Cloud SQL PostgreSQL — administração, dados, saúde, ciclo de vida, monitoramento, replicação, vector assist e... | Pragmático-técnico |
Cloud SQL SQL Server Specialist |
Especialista em Cloud SQL SQL Server — administração, dados, ciclo de vida e monitoramento. Baseado em 4 skills do Antigravity... | Pragmático-técnico |
Publicação KDP / Editorial (7 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
KDP Cover Engineer PhD |
Especialista PhD Amazon KDP em capa completa, contracapa, lombada, wrap, bleed, template, barcode e PDF de capa. | Pragmático-técnico |
KDP eBook ePub PhD |
Especialista PhD Amazon KDP em ePub, Kindle, KPF, sumário navegável, metadados digitais e conversão LaTeX/Markdown. | Pragmático-técnico |
KDP Final QA PhD |
Gate PhD Amazon KDP de QA final para pacote de upload, checklist, evidências, riscos residuais e instruções finais. | Pragmático-técnico |
KDP Interior Layout PhD |
Especialista PhD Amazon KDP em miolo, trim size, margens internas/externas, sangria, LaTeX e PDF pronto para impressão. | Pragmático-técnico |
KDP Metadata & ISBN PhD |
Especialista PhD Amazon KDP em ISBN, copyright, ficha catalográfica, metadados bibliográficos e consistência editorial. | Pragmático-técnico |
KDP Orchestrator PhD |
Orquestrador PhD Amazon KDP para coordenar miolo, capa, ePub, metadados, preflight e QA final de livros físicos e digitais. | Pragmático-técnico |
KDP Preflight Auditor PhD |
Auditor PhD Amazon KDP de preflight PDF para MediaBox, CropBox, fontes, imagens, hyperlinks, anotações e texto fora das margens. | Pragmático-técnico |
Guardas de Tradução Cultural (R359, R364-R366) (4 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
author-voice-guardian |
Guarda de voz autoral que audita traduções contra o perfil de voz da obra — marcadores regionais e orais, modernismos... | Hermenêutico-interpretativo |
back-translation-verifier |
Verificador determinístico de retrotradução que compara original e retrotradução quanto a números, entidades, negação,... | Hermenêutico-interpretativo |
cultural-episteme-agent |
Agente de Epistemes Culturais e Equivalência Interpretativa que audita traduções literárias quanto a voz, história,... | Hermenêutico-interpretativo |
terminology-graph-agent |
Grafo terminológico trilíngue (PT-BR/EN/ZH-CN) que consome deltas do CulturalEpistemeAgent, exige aprovação humana por termo e... | Hermenêutico-interpretativo |
Orquestradores Meta (6 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
AntigravityOrchestrator |
Orquestrador especializado que delega tarefas ao Antigravity (Google DeepMind Advanced Agentic Coding), expondo e coordenando... | Pragmático-técnico |
bernstein-orchestrator |
Bernstein é o maestro do ecossistema OpenCode. Ele orquestra agentes CLI coding (Claude, Codex, Gemini, Qwen) em pipelines... | Pragmático-técnico |
marceloclaro |
Avatar de Marcelo Claro: Controle Supremo, Criador e Orquestrador Central de todo o OpenCode e OpenCode Ecosystem. | — |
MasterOrchestrator |
Orquestrador mestre e controlador de ciclo de vida (end-to-end) para o Ecossistema OpenCode e Polimata. Inicializa e finaliza... | Pragmático-técnico |
Nano Orchestrator |
(sem descrição autoral no card — rótulo derivado do identificador) Nano Orchestrator | Pragmático-técnico |
StageOrchestrator |
Multi-stage workflow orchestrator managing stage transitions, gating rules, validation, and rollback for complex feature... | Pragmático-técnico |
Médico Virtual Supremo (6 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
medico-cardiologista |
name: Médico Cardiologista description: >- --- name: Médico Cardiologista — Especialista em | Empírico-analítico |
medico-infectologista |
name: Médico Infectologista description: >- --- name: Médico Infectologista — Especialista em | Empírico-analítico |
medico-neurologista |
name: Médico Neurologista description: >- --- name: Médico Neurologista — Especialista em | Empírico-analítico |
medico-radiologista |
name: Médico Radiologista description: >- --- name: Médico Radiologista — Especialista em | Empírico-analítico |
Médico Clínico Geral — Orquestrador Clínico |
(sem descrição autoral no card — rótulo derivado do identificador) Médico Clínico Geral — Orquestrador Clínico | Empírico-analítico |
Médico Virtual Supremo — Apoio Clínico Auditável |
(sem descrição autoral no card — rótulo derivado do identificador) Médico Virtual Supremo — Apoio Clínico Auditável | Empírico-analítico |
Jurídico (AuxJuris) (4 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
auxjuris_document_summarizer |
(sem descrição autoral no card — rótulo derivado do identificador) Auxjuris Document Summarizer | Regulatório-normativo |
auxjuris_email_drafter |
(sem descrição autoral no card — rótulo derivado do identificador) Auxjuris Email Drafter | Regulatório-normativo |
auxjuris_legal_assistant |
(sem descrição autoral no card — rótulo derivado do identificador) Auxjuris Legal Assistant | Regulatório-normativo |
auxjuris_legal_research |
(sem descrição autoral no card — rótulo derivado do identificador) Auxjuris Legal Research | Regulatório-normativo |
Outros / Utilitários (4 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
Catálogo de Skills Cloud (Antigravity Backup) |
56 skills de infraestrutura Google Cloud Platform (AlloyDB, Cloud SQL, BigQuery, Dataflow, Cloud Composer, GCS Security,... | Pragmático-técnico |
coder-agent |
(sem descrição autoral no card — rótulo derivado do identificador) Coder Agent | Pragmático-técnico |
Eval Runner |
Test harness for evaluation framework - DO NOT USE DIRECTLY | Pragmático-técnico |
Synthetic University — Orquestrador Acadêmico Transversal |
(sem descrição autoral no card — rótulo derivado do identificador) Synthetic University — Orquestrador Acadêmico Transversal | — |
Artefato não-agente (excluir da contagem funcional) (3 agentes) — clique para expandir
| Agente | Descrição (função) | Camada |
|---|---|---|
DISPATCHER_ATIVACAO |
(sem descrição autoral no card — rótulo derivado do identificador) Dispatcher Ativacao | — |
README |
(sem descrição autoral no card — rótulo derivado do identificador) Readme | — |
TEMPLATE_HANDOFF |
(sem descrição autoral no card — rótulo derivado do identificador) Template Handoff | — |
Seis componentes determinísticos que substituem chamadas de LLM para tarefas rotineiras,
integrando-se silenciosamente antes do AttentionRouter:
| Componente | Substitui | Latência típica |
|---|---|---|
| Whoosh3Engine | Busca semântica via LLM | < 30ms |
| RuleBasedRouter | Roteamento por AttentionRouter | < 2ms |
| LocalClassifier | Classificação de intenção via LLM | < 10ms |
| GameTheoryLocal | Debates estratégicos via LLM (Nash/Shapley) | ~3ms |
| Jinja2Engine | Geração de documentos via LLM | < 5ms |
| DataKnowledgeHub | Consulta a dados externos via LLM | < 50ms (cache) |
Integrações:
- R220:
RuleBasedRouter+LocalClassifiertestados antes doAttentionRouterno orquestrador (threshold 0.85) - R221:
DataKnowledgeHubenriquece manifesto doResearchHubcom dados validados - R222:
MetricsCollectorexpõe LLM calls saved via/health,/metricse no Doctor
Métrica: orch.get_reduction_stats() → total_llm_calls_saved
Cada agente/skill do catálogo é associado a um de 6 regimes epistemológicos
(empírico-analítico, formal-dedutivo, hermenêutico-interpretativo,
crítico-reflexivo, pragmático-técnico, regulatório-normativo) por inferência
determinística sobre metadados (transformer/episteme.py) ou frontmatter
explícito episteme: no agent card. O SkillHandbook.match() aplica a
afinidade epistêmica tarefa↔agente como peso brando (±10% máx.,
fail-open: sem episteme, o score é idêntico ao anterior). Cobertura medida
pelo 12º check do doctor (episteme_coverage): 133/205 agentes (65%) em
2026-08-02.
Stack contratual fail-closed para internacionalização editorial PT-BR/EN/ZH-CN:
| Módulo | Papel | Contrato |
|---|---|---|
translation/cultural_episteme.py |
Gate de equivalência cultural (21 códigos de risco) | OCB-CULTURAL-EPISTEME-001 |
translation/terminology_graph.py |
Grafo terminológico versionado; aprovação humana por termo; TERM_CONFLICT/SYMBOL_DRIFT | OCB-TERMINOLOGY-GRAPH-001 |
translation/author_voice.py |
Perfil de voz autoral (preserve/gloss/adapt); VOICE_SHIFT/ANACHRONISM/REGISTER_SHIFT | OCB-AUTHOR-VOICE-001 |
translation/back_translation.py |
6 verificações determinísticas de retrotradução; nunca aprova equivalência | OCB-BACK-TRANSLATION-001 |
scripts/benchmark_r367_cultural.py |
Benchmark medido em corpus interno rotulado (18 casos) | SPEC-935-R367 |
Resultado medido em 2026-08-02: precisão micro 1.00, recall micro 0.86 — com casos de limitação conhecida deliberados (corpus interno ≠ validação externa; ver disclaimer no relatório versionado).
Ponte contratual entre os 11 motores de raciocínio (SPEC-917/ARCHE-Peirce)
e a produção editorial (reasoning/production_scaffolds.py):
- Andaime científico: 8 movimentos de raciocínio auditáveis
(problema→lacuna→hipótese→método→evidência→contra-argumento→limitação→
contribuição), cada um com
engine_hintspara os motores existentes; - Auditoria de novidade: "inédito/inovador/state-of-the-art" sem citação
ou comparação na mesma frase →
UNSUPPORTED_NOVELTY_CLAIM(gate humano) — novidade se argumenta, não se decreta; - Plano literário contratual: voz, conflito, símbolos e estratégia de estranhamento explícitos antes da escrita;
- Distintividade medida: type-token, ritmo, léxico de 22 clichês pt — números descritivos, nunca veredito de qualidade;
- Seleção por episteme:
select_scaffold()roteia científico/literário pela camada 8; sem sinais →indeterminate(nunca chuta).
mci/rigorous_validation.py fecha um gap real: statistical_validator.py
(pré-existente) já validava p-values e effect sizes já fornecidos —
agora o ecossistema também computa estatística a partir de dados brutos:
- Contraprova por permutação: embaralha rótulos milhares de vezes (seed fixo, determinístico) e recalcula a estatística sob H0 — uma tentativa de falsificação real, não um número decorado. Corrige o viés de estatísticas assimétricas (Mann-Whitney U) centrando pela própria distribuição nula gerada, não por zero fixo;
- Duas lentes independentes: Welch-t (paramétrica) + Mann-Whitney (não-paramétrica), mais Cohen's d com IC 95% via bootstrap;
- Validação cruzada k-fold genérica: partição exaustiva/disjunta;
stable=Falsequando a variância entre folds é alta — um resultado só é aceito se generalizar, não só numa amostra; - Validade convergente:
convergent=Truesomente quando as duas famílias de teste concordam em significância E o IC do effect size exclui zero — reaproveitavalidate_statistics()para o veredito (Bayes factor) sem duplicar lógica; - Gate real no R103:
OrchestratorReviewer.verify_statistical_claim()só verifica uma claim noReviewLedgerquando há convergência; caso contrário permanece pendente com a nota de qual teste discordou.
Disclaimer obrigatório em todo relatório: convergência não prova a hipótese — significa que ela resistiu a tentativas independentes de falsificação; interpretação final é sempre humana.
mci/multidisciplinary_triangulation.py fecha a segunda metade do pedido
"cruzar informações relevantes e multidisciplinares": uma alegação só é
triangulated=True quando ≥2 domínios/disciplinas independentes
concordam e nenhum domínio a contesta. Design aditivo — não modifica
EvidenceGraph (R102) nem DataKnowledgeHub (R52/R55), que permanecem
fundacionais; o contrato de entrada ({source, domain, stance}) é uma
lista simples que qualquer chamador popula.
Regra central: contestação de qualquer domínio bloqueia — nunca
resolvida por maioria de votos (3 domínios a favor + 1 contra continua
triangulated=False, com achado CONTESTED_MULTIDISCIPLINARY nomeando
o domínio dissidente). Esconder controvérsia real seria o overclaim mais
perigoso possível aqui. Mesmo gate real no R103:
OrchestratorReviewer.verify_multidisciplinary_claim() só verifica a
claim no ReviewLedger quando há triangulação.
mci/preregistration_protocol.py corrige um bug real de overclaim
encontrado ao ler o mci/experiment_designer.py já existente: a linha
"pre_registered": context.get("pre_registered", True) dava o selo
"pré-registrado" de graça a qualquer chamador, sem verificação alguma.
Corrigido: pre_registered agora é False por padrão, e só vira True
quando um protocolo real foi registrado antes da análise
(register_protocol(hypothesis, method, falsification_criterion, alpha))
e depois verificado contra o que foi efetivamente usado
(verify_protocol) — comparação textual exata, porque reformular a
hipótese "só de forma" depois de ver os dados é como HARKing
(Hypothesizing After Results are Known) se disfarça. Mesmo gate real no
R103: OrchestratorReviewer.verify_preregistered_claim().
Os gates R369–R372 foram validados sobre um manuscrito real (não um
fixture sintético): academic/papers/manuscrito_educacao_armadilha_renda_media_usp.md,
adaptado de um dossiê analítico existente com 53 referências e 7
correlações de Pearson reais. A validação encontrou e corrigiu dois
problemas genuínos:
- Falso positivo no R369:
"primeiro"/"primeira"como gatilho bruto de alegação de novidade disparava em "primeiras diferenças" (termo econométrico padrão). Corrigido para exigir fraseado de prioridade autoral explícito ("pela primeira vez", "primeiro estudo a"...). - Gap real no R370: o motor de estatística de dados brutos não se
aplica a manuscritos publicados, que só reportam estatística-resumo
(r, p, n). Fechado com
pearson_naive_significance()— recálculo independente da significância de Pearson via t de Student em Python puro (validado contra scipy a 1e-15) — e uma contraverificação assimétrica (crosscheck_reported_correlation) que só sinaliza quando a significância reportada é mais forte que a fórmula ingênua sustenta, nunca quando é igual ou mais conservadora (o que cobre correções legítimas de cointegração/autocorrelação sem gerar falso positivo contra elas).
Relatório completo: validacao_externa/manuscrito_armadilha_renda_media/relatorio_validacao_pipeline.md.
flowchart TD
User([👤 Usuário / Pesquisador]) -->|Comando / Pergunta| Orquestrador[👑 Orquestrador Primário marceloclaro]
Orquestrador -->|1. Pesquisa Bibliográfica| Research[📚 ResearchHub: PubMed / bioRxiv / CORE]
Orquestrador -->|2. Decomposição de Problema| EvoSci[🧪 EvoSci Engine: Geração de Hipóteses]
Orquestrador -->|3. Produção do Manuscrito| Composer[✍️ Paper Composer: Formatação ABNT / APA]
Orquestrador -->|4. Apresentação Interativa| Mira[📊 Mira Presenter: Manuscrito → Slides Animados]
Composer --> Auditoria{🛡️ Auditoria Super-Rigor & Integridade}
Auditoria -->|Aprovado| Output([📄 Manuscrito Certificado + Decks MIRA + Certificado SHA-256])
Auditoria -->|Refinamento Necessário| LoopRefine[🔄 Autocorreção RED-GREEN]
LoopRefine --> Orquestrador
classDef blueNode fill:#cfe2ff,stroke:#3b6fb6,stroke-width:1.5px,color:#0d2b4e
classDef greenNode fill:#d4edda,stroke:#3c8f5c,stroke-width:1.5px,color:#0f3d24
classDef orangeNode fill:#ffe5cc,stroke:#d17a22,stroke-width:1.5px,color:#5c3400
classDef redNode fill:#f8d7da,stroke:#c0392b,stroke-width:1.5px,color:#5c1010
classDef purpleNode fill:#e6d9f5,stroke:#7d3c98,stroke-width:1.5px,color:#3a1a54
classDef grayNode fill:#e2e3e5,stroke:#6c757d,stroke-width:1.5px,color:#2b2e33
classDef tealNode fill:#d1f2eb,stroke:#0e8074,stroke-width:1.5px,color:#053b35
class User,Orquestrador blueNode
class Research,EvoSci,Composer,Mira greenNode
class Auditoria redNode
class Output greenNode
class LoopRefine orangeNode
graph TD
%% Entradas & Clientes
subgraph Clients [Pontes Multilaterais & Interfaces CLI]
OpenCodeCLI([OpenCode CLI / Codex])
ClaudeCLI([Claude Code CLI])
AntigravityCLI([Antigravity CLI agy])
Bridge[CliEcosystemBridge<br>Unificação de Agentes e Skills]
OpenCodeCLI --> Bridge
ClaudeCLI --> Bridge
AntigravityCLI --> Bridge
end
Bridge --> Orchestrator[Orquestrador Central: marceloclaro]
%% Servidores MCP
subgraph MCPServers [6 Servidores MCP Nativos]
mcp1[litert-lm-mcp]
mcp2[metacognitive-mcp]
mcp3[antigravity-bridge-mcp]
mcp4[pypi-search-mcp]
mcp5[colibri-mcp]
mcp6[scanners-mcp]
end
Orchestrator <--> MCPServers
%% Motores de Inferência
subgraph Engines [Motores de Inferência Local Zero-Token]
ColibriEngine[Colibri MoE Engine<br>OLMoE 1B/7B C Binary :8090]
LiteRTEngine[LiteRT-LM On-Device<br>Gemma 4 & Qwen3]
end
Orchestrator --> ColibriEngine
Orchestrator --> LiteRTEngine
%% Governança SDD, TDD e Selagem Criptográfica
subgraph Governance [Governança, Selagem & Autocorreção]
SpecReg[SpecRegistry<br>66+ SPECs Formais]
SpecVer[SpecVerifier<br>Portões SDD]
SelfCorr[SelfCorrectionEngine<br>Diagnóstico RED-GREEN]
SuperRigor[SuperRigorPipeline<br>8 Scanners Epistemológicos]
Merkle[MerkleIntegrityGuard<br>SHA-256 Merkle Root]
AuditCert[InternalAuditHarness<br>Certificados Imutáveis]
SpecVer -.-> SpecReg
SelfCorr --> SpecVer
SuperRigor --> Merkle
Merkle --> AuditCert
end
Orchestrator --> Governance
%% Saída Certificada
AuditCert --> CertOutput([🚀 Produção Certificada com Assinatura SHA-256])
classDef blueNode fill:#cfe2ff,stroke:#3b6fb6,stroke-width:1.5px,color:#0d2b4e
classDef greenNode fill:#d4edda,stroke:#3c8f5c,stroke-width:1.5px,color:#0f3d24
classDef orangeNode fill:#ffe5cc,stroke:#d17a22,stroke-width:1.5px,color:#5c3400
classDef redNode fill:#f8d7da,stroke:#c0392b,stroke-width:1.5px,color:#5c1010
classDef purpleNode fill:#e6d9f5,stroke:#7d3c98,stroke-width:1.5px,color:#3a1a54
class OpenCodeCLI,ClaudeCLI,AntigravityCLI,Bridge,Orchestrator blueNode
class mcp1,mcp2,mcp3,mcp4,mcp5,mcp6 purpleNode
class ColibriEngine,LiteRTEngine orangeNode
class SpecReg,SpecVer,SelfCorr,SuperRigor,Merkle,AuditCert redNode
class CertOutput greenNode
sequenceDiagram
autonumber
actor Dev as Orquestrador / Dev
participant Spec as SpecRegistry (SDD)
participant Code as Código / Agentes
participant Test as Pytest (TDDRunner)
participant SelfCorr as SelfCorrectionEngine
participant Audit as Merkle & Audit Certificate
Dev->>Spec: 1. Carrega Especificação Formal (SPEC-935-R*)
Dev->>Code: 2. Implementa Módulo ou Agente
Dev->>Test: 3. Executa Suíte de Testes TDD
alt Testes Passaram (GREEN)
rect rgb(212, 237, 218)
Test-->>Audit: 4. Emite Certificado SHA-256 & Calcula Merkle Root
Audit-->>Dev: 5. Concluído e Registrado em evolution/cycles.json
end
else Testes Falharam (RED)
rect rgb(248, 215, 218)
Test-->>SelfCorr: 4. Dispara Diagnóstico de Falha
SelfCorr->>Code: 5. Aplica Correção de Código em Circuito Fechado
SelfCorr->>Test: 6. Reexecuta Suíte de Testes
Test-->>Audit: 7. Validação Concluída com Sucesso (GREEN)
end
end
graph TD
%% Atores e Orquestrador
User([Usuário / CLI]) -->|Comandos| Orchestrator[Orquestrador: marceloclaro]
WebUI([Webapp Streamlit<br>Dashboard + Jurídico]) -->|Painel visual| Orchestrator
%% Camada SDD/TDD
subgraph SDD [SDD & TDD Engine]
Spec[SpecRegistry<br>Especificações]
Ver[SpecVerifier<br>Gate SDD]
TDD[TDDRunner<br>Red-Green-Refactor]
TDD -.->|Valida| Ver
Ver -.->|Lê| Spec
end
%% Camada Transformer
subgraph TF [Transformer Layer]
Attn[AttentionRouter<br>Multi-Head]
Pipe[TransformerPipeline<br>Gerar-Verificar-Revisar]
HTM[(Hierarchical<br>Memory HTM)]
Emb[TaskEmbedder<br>d=64]
Attn -.->|Usa| Emb
HTM -.->|Usa| Emb
end
%% LLM Reduction Layer (R220-R222)
subgraph RED [LLM Reduction Layer]
Router[RuleBasedRouter<br>25 regras + DecisionTree]
Class[LocalClassifier<br>TF-IDF + LogReg<br>threshold 0.15]
Whoosh[Whoosh3Engine<br>Busca BM25F local]
Game[GameTheoryLocal<br>Nash/Shapley/Pareto]
Jinja[Jinja2Engine<br>9 templates]
DataHub[DataKnowledgeHub<br>16 fontes · 5 domínios]
Valid[CrossValidator<br>Calibration + Audit]
Router --> Class
Class --> Whoosh
DataHub --> Valid
end
%% Observabilidade (R222)
subgraph OBS [Observabilidade]
Metrics[MetricsCollector<br>/health · /metrics]
DocMetrics[Doctor Check<br>llm_reduction_metrics]
HTTP[MetricsHTTPServer<br>porta 9090]
Metrics --> HTTP
DocMetrics -.->|consulta| Metrics
end
%% Pipeline Academico Agentivo
subgraph Acad [Pipeline Academico Agentivo v3.0]
EvoSci["R101: EvoSci<br>MentorAgent+ResearcherAgent<br>ReviewerAgent+EvoEngine"]
DeepRes["R102: Deep Research<br>EvidenceGraph+BFRS+DFRS"]
PReview["R103: Peer Review<br>8-dim Rubric+AuditGraph"]
Revision["R104d: Manuscript Revision<br>DiffEngine+Rebuttal"]
Composer["R105: Paper Composer<br>ABNT/APA/IEEE"]
EvoSci --> DeepRes
DeepRes --> PReview
PReview --> Revision
Revision --> Composer
end
%% Camada Core (Subsistemas)
subgraph Core [Core Subsystems]
Trust[Trust Engine<br>Behavioral Gate]
Eco[Token Economy<br>Staking/Slashing]
Scan[Scanners<br>Diagnóstico]
AcadLegacy[MASWOS<br>Qualis A1]
Reason[Reasoning<br>12 Engines + Quantum]
Legal[Legal Reasoning + AuxJuris<br>SPEC-921/922/923/924/925/926/927/928/931]
LegalBench[Legal Benchmarks<br>SPEC-928]
SynthUniv[Synthetic University<br>SPEC-935 · 11 Faculdades]
RAG[Scientific RAG<br>Grounding + Citations]
Bench[Superhuman Readiness<br>Benchmarks]
MetaEval[Metacognitive Eval<br>SPEC-920]
Discovery[Continuous Discovery<br>R95 · Loop Automático]
EvoMem[Evolutionary Memory<br>R97 · Memória Persistente]
Novelty[Novelty V2<br>R98 · Contribution Points]
RAGEvolved[RAG Evolved<br>R99 · Adaptive+CitationGraph]
ResearchHub[Research Hub<br>PubMed · bioRxiv · CORE<br>CLI pesquisa R120]
MiraDeck[Apresentações MIRA<br>manuscrito → deck animado R123]
MiraAgent[Agente mira-presenter<br>executor delegável R126]
end
MiraAgent -.->|encarna o pipeline| MiraDeck
%% Seguranca e Qualidade
subgraph SQC [Seguranca & Qualidade]
MCPSec[MCP Security R100<br>Guard+Audit+Vetter+Limiter]
CICD[CI/CD Pipeline R106<br>GitHub Actions+Quality Gates]
Skills[Skills Exportaveis R104a<br>4 Skills]
PipPkg[Pip Packages R104b<br>3 Pacotes]
end
%% MCP + API Gateway
subgraph Protocols [Protocolos de Integração]
MCPServer[MCP Server · R94+R100<br>14 Ferramentas via stdio]
APIGateway[API Gateway · R96<br>10+ Endpoints FastAPI REST]
MCP_Sci[su_agentic_science]
MCP_Deep[su_deep_research]
MCP_Review2[su_peer_review_v2]
MCP_Revision[su_manuscript_revision]
MCP_Composer[su_paper_composer]
MCP_Novelty2[su_novelty_v2]
MCP_Sec[su_mcp_security]
MCP_Classic[su_generate/evaluate/enrich/visual/peer-review/submission/novelty/dashboard]
end
%% Camada MCI
subgraph MCI [Metacognitive Interconnect]
MB[MetaBus<br>Global Workspace]
BB[Blackboard<br>A2A Protocol]
Mem[(Metacognitive<br>Memory)]
Ref[Reflexion<br>Middleware]
MB <--> Mem
BB <--> MB
Ref <--> MB
end
%% Orquestrador integra as camadas
Orchestrator -->|1. Cria Spec| Spec
Orchestrator -->|2. Recuperação em 2 níveis| HTM
HTM -->|Lê Episódica| Mem
Orchestrator -->|3. Gate & Roteia| Trust
Trust -->|Libera| RED
RED -->|conf >= 0.85| Router
Router -->|skip Attn| BB
RED -->|conf < 0.85| Attn
Attn -->|Publica Volunteer| BB
Orchestrator -->|4. Executa TDD| Pipe
Pipe -->|Verifica| Ver
Orchestrator <-->|Usa| Core
%% Conexões de observabilidade
Orchestrator -->|get_reduction_stats| Metrics
RED -.->|alimenta| Metrics
%% Pipeline academico
Orchestrator -->|5. Pipeline Academico| EvoSci
EvoSci -->|Alimenta| DeepRes
DeepRes -->|Produz evidencia| PReview
PReview -->|Gera revisao| Revision
Revision -->|Manuscrito revisado| Composer
Composer -->|Artigo final| Orchestrator
%% Conexões de suporte
AcadLegacy -->|Consulta evidências| RAG
Reason -->|Grounding científico| RAG
RAG -->|Métricas| Bench
RAGEvolved -->|Citacoes em grafo| DeepRes
EvoMem -->|Memoria de direcoes| EvoSci
Novelty -->|Analise de novidade| EvoSci
MB -->|Traços e reflexões| MetaEval
Trust -->|Outcomes e confiança| MetaEval
%% Jurídico
Orchestrator -->|6. Raciocínio Jurídico| Legal
Legal -->|Subsunção + Ponderação| Reason
Legal -->|Interpretação Constitucional| MetaEval
Legal -->|RAG jurídico + Datajud| RAG
Legal -->|Agentes jurídicos A2A| BB
Legal -->|Especialização por 7 ramos| LegalBench
LegalBench -->|tiers conservadores| MetaEval
%% SynthUniv
SynthUniv -->|Gera teses| Discovery
Discovery -->|Enriquece + Avalia| SynthUniv
%% Seguranca e qualidade
MCPSec -.->|Protege| MCPServer
CICD -.->|Valida| Pipe
Skills -.->|Exporta| BB
PipPkg -.->|Distribui| External
%% Integração MCP / API
SynthUniv -.->|Registra handlers| MCPServer
MCPServer --> MCP_Classic
MCPServer --> MCP_Sci
MCPServer --> MCP_Deep
MCPServer --> MCP_Review2
MCPServer --> MCP_Revision
MCPServer --> MCP_Composer
MCPServer --> MCP_Novelty2
MCPServer -->|stdio JSON-RPC| External
APIGateway -->|Reusa handlers| MCPServer
APIGateway -->|HTTP REST| External
%% Agentes
subgraph Agents [Catálogo de Agentes 205]
A1[Researcher]
A2[Coder]
A3[Reviewer]
A4[Academic Writer]
A5[EvoSci Agent]
A6[Deep Research]
A7[Peer Review]
A8[Paper Composer]
A9[Revision Agent]
A10[32 MASWOS Agents]
A11[mira-presenter Agent]
end
%% Camada Epistêmica e Guardas Culturais (R363-R369)
subgraph Epist [Camada Epistêmica & Guardas Culturais R363-R369]
EP1[episteme.py<br>6 regimes + léxico determinístico]
EP2[SkillHandbook<br>peso brando ±10% fail-open]
EP3[TerminologyGraph<br>aprovação humana por termo]
EP4[AuthorVoiceGuardian<br>preserve/gloss/adapt]
EP5[BackTranslationVerifier<br>6 verificações]
EP6[CulturalEpistemeAgent<br>21 códigos de risco]
EP7[ProductionScaffolds<br>8 movimentos + novidade ancorada]
end
EP1 --> EP2
EP2 -->|roteia| Agents
EP6 -->|delta propose_upsert| EP3
EP7 -->|select_scaffold| EP1
Orchestrator -->|match semântico+epistêmico| EP2
%% Fluxo de Agentes
Agents -.->|Registra Agent Card| BB
BB -.->|Call for Proposals| Agents
Agents -->|Voluntaria-se| BB
Agents -->|Conclui Tarefa| Ref
%% MCP
MCP_Node[MCP JSON-RPC] -->|Expõe API| MCI
External[External Tools / LLMs] -->|stdio ou HTTP| MCPServer
External -->|HTTP REST| APIGateway
%% ═══ Paleta de cores (bate com a Legenda de Cores abaixo) ═══
classDef blueNode fill:#cfe2ff,stroke:#3b6fb6,stroke-width:1.5px,color:#0d2b4e
classDef greenNode fill:#d4edda,stroke:#3c8f5c,stroke-width:1.5px,color:#0f3d24
classDef orangeNode fill:#ffe5cc,stroke:#d17a22,stroke-width:1.5px,color:#5c3400
classDef redNode fill:#f8d7da,stroke:#c0392b,stroke-width:1.5px,color:#5c1010
classDef purpleNode fill:#e6d9f5,stroke:#7d3c98,stroke-width:1.5px,color:#3a1a54
classDef grayNode fill:#e2e3e5,stroke:#6c757d,stroke-width:1.5px,color:#2b2e33
classDef tealNode fill:#d1f2eb,stroke:#0e8074,stroke-width:1.5px,color:#053b35
%% Azul — Orquestração e controle
class User,WebUI,Orchestrator,Spec,Ver,TDD,Attn,Pipe,HTM,Emb blueNode
%% Verde — Pipeline acadêmico (a cadeia de valor R101→R105)
class EvoSci,DeepRes,PReview,Revision,Composer greenNode
%% Laranja — Subsistemas de suporte (engines, RAG, memória, benchmark, catálogo)
class Router,Class,Whoosh,Game,Jinja,DataHub,Valid,Metrics,DocMetrics,HTTP orangeNode
class Trust,Eco,Scan,AcadLegacy,Reason,Legal,LegalBench,SynthUniv,RAG,Bench,MetaEval,Discovery,EvoMem,Novelty,RAGEvolved,ResearchHub,MiraDeck,MiraAgent orangeNode
class A1,A2,A3,A4,A5,A6,A7,A8,A9,A10,A11 orangeNode
%% Vermelho — Segurança e qualidade
class MCPSec,CICD,Skills,PipPkg redNode
%% Roxo — Protocolos de integração
class MCPServer,APIGateway,MCP_Sci,MCP_Deep,MCP_Review2,MCP_Revision,MCP_Composer,MCP_Novelty2,MCP_Sec,MCP_Classic,MCP_Node,External purpleNode
%% Cinza — Metacognição (barramento neural, memória, reflexão)
class MB,BB,Mem,Ref grayNode
%% Teal — Camada Epistêmica & Guardas Culturais (R363-R373, a mais nova)
class EP1,EP2,EP3,EP4,EP5,EP6,EP7 tealNode
O MIRA transforma um artigo ou manuscrito em uma apresentação científica animada. O registro leigo explica a finalidade; o registro PhD identifica contratos, arquivos e invariantes verificáveis.
| Elemento | Registro leigo | Registro PhD | Arquivo |
|---|---|---|---|
MiraEngine |
Ilustrador de um conceito isolado, com metáfora visual em movimento. | Seleciona metáforas do catálogo e produz cards SVG/CSS autocontidos. | illustrations/mira_engine.py |
MiraDeckPipeline |
Linha de montagem que transforma o texto inteiro em slides. | Esteira com seis estágios e ConformityReport. |
illustrations/mira_deck.py |
MiraPresentationAgent / mira-presenter |
Funcionário que executa a linha quando o trabalho é delegado. | Agent Card com capacidade exclusiva apresentacao-mira, sujeito ao Blackboard, Trust Engine e Token Economy. |
illustrations/mira_agent.py |
present() e present_task() |
Botão direto e botão governado pelo sistema de tarefas. | Chamada direta para o CLI e caminho delegate → execute → report_completion. |
marceloclaro/orchestrator.py |
extract— lêmanuscrito.md, cria umaSectionpor##e detecta citações, código e listas.plan— monta capa, um slide por seção e encerramento; o tipo acompanha a ideia (quote,code,gridouconcept).copywrite— reduz cada título a no máximo seis palavras e enxuga os subtítulos.build— cria um HTML autocontido de cards de vidro combackdrop-filtere navegação por teclado e botões, ainda sem animação.animate— aplica a Regra Zero: coreografia de entrada e loopinfinite; conceitos recebem o SVG da metáfora.validate— verifica animação, títulos, navegação, autocontenção e emiteCONFORMIDADE.md.
Para leigos, um slide parado é um defeito de montagem; para PhDs, a
Regra Zero é uma invariante testada pela presença de @keyframes e
infinite. A documentação descreve o contrato do componente, não uma
validação externa do conteúdo científico.
| Símbolo | Significado |
|---|---|
[Texto] |
Componente interno do sistema (ex: [SpecRegistry]) |
([Texto]) |
Ator externo — usuário, CLI, ferramenta fora do ecossistema |
{Texto} |
Módulo de armazenamento — banco de dados, cache, memória persistente |
>"Texto"] |
Entrada/Saída — subprocesso, pipeline de dados |
subgraph NOME [...] ... end |
Agrupamento lógico — uma camada ou subsistema |
A --> B |
Fluxo direto — A chama/envia dados para B |
A -.-> B |
Fluxo indireto — A influencia ou registra em B (ex: registro de handler, proteção) |
A <--> B |
Fluxo bidirecional — troca contínua de dados entre A e B |
A -->|Rótulo| B |
Fluxo com descrição — o que está sendo passado (comando, dados, controle) |
A[\"<br>Texto\"] |
Componente com múltiplas linhas — detalhamento interno |
| Camada | Função |
|---|---|
| SDD & TDD Engine | Motor de especificação e testes. Toda entrega nasce como spec (SDD) e só é aceita após testes verdes (TDD). |
| Transformer Layer | Roteador por atenção multi-cabeça. Substitui if/else estático por scores softmax de semântica, capacidade, confiança e carga. |
| Pipeline Academico v3.0 | O coração do sistema. 5 estágios sequenciais que transformam um problema em artigo completo revisado e formatado. |
| Core Subsystems | Subsistemas auxiliares: trust engine, economia de tokens, motores de raciocínio, RAG científico, Universidade Sintética, memória evolutiva. |
| Segurança & Qualidade | Proteção MCP (guard/audit/vetter/limiter), CI/CD (GitHub Actions + quality gates), skills exportáveis e pacotes pip. |
| Protocolos de Integração | Interfaces de comunicação: MCP Server (stdio JSON-RPC) e API Gateway (FastAPI REST). 5 servidores MCP ativos (Core, LiteRT-LM, Colibri/OLMoE, PyPI, Synthetic University). |
| Metacognitive Interconnect | Barramento neural central. MetaBus (pub/sub global), Blackboard (protocolo A2A), memória metacognitiva e middleware de reflexão. |
| Catálogo de Agentes | 205 agentes especializados que se registram no Blackboard e competem por tarefas via Call for Proposals. |
| LLM Reduction Layer | 6 componentes determinísticos (Whoosh3Engine, RuleBasedRouter, LocalClassifier, GameTheoryLocal, Jinja2Engine, DataKnowledgeHub) que substituem LLM em tarefas com confiança ≥ 0.85. |
| Observabilidade | MetricsCollector com servidor HTTP (/health, /metrics), integrado ao Doctor como check llm_reduction_metrics. |
As cores abaixo são renderizadas de verdade nos diagramas 1, 2 e 4 desta
seção (via classDef/class do Mermaid — não é só descrição em texto):
| Cor | Significado |
|---|---|
| 🔵 Azul | Camada de orquestração e controle (Orquestrador, SDD, Transformer) |
| 🟢 Verde | Pipeline acadêmico — a cadeia de valor principal R101→R105 |
| 🟠 Laranja | Subsistemas de suporte — engines, RAG, memória, benchmark, catálogo de agentes |
| 🔴 Vermelho | Segurança e qualidade — proteção, validação, CI/CD |
| 🟣 Roxo | Protocolos de integração — MCP, API Gateway |
| ⚪ Cinza | Metacognição — barramento neural, memória, reflexão |
| 🟦 Teal | Camada Epistêmica & Guardas Culturais (R363–R373) — a camada mais nova |
No diagrama 3 (sequência SDD/TDD), os blocos rect coloridos marcam
visualmente o ramo GREEN (verde-claro, testes passaram) e o ramo
RED (vermelho-claro, testes falharam e entram em autocorreção) —
reforçando a própria terminologia RED-GREEN do TDD.
A orquestração é o ciclo de vida de uma tarefa pelos 7 passos do protocolo marceloclaro: Perceber → Especificar → Delegar → Executar → Verificar → Refletir → Registrar. Abaixo, cada passo é detalhado com o fluxo real no diagrama.
User([Usuário]) -->|"Comandos"| Orchestrator
O ciclo começa quando o usuário dá um comando. O Orquestrador marceloclaro recebe a requisição — seja via CLI, webapp Streamlit ou chamada MCP.
O que acontece internamente:
- O orquestrador valida a entrada (formato, segurança básica)
- Identifica o tipo de tarefa: pesquisa, código, artigo acadêmico, revisão, diagnóstico
- Consulta a memória metacognitiva (
Mem[(Metacognitive Memory)]) viaHTM[(Hierarchical Memory)]para saber se já executou tarefa similar antes e quais lições foram aprendidas - Define o escopo: o que precisa ser entregue, quais critérios de sucesso
Exemplo prático: Usuário diz: "Produza um artigo científico sobre ética quântica em IA, no formato ABNT".
O orquestrador identifica: tarefa do tipo academic_pipeline, formato ABNT, tópico "quantum ethics in AI".
Orchestrator -->|"1. Cria Spec"| Spec[SpecRegistry]
Antes de qualquer execução, o orquestrador cria uma Especificação Formal (SDD) no SpecRegistry.
O que contém uma spec:
- Objetivo: descrição do que será entregue
- Critérios de Aceitação (CA): lista verificável de condições que a entrega deve satisfazer
- Recursos necessários: agentes, ferramentas, orçamento de tokens
- Prazo estimado: número de ciclos TDD
Exemplo (spec para o artigo de ética quântica):
CA1: O artigo deve ter no mínimo 5 seções (abstract, intro, methods, results, conclusion)
CA2: Deve conter no mínimo 3 citações formatadas em ABNT
CA3: A revisão por pares deve atribuir score ≥ 7/10 em todas as 8 dimensões
CA4: O manuscrito deve passar pelo DiffEngine sem erros de integridade
A spec fica registrada e auditável para sempre. Nada é executado sem uma spec aprovada.
Orchestrator -->|"2. Recuperação em 2 níveis"| HTM
HTM -->|"Lê Episódica"| Mem
Orchestrator -->|"3. Gate & Roteia"| Trust[Trust Engine]
Trust -->|"Libera"| Attn[AttentionRouter Multi-Head]
Attn -->|"Publica Volunteer"| BB[Blackboard A2A]
Este é o passo mais sofisticado da arquitetura. Ele substitui um simples if/else por um sistema de atenção multi-cabeça inspirado em Transformers.
Sub-passo 3.1: Recuperação de Memória O orquestrador consulta a Hierarchical Memory (HTM) em dois níveis:
- Atenção grossa: busca sumários de chunks de memória similares à tarefa atual
- Atenção fina: sobre os eventos dos melhores chunks, recupera detalhes de execuções anteriores, lições aprendidas e scores de confiança
Sub-passo 3.2: Gate Comportamental O Trust Engine avalia:
- O agente que executou tarefa similar anteriormente tem confiança suficiente? (confidence ledger)
- A tarefa envolve risco alto? (ex: execução de código externo, acesso a dados sensíveis)
- O orçamento de tokens está disponível?
Se o gate falhar, a tarefa é bloqueada ou redirecionada para um agente com supervisão.
Sub-passo 3.3: LLM Reduction Layer (NOVO R220)
Antes de chamar o AttentionRouter (LLM real), o orquestrador tenta a
LLM Reduction Layer:
RuleBasedRoutertenta 25 regras regex + DecisionTreeClassifier para determinar o melhor agente- Se a confiança for ≥ 0.85 e o agente estiver elegível, o
AttentionRouteré pulado - Estatísticas são acumuladas: LLM calls saved, rotas processadas
Resultado: tarefas comuns (roteamento de código, documentação, pesquisa) são processadas sem qualquer chamada de LLM, com latência < 5ms.
Sub-passo 3.4: Atenção Multi-Head (fallback) Se a LLM Reduction Layer não tiver confiança suficiente, o AttentionRouter calcula scores softmax com 4 cabeças:
| Cabeça | O que mede | Peso |
|---|---|---|
| Semântica | Similaridade entre a tarefa e as capacidades do agente (via TaskEmbedder d=64) | 35% |
| Capacidade | O agente tem as ferramentas necessárias? (ex: acesso a RAG, motores de raciocínio) | 30% |
| Confiança | Qual o histórico de acertos do agente? (Trust Ledger) | 25% |
| Carga | O agente está disponível ou já ocupado? | 10% |
O agente com maior score composto vence a disputa.
Sub-passo 3.5: Publicação no Blackboard (quando necessário)
Se o AttentionRouter foi chamado (fallback por baixa confiança na redução),
o orquestrador publica um Call for Proposals (CFP) no Blackboard (A2A Protocol):
BB -.->|"Call for Proposals"| Agents- Agentes elegíveis se voluntariam:
Agents -->|"Voluntaria-se"| BB - O AttentionRouter seleciona o melhor
Exemplo prático: Para o artigo de ética quântica:
- HTM recupera memórias de artigos anteriores sobre ética em IA
- Trust Engine libera com confidence score 0.85
- AttentionRouter calcula: EvoSci Agent=0.91, Academic Writer=0.78, Researcher=0.65
- EvoSci Agent é selecionado
Orchestrator -->|"5. Pipeline Academico"| EvoSci
EvoSci -->|"Alimenta"| DeepRes
DeepRes -->|"Produz evidencia"| PReview
PReview -->|"Gera revisao"| Revision
Revision -->|"Manuscrito revisado"| Composer
Composer -->|"Artigo final"| Orchestrator
O coração do ecossistema: 5 estágios em série, cada um alimentando o próximo.
Estágio 1 — R101: EvoSci (Descoberta Científica)
- MentorAgent: constrói o espaço do problema, divide em subproblemas
- PrimeResearcherAgent: gera soluções candidatas para cada subproblema
- ReviewerAgent: avalia cada solução em múltiplas dimensões (novidade, viabilidade, impacto)
- EvolutionManagerAgent: mantém memórias de ideação e experimentação
- EvoEngine: executa ciclo evolutivo: Selection → Crossover → Mutation → Inheritance
- Selection: as melhores soluções são selecionadas por fitness
- Crossover: combina características de duas soluções promissoras
- Mutation: introduz variação aleatória para explorar o espaço
- Inheritance: passa características adaptativas para a próxima geração
- Detecção de estagnação: se o fitness não melhora por N gerações, o sistema faz pivot
Saída: Uma hipótese refinada + direções de pesquisa + trajetória evolutiva
Estágio 2 — R102: Deep Research (Pesquisa Profunda)
- KnowledgeBaseRegistry: carrega fontes de conhecimento (PubMed, arXiv, OpenAlex simulados)
- BFRSAgent (Breadth-First Research Search): explora conexões imediatas em largura
- Para cada entidade, encontra relações diretas
- Constrói um grafo de primeiro nível
- DFRSAgent (Depth-First Research Search): constrói cadeias multi-hop
- Segue relações em profundidade (configurável até max_depth)
- Descobre conexões não óbvias entre conceitos distantes
- EvidenceGraph: acumula entidades, relações e evidências com proveniência completa
- Cada
Evidenceregistra: entidade origem, entidade destino, relação, timestamp, fonte - Suporta
find_paths(start, end, max_depth)via BFS - Suporta
subgraph_query(entities)para contextos focados
- Cada
- OrchestratorAgent: planeja a estratégia de busca, roteia entre BFRS e DFRS, aplica gate de suficiência (número mínimo de entidades e relações) e sintetiza o resultado
Conexões de suporte ativas:
RAGEvolved -->|"Citacoes em grafo"| DeepRes— o RAG Evolved (R99) alimenta o grafo com citaçõesEvoMem -->|"Memoria de direcoes"| EvoSci— a memória evolutiva (R97) evita re-explorar direções falhadasNovelty -->|"Analise de novidade"| EvoSci— o analisador de novidade (R98) pontua contribuições
Saída: Um relatório de pesquisa com evidências, grafo de conhecimento e gate de suficiência
Estágio 3 — R103: Peer Review (Revisão por Pares Agentiva)
- RubricEngine: instancia 8 meta-dimensões de avaliação:
| Dimensão | O que avalia | Polaridade |
|---|---|---|
| Originalidade | O trabalho é novo? | Positiva |
| Metodologia | Os métodos são sólidos? | Positiva |
| Resultados | Os resultados são convincentes? | Positiva |
| Reprodutibilidade | Dá para reproduzir? | Positiva |
| Clareza | A escrita é clara? | Positiva |
| Ética | Há preocupações éticas? | Negativa (score reverso) |
| Literature Review | A revisão de literatura é adequada? | Positiva |
| Impacto | Qual o impacto potencial? | Positiva |
- ReviewLedger: rastreia claims (afirmações do paper), evidências (suporte para cada claim) e riscos (nível de incerteza)
- Cada claim recebe um status:
verified,unsupported,contradicted,uncertain - Claims de alto risco geram automaticamente uma verification agenda
- Cada claim recebe um status:
- AuditGraph: integrado ao EvidenceGraph do R102, ancora cada evidência no grafo epistemológico
- MultiCriticReviewer: 4 críticos executando em paralelo:
| Crítico | Foco |
|---|---|
| Methodology Critic | Design experimental, viés, power analysis |
| Results Critic | Significância estatística, efeito, robustez |
| Literature Critic | Cobertura da revisão, citações ausentes |
| Ethics Critic | Conformidade ética, consentimento, privacidade |
- OrchestratorReviewer: pipeline completo:
- Drafting: gera rascunho da revisão
- Ledgering: constrói o ReviewLedger
- Grounding: ancora evidências no AuditGraph
- Auditing: executa gate de auditoria
- Synthesis: consolida em meta-review + repair plan priorizado (critical > major > minor)
Saída: Revisão completa com scores (0-10), repair plan, verification agenda e meta-review
Estágio 4 — R104d: Manuscript Revision (Revisão de Manuscrito)
- ReviewAnalyzer: extrai do pacote R103:
- Claims a serem corrigidos
- Riscos identificados
- Ações recomendadas
- SectionMapper: mapeia cada claim para a seção correspondente do manuscrito (ex: "metodologia fraca" → seção "Methods")
- ProposalGenerator: para cada issue, gera:
- Proposta principal (recomendada)
- Alternativas (quando aplicável)
- Justificativa da mudança
- DiffEngine: coração do sistema de revisão:
- Aplica diffs controlados no manuscrito
- Mantém histórico de versões para rollback
- Verifica integridade após cada diff (estrutura do documento preservada?)
- OrchestratorRevision: pipeline:
- Analyze: processa a revisão recebida
- Map: mapeia claims para seções
- Propose: gera propostas de correção
- Apply: aplica diffs (com rollback se algo falhar)
- Verify: verifica integridade do manuscrito revisado
- Report: gera relatório de mudanças + carta de rebuttal ponto-a-ponto automática
Saída: Manuscrito revisado + carta de rebuttal + diff stats
Estágio 5 — R105: Paper Composer (Composição Final)
- StructurePlanner: gera outline baseado no venue:
- ABNT: artigo científico brasileiro (NBR 6023/10520)
- APA: American Psychological Association 7th ed.
- IEEE: Institute of Electrical and Electronics Engineers
- SectionWriter: escreve 6 seções com fallback para inputs vazios:
- Abstract: resumo com palavras-chave
- Introduction: contexto, problema, objetivos
- Methods: metodologia, design, procedimentos
- Results: resultados, tabelas, figuras
- Discussion: interpretação, limitações, trabalhos futuros
- Conclusion: conclusão, contribuições
- CitationFormatter: formata referências em 3 estilos:
- ABNT NBR 6023:2018 (autor-data, alfabética)
- APA 7th (autor-data, ordem alfabética)
- IEEE (numérica, ordem de aparecimento)
- CrossConsistencyVerifier: 5 verificações automáticas:
- Abstract cobre todas as seções?
- Citações no texto têm referências?
- Terminologia consistente entre seções?
- Metodologia → Resultados → Discussão coerentes?
- Palavras-chave aparecem no texto?
- OrchestratorComposer: pipeline:
- Plan: gera estrutura
- Write: escreve cada seção
- Format: aplica formatação do venue
- Verify: executa verificações de consistência
- Export: gera saída final
Saída: Artigo completo formatado + referências + relatório de consistência
Pipe[TransformerPipeline] -->|"Verifica"| Ver[SpecVerifier]
Após a execução, dois gates são aplicados em paralelo:
Gate 1 — SpecVerifier (Gate SDD):
- Compara a entrega contra cada Critério de Aceitação da spec
- Se algum CA falhar, a entrega é rejeitada e volta para TDD (Refactor)
- Exige 100% de aprovação
Gate 2 — CI/CD Quality Gates (R106):
- Executa a suite completa de testes:
CICD -.->|"Valida"| Pipe - Gera relatório de qualidade:
scripts/quality_report.py - Verifica cobertura:
scripts/check_coverage.py(threshold ≥ 80%) - Se falhar, o agente sofre slashing na Token Economy
Conexões ativas:
MCPSec -.->|"Protege"| MCPServer— MCP Security monitora tentativas de injeçãoTrust -->|"Outcomes e confianca"| MetaEval— o resultado atualiza o confidence ledger
Agents -->|"Conclui Tarefa"| Ref[Reflexion Middleware]
Ref <--> MB[MetaBus Global Workspace]
O Reflexion Middleware intercepta a tarefa concluída e executa:
- Auto-reflexão: o sistema gera um relatório de:
- O que funcionou bem?
- O que poderia ter sido melhor?
- Quais decisões foram tomadas e por quê?
- Houve surpresas ou desvios do plano?
- Atualização do Confidence Ledger:
- Se a entrega passou nos gates → confiança do agente aumenta
- Se falhou → confiança diminui (slashing)
- Registro na Memória Metacognitiva:
- A experiência é persistida em
Mem[(Metacognitive Memory)] - Fica disponível para consultas futuras do HTM
- A experiência é persistida em
- Publicação no MetaBus:
- O evento de conclusão é transmitido para todos os subsistemas
MB -->|"Traços e reflexoes"| MetaEval— a avaliação metacognitiva é atualizadaBench[Superhuman Readiness]pode reavaliar o readiness score
Orchestrator -->|Registra| evolution/cycles.json
Cada ciclo completo de execução é registrado como um evento evolutivo no evolution/cycles.json:
{
"round_id": "R106",
"objective": "CI/CD Pipeline + Quality Gates",
"changes": ["Criado .github/workflows/ci.yml", "Criado scripts/quality_report.py"],
"score": 9.2,
"lessons": ["quality_report.py leva >30s; flag --quick agiliza"],
"timestamp": 1783564500.0
}Atualmente o ecossistema possui 52 ciclos registrados (R1 a R52), cada um com score, lições e timestamp.
Aqui está o ciclo completo de uma tarefa típica (artigo acadêmico):
Tempo 00:00 — Usuário envia comando "Produza artigo sobre ética quântica em ABNT"
Tempo 00:01 — Orquestrador recebe, consulta memória, define escopo
Tempo 00:02 — SDD: spec criada com 6 critérios de aceitação
Tempo 00:03 — HTM recupera 3 memórias de artigos similares
Tempo 00:04 — Trust Engine libera (confidence 0.85)
Tempo 00:05 — AttentionRouter seleciona EvoSci Agent (score 0.91)
Tempo 00:06 — Blackboard publica CFP, EvoSci Agent voluntaria
Tempo 00:10 — R101 EvoSci: Mentor constrói espaço, Researcher gera hipóteses
EvoEngine executa 5 gerações: Selection→Crossover→Mutation→Inheritance
Tempo 00:45 — R101 concluído. Melhor hipótese selecionada. Score: 8.7
Tempo 00:46 — R102 Deep Research: EvidenceGraph construído
BFRS explora conexões imediatas (23 entidades)
DFRS constrói 4 cadeias multi-hop
Gate de suficiência: aprovado (18 entidades ≥ 15 threshold)
Tempo 01:30 — R102 concluído. Relatório com 18 fontes, grafo de evidência
Tempo 01:31 — R103 Peer Review: RubricEngine instancia 8 dimensões
MultiCriticReviewer executa 4 críticos em paralelo
ReviewLedger: 12 claims identificados
AuditGraph ancora 15 evidências
Tempo 02:00 — R103 concluído. Meta-review. Repair plan: 3 critical, 2 major, 1 minor
Tempo 02:01 — R104d Revision: ReviewAnalyzer processa repair plan
SectionMapper: intro(1), methods(2), results(1), discussion(2)
DiffEngine aplica 6 diffs com rollback de segurança
Carta de rebuttal gerada automaticamente
Tempo 02:20 — R104d concluído. Manuscrito revisado. 6 diffs aplicados.
Tempo 02:21 — R105 Composer: StructurePlanner gera outline ABNT
SectionWriter escreve 6 seções
CitationFormatter: 15 referências em ABNT
CrossConsistencyVerifier: 5/5 verificações aprovadas
Tempo 02:40 — R105 concluído. Artigo completo exportado.
Tempo 02:41 — SpecVerifier: 6/6 critérios de aceitação satisfeitos ✅
Tempo 02:42 — CI/CD Gate: quality report score 8.9/10, coverage 86% ✅
Tempo 02:43 — Reflexion: 4 lições registradas, confidence atualizado
Tempo 02:44 — EvolutionRegistry: ciclo registrado como novo evento evolutivo
Tempo 02:45 — ENTREGA: artigo ABNT completo + carta de rebuttal + relatório de qualidade
"O usuário dá um comando → o orquestrador cria uma spec → consulta a memória → aplica gate de confiança → roteia por atenção multi-cabeça → delega via Blackboard A2A → executa o pipeline acadêmico de 5 estágios (EvoSci → Deep Research → Peer Review → Revision → Paper Composer) → verifica contra os critérios da spec e gates de qualidade → reflete sobre a execução → registra no evolution registry → entrega o resultado final."
Framework bio-inspirado multiagente para descoberta científica autônoma baseado em EvoSci (ACL 2026), EvoScientist (arXiv 2026) e EurekAgent (arXiv 2026).
from agentic_science_v2.orchestrator import AgenticScienceV2
agentic_science = AgenticScienceV2()
result = agentic_science.run(seed_domain="quantum ethics in AI", max_rounds=5)
print(result["best_solution"]["content"]) # Melhor hipotese/claim
print(result["evolutionary_trajectory"]) # Trajetoria completa
print(result["convergence_analysis"]) # Analise de convergencia67 testes TDD | Score evolutivo: 9.7/10
Sistema hierárquico de pesquisa profunda com Evidence Graph, busca em largura (BFRS) e profundidade (DFRS), e síntese multi-fontes. Inspirado em DeepEvidence (Nature MI 2026).
from agentic_science_v2.deep_research import OrchestratorAgent
orchestrator = OrchestratorAgent()
report = orchestrator.run(
question="What is the relationship between quantum coherence and ethical AI?",
max_depth=3
)
print(report["answer"]) # Resposta sintetizada
print(report["evidence_subgraph"]) # Subgrafo de evidencias
print(report["sufficiency_gate"]) # Gate de suficiencia48 testes TDD | Score: 9.6/10
Revisão por pares agentiva com rubrica de 8 dimensões, ledger de claim-evidence-risk, grafo de auditoria integrado ao R102, e 4 críticos especialistas (Methodology, Results, Literature, Ethics). Inspirado em REVIEWGROUNDER (ACL 2026) e DeepReviewer 2.0 (arXiv 2026).
from agentic_science_v2.review_agent import OrchestratorReviewer
reviewer = OrchestratorReviewer()
review = reviewer.run(
title="Quantum Ethics: A Framework for Moral AI",
abstract="...",
sections={"introduction": "...", "methods": "...", ...}
)
print(review["meta_review"]) # Revisao consolidada
print(review["scores"]) # Scores por dimensao
print(review["repair_plan"]) # Plano de correcoes priorizado44 testes TDD | Score: 9.6/10
Sistema agentivo de revisão de manuscritos pós-peer-review. Analisa a revisão recebida (R103), mapeia claims para seções, gera propostas de correção e aplica diffs controlados com rollback. Gera carta de rebuttal ponto-a-ponto automaticamente.
from agentic_science_v2.revision_agent import OrchestratorRevision
revision = OrchestratorRevision()
result = revision.run(review_package=review, manuscript=my_manuscript)
print(result["revised_manuscript"]) # Manuscrito revisado
print(result["rebuttal_letter"]) # Carta de rebuttal
print(result["diff_stats"]) # Estatisticas do diff28 testes TDD | Score: 9.6/10
Sistema agentivo de composição de manuscritos acadêmicos. Planeja estrutura por venue (ABNT, APA, IEEE), escreve 6 seções (abstract, intro, methods, results, discussion, conclusion), formata citações em 3 estilos, verifica consistência cruzada e exporta.
from agentic_science_v2.paper_composer import OrchestratorComposer
composer = OrchestratorComposer()
paper = composer.run(
title="Quantum Ethics in AI",
sections_content={...},
venue="abnt", # abnt | apa | ieee
citations=[...]
)
print(paper["full_text"]) # Texto completo formatado
print(paper["citations_formatted"]) # Referencias formatadas
print(paper["consistency_report"]) # Relatorio de consistencia30 testes TDD | Score: 9.5/10
Memória persistente para o pipeline de descoberta contínua. Quatro componentes:
| Componente | Função |
|---|---|
IdeationMemory |
Registra direções de pesquisa, scores e estratégias |
ExperimentationMemory |
Armazena outcomes de experimentos, recursos gastos |
HeartbeatReflection |
Reflexão periódica a cada N ciclos |
StagnationDetector |
Detecta platôs de score e sugere pivot |
from synthetic_university.evolutionary_memory import EvolutionaryMemorySubstrate
memory = EvolutionaryMemorySubstrate()
memory.record_ideation(direction="Quantum Ethics", score=0.85, strategy="explore")
memory.record_experiment(direction="Quantum Ethics", outcome="promising", resources=0.7)
reflection = memory.reflect()
print(reflection["stagnation_status"]) # "stable" | "plateau_detected"42 testes TDD | Score: 9.5/10
Camada de segurança para o servidor MCP com quatro componentes:
| Componente | Função |
|---|---|
MCPGuard |
Valida argumentos contra JSON Schema + wrap de handlers |
AuditLogger |
Registro estruturado com timestamp, ferramenta, args, duração |
ToolVetter |
Detecção de prompt injection (11 patterns), command injection, path traversal, SQLi |
RateLimiter |
Token bucket por caller com configuração de max_calls/window |
23 testes TDD | Score: 9.5/10
Infraestrutura de qualidade profissional com GitHub Actions:
3 jobs em pipeline:
- Lint — Ruff check + format check (Python 3.12)
- Test — Matrix Python 3.10–3.14, pytest full suite, quality report
- Package — Build & verify imports de 3 pacotes pip
scripts/quality_report.py— Relatório consolidado com score 0–10, análise de cobertura por módulo, lint e recomendaçõesscripts/check_coverage.py— Quality gate: verifica testes passando, cobertura estimada ≥ 80%, lint okscripts/run_full_suite.sh— Script bash orquestrador com modo--cie--json
As dependências adicionais de desenvolvimento ficam em
requirements-dev.txt, incluindo o frontend oficial build do PEP 517/518.
Use um ambiente virtual antes de instalar as dependências:
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements-dev.txt
python -m build --sdist packages/opencode-evosciimport build isoladamente não valida a disponibilidade do frontend executável:
um namespace homônimo fornecido por outra distribuição pode ser importável sem
possuir build.__main__. A verificação reprodutível é executar python -m build
com o interpretador do ambiente virtual.
# Executar suite completa localmente
./scripts/run_full_suite.sh
# Modo CI (para no primeiro erro)
./scripts/run_full_suite.sh --ci
# Apenas quality report rapido
python3 scripts/quality_report.py --quick18 testes TDD | Score: 9.2/10
4 skills no formato SKILL.md + skill.py para uso em outros ecossistemas:
| Skill | Comandos |
|---|---|
skills/evo-science/ |
evol — ciclo evolutivo, evol_agent — agente específico |
skills/deep-research/ |
deep — pesquisa profunda, evidence — grafo de evidência |
skills/peer-review-v2/ |
review — revisão agentiva, meta — meta-revisão |
skills/mcp-security/ |
guard — validar argumento, audit — log de auditoria |
3 pacotes instaláveis para integração em outros projetos:
pip install packages/opencode-evosci/
pip install packages/opencode-deep-research/
pip install packages/opencode-peer-review/from opencode_evosci import run_evosci_cycle
from opencode_deep_research import run_deep_research
from opencode_peer_review import run_peer_review_v2/synthetic_university/mcp_server.py — Servidor MCP via stdio JSON-RPC:
| Ferramenta | Função | Ciclo |
|---|---|---|
su_generate |
Gera pares de conceitos | R94 |
su_evaluate |
Avalia tese interdisciplinar | R94 |
su_enrich |
Enriquece tese com busca web | R89/R94 |
su_visual_abstract |
Gera abstract visual SVG | R90/R94 |
su_peer_review |
Revisão cega multi-LLM | R91/R94 |
su_submission |
Pacote de submissão Qualis A1 | R92/R94 |
su_novelty |
Análise de novidade clássica | R93/R94 |
su_novelty_v2 |
Análise V2 com contribution points | R98/R99a |
su_dashboard |
Dashboard HTML interativo | R94 |
su_agentic_science |
Ciclo EvoSci completo | R101 |
su_deep_research |
Pesquisa profunda multi-fontes | R102 |
su_peer_review_v2 |
Revisão agentiva com auditagem | R103 |
su_manuscript_revision |
Revisão de manuscrito com diff | R104d |
su_paper_composer |
Composição de paper ABNT/APA/IEEE | R105 |
/synthetic_university/api_gateway.py — Gateway REST com 12+ endpoints HTTP.
O módulo rag/evolved.py implementa um sistema RAG científico adaptativo:
| Componente | Função |
|---|---|
AdaptiveRetriever |
Análise de complexidade da query, 3 estratégias de retrieval |
CitationGraph |
Grafo direcionado de citações com BFS até max_depth |
OutlineSynthesizer |
Geração de outline com templates temáticos |
RAGEvolved |
Roteamento automático (simple vs. structured) |
from rag.evolved import RAGEvolved
rag = RAGEvolved()
answer = rag.answer("Explain the relationship between quantum decoherence and ethical AI frameworks")
print(answer["strategy_used"]) # "simple" | "structured"
print(answer["sections"]) # Secoes do outline (se structured)
print(answer["citations"]) # Citacoes do grafo25 testes TDD | Score: 9.5/10
Simulação de instituição acadêmica completa com:
- 11 faculdades (Filosofia, Física, Biologia, Computação, Direito, Economia, Medicina, Engenharia, Artes, Educação, Psicologia)
- 40+ professores especialistas sintéticos com h-index, faculdade e área de pesquisa
- Motor combinatorial testa 10.000+ combinações de conceitos interdisciplinares via MiroFish
- 10.000+ teses geradas com ranqueamento por score empírico
- Validação empírica calibrada (R82) com convergência e endosso
- Dashboard interativo HTML com Chart.js (R87)
- Abstracts visuais SVG automáticos (R90)
from synthetic_university.core import SyntheticUniversity
uni = SyntheticUniversity()
result = uni.run_discovery_cycle(n_pairs=5)
print(result["theses"][0]) # Melhor tese do ciclo
print(result["novelty_scores"]) # Scores de novidadeCiclos de evolução: 52 (R1–R52) | 1062+ testes | Score médio: 9.4/10
Motor de inferência C puro (OpenMP, zero deps) para modelos MoE, executando o OLMoE-1B-7B (Allen AI, 64 experts, 8 ativos/token) em CPU:
| Métrica | Valor |
|---|---|
| Engine | colibri/c/olmoe — C nativo, sem Python, CPU-only |
| Modelo | OLMoE-1B-7B-0125-Instruct (6.5 GB int8) |
| Correspondência de tokens | 12/12 (100% validado) |
| Cache hit rate (LRU) | 62.4% |
| Pico RSS | 4.79 GB |
| Decode (CPU cold) | 0.11 tok/s (bottleneck: I/O de disco) |
| Bridge | integrations/colibri/bridge.py — olmoe_complete(), olmoe_validate() |
| MCP | colibri_mcp_server.py — tools colibri:olmoe:complete, colibri:olmoe:validate |
| Provider | integrations/colibri_provider.py — fallback on-device na LLM Reduction |
# Baixar e compilar
python3 scripts/download_colibri_model.py
make -C colibri/c olmoe
# Validar
python3 -c "from integrations.colibri import ColibriBridge; b=ColibriBridge(); print(b.olmoe_validate())"
⚠️ 0.11 tok/s em CPU cold. GPU e cache quente melhoram drasticamente.
O ecossistema suporta inferência local completa via LiteRT-LM (Google AI Edge), rodando modelos Gemma 4 e Qwen3 diretamente na máquina, sem necessidade de API externa.
O LiteRT-LM agora conta com um supervisor de processos que gerencia o ciclo de vida do daemon on-device:
- Lock interprocesso (flock): impede execuções concorrentes
- Circuit breaker: após 3 falhas consecutivas, suprime tentativas por 60s
- CLI canônico:
litert-lm-supervisor start|stop|status|restart - Plugin TypeScript: bootstrap non-blocking do supervisor via
.opencode/plugins/ - Runtime nanogranular: DAG de tarefas com leases e idempotência
- ModelManager: validação anti-travessia de diretório
| Modelo | Parâmetros | Tamanho | Contexto (config.) | RAM estimada |
|---|---|---|---|---|
| Gemma 4 2B Expert | 2.6B | 2.4 GB | 20.480 tok | ~9-10 GB |
| Gemma 4 4B Expert | 4.6B | 3.4 GB | 20.480 tok | ~10-11 GB |
| Gemma 4 12B | 12B | 6.1 GB | 20.480 tok | >12 GB (GPU) |
| Qwen3 0.6B | 0.6B | 0.5 GB | 20.480 tok | ~1.5 GB |
O LiteRT-LM expõe uma API compatível com OpenAI em localhost:9379/v1,
permitindo que o OpenCode o use como provider nativo:
"litert-lm": {
"npm": "@ai-sdk/openai-compatible",
"name": "LiteRT-LM (on-device)",
"options": {
"apiKey": "sk-no-key-required",
"baseURL": "http://localhost:9379/v1"
}
}| Métrica | Gemma 4 E2B | Qwen3 0.6B |
|---|---|---|
| Cold start | ~2-4 min | ~10s |
| Request quente | 2-60s* | 1-3s |
| Contexto máximo | 20.480 tokens | 20.480 tokens |
| RAM (RSS) | ~9-10 GB | ~1.5 GB |
| Decode (CPU) | ~30-45 tok/s | ~150+ tok/s |
* Requests quentes lentos (~60s) ocorrem quando a RAM está no limite e o sistema usa swap. Para melhor performance, feche outros programas ou use Qwen3-0.6B.
Uso: ./scripts/litert-lm-serve.sh ou LITERT_LM_MAX_TOKENS=16384 litert-lm serve
10+ ciclos de evolução (R48–R52 + R210–R214) | 150+ testes de validação
Tudo abaixo é determinístico (sem LLM, sem rede) e roda em segundos:
# 1. Camada epistêmica de roteamento (R363) + cobertura do catálogo (R368)
python3 -m pytest tests/test_r363_episteme_routing.py tests/test_r368_episteme_coverage.py -q
# 2. Guardas de tradução cultural (R364-R366)
python3 -m pytest tests/test_r364_terminology_graph.py \
tests/test_r365_author_voice_guardian.py \
tests/test_r366_back_translation_verifier.py -q
# 3. Benchmark cultural medido (R367) — regenera os relatórios versionados
python3 scripts/benchmark_r367_cultural.py
python3 -m pytest tests/test_r367_cultural_benchmark.py -q
# 4. Andaimes de raciocínio produtivo (R369)
python3 -m pytest tests/test_r369_production_scaffolds.py -q
# 5. Cobertura epistêmica no diagnóstico (12º check)
python3 -m marceloclaro.cli doctor | grep -A2 episteme_coverageUso mínimo em Python:
from transformer.episteme import infer_task_episteme, episteme_affinity
from reasoning.production_scaffolds import (
select_scaffold, audit_scientific_manuscript,
validate_literary_plan, literary_distinctiveness_report,
)
from translation.terminology_graph import TerminologyGraph
from translation.author_voice import review_segment
from translation.back_translation import verify
# Roteia a tarefa pelo regime epistemológico
select_scaffold("análise estatística com regressão") # -> "scientific"
select_scaffold("tradução literária preservando a voz") # -> "literary"
# Audita um manuscrito: movimentos de raciocínio + alegações de novidade
resultado = audit_scientific_manuscript({"introducao": "...", "metodo": "..."})
# resultado["findings"] -> MISSING_MOVE / UNSUPPORTED_NOVELTY_CLAIMPolítica de honestidade (CORRIGENDUM): todos os números destas camadas são medidos e datados (nunca metas); os guardas apontam indícios e exigem revisão humana em alto risco; nenhum módulo atesta relevância científica, equivalência cultural ou qualidade literária.
| Critério | OpenCode v3.0 | LangGraph | CrewAI | AutoGen | MetaGPT |
|---|---|---|---|---|---|
| Pipeline Científico Fechado | ⭐⭐⭐⭐⭐ EvoSci→DeepRes→Review→Paper | ⭐⭐ | ⭐⭐ | ⭐ | ⭐ |
| Roteamento por Atenção | ⭐⭐⭐⭐⭐ Multi-Head (4 cabeças) | ⭐⭐⭐⭐ Grafos DAG | ⭐⭐⭐ Role-based | ⭐⭐⭐ Conversacional | ⭐⭐ Sequencial |
| Metacognição e Memória | ⭐⭐⭐⭐⭐ Evolution Memory + Reflexion | ⭐⭐⭐⭐ State checkpoint | ⭐⭐⭐ Short/Long term | ⭐⭐ Chat history | ⭐⭐ PRD-based |
| Garantia de Qualidade TDD | ⭐⭐⭐⭐⭐ SDD Gate + TDD + CI/CD | ⭐⭐⭐ Human-in-loop | ⭐⭐ Delegation only | ⭐⭐ Sandbox exec | ⭐⭐ QA agent |
| Economia de Tokens | ⭐⭐⭐⭐⭐ Staking/Slashing | ⭐⭐ | ⭐⭐ | ⭐ | ⭐ |
| Segurança MCP | ⭐⭐⭐⭐⭐ Guard+Audit+Vetter+Limiter | ⭐ | ⭐ | ⭐⭐ | ⭐ |
| Produção Científica | ⭐⭐⭐⭐⭐ ABNT/APA/IEEE + Revisão | ⭐⭐ | ⭐⭐ | ⭐ | ⭐ |
| CI/CD Nativo | ⭐⭐⭐⭐⭐ GitHub Actions + Quality Gates | ⭐ | ⭐ | ⭐ | ⭐ |
opencode-ecosystem-core/
├── agentic_science_v2/ # Pipeline academico agentivo (R101-R105)
│ ├── agents.py # MentorAgent, PrimeResearcherAgent, ReviewerAgent, EvolutionManager
│ ├── evolutionary_engine.py # Selection → Crossover → Mutation → Inheritance
│ ├── environment.py # Permissions, Artifacts, Budget, HITL
│ ├── evidence_graph.py # Entity, Relation, Evidence, path-finding BFS
│ ├── deep_research.py # KBRegistry, BFRS, DFRS, OrchestratorAgent
│ ├── review_agent.py # RubricEngine, ReviewLedger, AuditGraph, MultiCritic
│ ├── revision_agent.py # ReviewAnalyzer, SectionMapper, ProposalGenerator, DiffEngine
│ ├── paper_composer.py # StructurePlanner, SectionWriter, CitationFormatter, CrossVerifier
│ └── orchestrator.py # AgenticScienceV2 orchestrator
├── synthetic_university/ # SPEC-935 · 11 Faculdades
│ ├── mcp_server.py # MCP Server · 14 ferramentas stdio
│ ├── api_gateway.py # FastAPI REST · 12+ endpoints
│ ├── mcp_security.py # MCPGuard, AuditLogger, ToolVetter, RateLimiter (R100)
│ ├── evolutionary_memory.py # IdeationMemory, ExperimentationMemory (R97)
│ ├── novelty_v2.py # ContributionPointExtractor, PointwiseNoveltyScorer (R98)
│ └── ... # core, combinatorial_engine, empirical_validation, etc.
├── rag/
│ ├── evolved.py # AdaptiveRetriever, CitationGraph, OutlineSynthesizer (R99)
│ └── scientific.py # Scientific RAG classico (SPEC-919)
├── scripts/
│ ├── quality_report.py # Score 0-10, cobertura, lint, recomendacoes
│ ├── check_coverage.py # Quality gate com threshold 80%
│ └── run_full_suite.sh # Suite completa bash
├── .github/workflows/
│ └── ci.yml # GitHub Actions: lint, test (matrix), package
├── skills/ # Skills exportaveis (R104a)
│ ├── evo-science/
│ ├── deep-research/
│ ├── peer-review-v2/
│ └── mcp-security/
├── packages/ # Pacotes pip (R104b)
│ ├── opencode-evosci/
│ ├── opencode-deep-research/
│ └── opencode-peer-review/
├── translation/ # Guardas culturais: cultural_episteme, terminology_graph,
│ # author_voice, back_translation (R359, R364-R366)
├── reasoning/ # 11 motores (SPEC-917) + ARCHE RLT + production_scaffolds (R369)
├── transformer/ # SemanticMatcher/SkillHandbook + episteme.py (R363/R368)
├── validacao_externa/ # Benchmark cultural medido (R367) + dossiês
├── specs/ # Especificacoes SDD (R97-R369)
├── evolution/ # Cycles registry (190+ ciclos)
├── tests/ # 2.200+ testes automatizados
├── mci/ # Metacognitive Interconnect
├── marceloclaro/ # Orquestrador
├── agents/catalog/ # 205 agent cards (com frontmatter opcional episteme:)
├── sdd/ # SpecRegistry, SpecVerifier, TDDRunner
├── trust/ # Trust Engine
├── economy/ # Token Economy
├── transformers/ # AttentionRouter, HierarchicalMemory
├── benchmarks/ # Benchmarks cientificos
├── publishing/ # LaTeX, KDP, Cover Designer
├── research/ # Research Hub
└── webapp/ # Streamlit interface
# Suite completa (2.200+ testes; ~5h — rode em background)
python3 -m pytest tests/ -v
# Pipeline academico agentivo (R101-R105)
python3 -m pytest tests/test_r101_agentic_science_v2.py tests/test_r102_deep_research.py tests/test_r103_peer_review.py tests/test_r104d_agentic_revision.py tests/test_r105_paper_composer.py -v
# Evolutionary Memory + Novelty V2 + RAG Evolved (R97-R99)
python3 -m pytest tests/test_r97_evolutionary_memory.py tests/test_r98_novelty_v2.py tests/test_r99_rag_evolved.py -v
# MCP Security (R100)
python3 -m pytest tests/test_r100_mcp_security.py -v
# Integration Skills + Pip Packages (R104a-b)
python3 -m pytest tests/test_r104a_integration_skills.py tests/test_r104b_pip_packages.py -v
# CI/CD Pipeline (R106)
python3 -m pytest tests/test_r106_cicd.py -v
# Quality Report
python3 scripts/quality_report.py --quick
# Quality Gate
python3 scripts/check_coverage.py --threshold 80 --verbose
# Full Suite Script
./scripts/run_full_suite.shO ecossistema possui compatibilidade documentada com o fork timpara/opencode-academic-research (docs/COMPATIBILITY_ANALYSIS.md):
| Nosso Core | Fork Externo |
|---|---|
| Pipeline academico fechado R101-R105 | Skills avulsas para academic-writing |
| Evolutionary Memory + Evidence Graph | Não possui |
| MCP Security (Guard+Audit+Vetter+Limiter) | MCP basico sem seguranca |
| CI/CD Quality Gates (R106) | Sem CI/CD |
| 190+ ciclos de evolucao | Sem evolution registry |
| Peer Review agentivo 8-dimensoes | Revisao textual basica |
| Paper Composer ABNT/APA/IEEE | Templates LaTeX fixos |
As funcionalidades documentadas nos ciclos R47–R127 correspondem a
85 ciclos no registro histórico de referência. O arquivo operacional
evolution/cycles.json permanece sob a gestão da linha atual (R211), sem
substituição cega de seu estado nem mistura de métricas históricas com
validação externa.
v3.7.0 — Pipeline Acadêmico Agentivo | Camada Epistêmica | Guardas de Tradução Cultural | MCP Security | CI/CD
Números medidos em 2026-08-02 pelas próprias ferramentas do ecossistema (doctor, pytest --collect-only, contagem de arquivos) — não validação externa. Ver CORRIGENDUM.md.
Apoie o projeto