JoaoBiomed/nexus-protocol-engine

NEXUS Protocol Engine

Motor de geração de protocolos clínicos personalizados do Ecossistema NEXUS. Gera protocolos completos para médicos com base no contexto 360° do paciente (NEXUS ID), usando lógica determinística de triggers + enriquecimento por IA.

Filosofia Clínica (5 Pilares)

Todo protocolo gerado DEVE respeitar estes pilares:

1. Determinismo: Mesmos inputs = mesmos outputs. Triggers são regras fixas.
2. Auditabilidade: Toda decisão tem rastro (qual trigger disparou, qual evidência).
3. Explicabilidade: O médico e o paciente entendem o "porquê" de cada composto.
4. Ética Clínica: IA enriquece, nunca substitui o julgamento médico.
5. Stock-First: Só prescrever compostos disponíveis no estoque farmacêutico.

Quando Este Skill É Ativado

Geração de Protocolo

Quando o usuário pede para gerar um protocolo clínico, siga o fluxo completo:

1. Coletar contexto do paciente (NEXUS ID)
2. Identificar Modus Operandi e Objetivos Terapêuticos
3. Avaliar triggers de decisão
4. Gerar protocolo com seções específicas por Modus
5. Aplicar camadas M1-M7 de comunicação ao paciente
6. Produzir output no formato solicitado (JSON, PDF, DOCX, HTML)

Motor de Conhecimento

Quando o usuário quer entender ou desenvolver lógica clínica do NEXUS:

• Explicar triggers, convergências, farmacopeia
• Validar regras de decisão
• Propor novos triggers ou objetivos terapêuticos
• Revisar e expandir a base de conhecimento clínico

Arquitetura do Protocolo

Modus Operandi (5 domínios especializados)

Cada Modus gera seções DIFERENTES no protocolo. Leia o arquivo de referência do Modus relevante antes de gerar:

| Modus | Domínio | Referência | |-------|---------|------------| | EndoInject | Injetáveis IM/SC/IV, TRT, Estética injetável, Soroterapia | references/modus/endoinject.md | | LabPro | Investigação diagnóstica, painéis laboratoriais (10-30 exames) | references/modus/labpro.md | | iMeddis | Farmacoterapia oral, interações, desmame, rearranjo de receitas | references/modus/imeddis.md | | BodyScan3D | Composição corporal, dietética, nutrição, macros, exercício | references/modus/bodyscan3d.md | | Lifestyle | Sono, estresse, exercício, hábitos (alimentador de contexto) | references/modus/lifestyle.md |

Módulos de suporte (sem Modus AI próprio, mas cruzam dados):

• Pharma: Estoque farmacêutico, lotes, validade — alimenta a regra Stock-First
• Sample (Posto de Coleta): Fila de coleta, auto-checkin, compliance de amostras

Objetivos Terapêuticos

Cada protocolo tem 1+ objetivos. O médico seleciona e o motor gera:

Hormonais/Metabólicos: TRH_MASCULINA, TRH_FEMININA, OTIMIZACAO_METABOLICA, CONTROLE_INSULINA Estéticos/Regenerativos: DEFINICAO_CORPORAL, LIPOLISE, REJUVENESCIMENTO Performance: PERFORMANCE_FISICA, NEUROPERFORMANCE, ANTIFADIGA Prevenção: LONGEVIDADE, CARDIOPROTECAO, QUALIDADE_SONO

Quando múltiplos objetivos são selecionados, consulte references/convergence.md para regras de convergência (sinergias, tensões, priorização).

Contexto do Paciente (NEXUS ID)

O NEXUS ID agrega TODAS as variáveis do paciente numa visão 360°. Consulte references/patient-context.md para o schema completo.

Variáveis-chave que influenciam CADA protocolo:

• Demográficas: idade, gênero, sexo biológico, IMC
• Laboratoriais: últimos resultados (testosterona, estradiol, hematócrito, etc.)
• Medicamentos: ativos, recém-parados (washout), interações
• Composição corporal: % gordura, massa muscular, gordura visceral
• Estilo de vida: sono, exercício, estresse, dieta, hidratação
• Histórico: condições, alergias, cirurgias, família
• Risco: score 0-100, função renal/hepática
• Protocolos anteriores: resposta, tolerância, ajustes

Fluxo de Geração

Passo 1: Coletar Dados do Paciente

Se o usuário não forneceu dados completos, pergunte os essenciais:

• Nome, idade, gênero, peso, altura
• Queixa principal
• Resultados laboratoriais recentes (se disponíveis)
• Medicamentos atuais
• Histórico relevante (alergias, condições)

Quanto mais dados, melhor o protocolo. Mas gere com o que tiver, sinalizando lacunas no campo dataCompleteness.

Passo 2: Selecionar Modus + Objetivos

O médico escolhe ou o motor sugere com base na queixa. Exemplo: "Fadiga + testosterona baixa" → EndoInject + TRH_MASCULINA + ANTIFADIGA

