---
name: megabrain
description: MegaBrain Sovereign Multi-Role Intelligence Service providing cognitive orchestration, BYOK routing, and attested execution receipts.
---

# MegaBrain Intelligence Skill

Esta skill descreve como e quando utilizar o serviço sovereign **MegaBrain** para orquestração cognitiva avançada, roteamento de modelos BYOK e verificação criptográfica de execuções.

## Quando Utilizar o MegaBrain

O MegaBrain deve ser acionado para:
1. **Tarefas de Alto Raciocínio e Arquitetura**: Decomposição estratégica, arbitragem de decisões estruturais e garantia de integridade arquitetural (roles `chief_architect` e `architecture_adjudicator`).
2. **Implementação de Código**: Geração de unidades atômicas de patch com garantia de limites (role `implementer`).
3. **Revisão e Crítica Adversarial**: Verificação independente livre de regressões e análise de especificações de segurança (roles `reviewer` e `spec_critic`).
4. **Diagnóstico de Falhas**: Investigação da causa raiz de erros e falhas de teste (role `failure_diagnostician`).
5. **Recomendação Inteligente de Modelos**: Determinar a role, o provedor e o modelo ideal para uma instrução sem executar a inferência de imediato (`megabrain.recommend`).
6. **Auditoria e Recibos Criptográficos**: Verificação formal de integridade de execução e atestação soberana (`megabrain.inspect`).

## Ferramentas Disponíveis (MCP)

As ferramentas estão disponíveis tanto com a nomenclatura canônica com ponto (`megabrain.<tool>`) quanto com underscore (`megabrain_<tool>`) para compatibilidade com clientes que restringem nomes de ferramentas a `^[a-zA-Z0-9_-]+$` (como Grok CLI).

### 1. `megabrain.infer` (ou `megabrain_infer`)
Delega uma tarefa cognitiva ao runtime de orquestração do MegaBrain.
- **Parâmetros**:
  - `instruction` (string, obrigatório): A diretriz, pergunta ou tarefa detalhada a ser executada.
  - `context` (string, opcional): Contexto adicional, trechos de código ou restrições relevantes.
  - `mission_id` (string, opcional): Identificador da missão para correlação.
  - `preferred_role` (string, opcional): Uma das 11 roles canônicas (ex: `chief_architect`, `implementer`, `reviewer`).
  - `provider_scope` (string, opcional): Restringe os provedores a serem avaliados.
  - `mode` (string, padrão: `"auto"`): Modo de execução da inferência.

### 2. `megabrain.recommend` (ou `megabrain_recommend`)
Analisa a instrução e o contexto para recomendar a melhor role canônica, provedor e modelo configurado, sem gastar tokens de inferência.
- **Parâmetros**:
  - `instruction` (string, obrigatório): A descrição da tarefa a analisar.
  - `context` (string, opcional): Contexto suplementar.
  - `preferred_role` (string, opcional): Sugestão preliminar de role.
  - `provider_scope` (string, opcional): Escopo de provedores aceitos.

### 3. `megabrain.inspect` (ou `megabrain_inspect`)
Consulta o estado de uma missão, execução ou recibo atestado anterior.
- **Parâmetros**:
  - `mission_id` (string, opcional): ID da missão a inspecionar.
  - `execution_id` (string, opcional): ID da execução específica.
  - `receipt_id` (string, opcional): Identificador do recibo criptográfico.

### 4. `megabrain.health` (ou `megabrain_health`)
Verifica a saúde operacional, prontidão do core, registro de modelos e integridade do ledger do MegaBrain.
- Não requer parâmetros.

### 5. `megabrain.orchestrate` (ou `megabrain_orchestrate`)
Executa uma missão de engenharia ponta a ponta com Git worktree isolado, testes determinísticos e recibo criptográfico.
- **Parâmetros**:
  - `prompt` (string, obrigatório): Diretriz da missão autônoma.

## Autenticação e Boas Práticas de Segurança

- **Chave de API**: O MegaBrain utiliza autenticação via Bearer token através do cabeçalho `Authorization: Bearer $MEGABRAIN_API_KEY`.
- **Armazenamento de Segredos**: Nunca comite chaves de API ou tokens de acesso em arquivos rastreados pelo controle de versão (`git`). Armazene a chave em variáveis de ambiente locais ou secret managers seguros.
- **Isolamento Soberano**: Todas as conexões de provedores (BYOK) e chaves são isoladas por usuário e nunca compartilhadas ou registradas em logs abertos.