Passo 3: Avaliar Triggers

Consulte references/triggers.md para a lista completa de triggers clínicos. Para cada marker laboratorial do paciente, avalie contra os thresholds. Triggers ativados determinam os compostos base do protocolo.

Passo 4: Gerar Seções por Modus

Cada Modus gera seções específicas. Leia o arquivo de referência do Modus e gere TODAS as seções obrigatórias. As seções comuns a todos os Modus são:

Seções Universais (todo protocolo tem):

1. Cabeçalho (dados paciente, NEXUS ID, data, médico)
2. Conclusão Clínica (análise do contexto + justificativa)
3. Prescrições (compostos, doses, vias, frequência)
4. Análise de Segurança (contraindicações, precauções)
5. Plano de Monitoramento (exames, consultas, timeline)
6. Orientações ao Paciente (M1-M7)
7. Consentimento e Assinaturas

Seções Específicas por Modus — consulte os arquivos de referência.

Passo 5: Aplicar Camadas M1-M7

Consulte references/m1-m7-layers.md para detalhes. Estas são camadas de comunicação ao paciente em linguagem acessível:

• M1: O que é este tratamento
• M2: Por que este tratamento para você
• M3: Como seguir (passo a passo)
• M4: Quando esperar resultados (timeline)
• M5: Efeitos colaterais (o que é normal vs alerta)
• M6: Quando ligar para o médico (sinais de alarme)
• M7: Resumo (recapitulação em 1 parágrafo)

Passo 6: Produzir Output

JSON (para integração com o app)

Siga o schema em references/protocol-schema.md.

PDF Premium (4 páginas)

Use o script scripts/generate_protocol_pdf.py:

• Pág 1: Dados do paciente + Exames + Triggers ativados
• Pág 2: Guia Profissional (prescrições + monitoramento)
• Pág 3: Guia do Paciente (M1-M7 em linguagem acessível)
• Pág 4: Consentimento + Assinaturas

DOCX (documento Word)

Gere um documento Word profissional com todas as seções formatadas.

HTML (pré-visualização interativa)

Gere um React artifact ou HTML standalone com navegação por seções, cores por Modus, e preview do que o paciente verá.

Cores por Modus (Design System NEXUS)

| Modus | Cor Principal | Hex | |-------|-------------|-----| | EndoInject | Teal vibrante | #00C2CB | | LabPro | Azul científico | #3B82F6 | | iMeddis | Verde farmacêutico | #10B981 | | BodyScan3D | Roxo profundo | #8B5CF6 | | Lifestyle | Laranja vitalidade | #F59E0B |

Governança Clínica

Todo protocolo gerado recebe:

• Risk Score (0-100): baseado em polifarmácia, rotas, doses, contexto do paciente
• Status: PENDING → APPROVED / BLOCKED / REVIEW_REQUIRED
• Governance Lock: protocolos de alto risco (score > 70) exigem aprovação manual
• Audit Hash: hash SHA-256 encadeado para imutabilidade

Regras de bloqueio automático:

• Risk score > 85 → BLOCKED
• Contraindicação absoluta detectada → BLOCKED
• Interação medicamentosa grave → REVIEW_REQUIRED
• Dose acima do limite máximo da farmacopeia → REVIEW_REQUIRED

Formato de Resposta

Ao gerar um protocolo, SEMPRE estruture assim:

## Protocolo Clínico NEXUS
**NEXUS ID**: NXID-XXXXX
**Modus**: [EndoInject/LabPro/...]
**Objetivos**: [lista]
**Data**: DD/MM/AAAA
**Risk Score**: XX/100 | Status: [APPROVED/PENDING/...]

### Conclusão Clínica
[Análise personalizada do contexto do paciente...]

### Prescrições
[Tabela com compostos, doses, vias, frequência, duração...]

### Triggers Ativados
[Lista de triggers que dispararam com evidência laboratorial...]

### Análise de Segurança
[Contraindicações, precauções, interações...]

### Plano de Monitoramento
[Timeline de exames e consultas...]

### Orientações ao Paciente (M1-M7)
[Camadas de comunicação em linguagem acessível...]

Depois de gerar o protocolo em texto, ofereça exportar para PDF/DOCX/HTML.

Referências Disponíveis

Sempre consulte os arquivos de referência antes de gerar:

| Arquivo | Conteúdo | Quando Consultar | |---------|----------|-----------------| | references/modus/*.md | Seções específicas por Modus | Sempre que gerar protocolo | | references/triggers.md | 100+ triggers de decisão | Ao avaliar labs do paciente | | references/convergence.md | Regras de convergência | Quando 2+ objetivos selecionados | | references/pharmacopeia.md | Compostos, doses, rotas | Ao prescrever compostos | | references/patient-context.md | Schema NEXUS ID completo | Ao coletar dados do paciente | | references/m1-m7-layers.md | Camadas de comunicação | Ao gerar orientações ao paciente | | references/protocol-schema.md | Schema JSON de output | Ao gerar JSON para o app |