菜单
Kernel skill — ALWAYS loaded before any other skill. Provides project topology, type gotchas, conventions, file zones, skill registry, and anti-patterns for the Ecossistema NEXUS. Every skill and pipeline depends on this context.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | nexus-core |
| description | Kernel skill — ALWAYS loaded before any other skill. Provides project topology, type gotchas, conventions, file zones, skill registry, and anti-patterns for the Ecossistema NEXUS. Every skill and pipeline depends on this context. |
This is the kernel of the NEXUS skill ecosystem. Every other skill MUST load this first. It provides the shared context that prevents repeated mistakes and ensures consistency across all operations.
| Category | Count | Location |
|---|---|---|
| Zustand stores | 31 | src/stores/ (27 root + 4 pharma/) |
| Firestore services | 43 | src/services/firestore/ |
| Cloud Functions | 24 | functions/src/ (13 HTTP + 3 triggers + 4 cron + 4 email) |
| Common UI components | 24 | src/ui/components/common/ |
| Routes | 35 | src/App.tsx (13 public + 22 protected) |
| Data files | 27 | src/data/ (pharmacopeia, lab, sample, therapeutics, protocol) |
| Agent TS files | 10 | src/agents/ (CORTEX pipeline: 9 agents + index) |
| Module pages | 7 | src/ui/pages/modules/ |
| Tests | 1680 | src/tests/ (77 files) |
| Module | Route | Store | Service | Data files |
|---|---|---|---|---|
| EndoInject | /endoinject | useSessionStore | endoinject.service | injectionSiteCatalog, aesthetics.constants |
| iMeddis | /imeddis | useMedicationStore | medications.service | pharmacopeia/* (8 files) |
| LabPro | /labpro | useLabStore | labResults.service | examCatalog, examEncyclopedia, examPanels, examCategories |
| Pharma | /pharma | 4 pharma stores | pharmaStock, pharmaBatches, pharmaMovements, pharmaPurchaseOrders, pharmaSuppliers | — |
| BodyScan | /bodyscan | useBodyScanStore | bodyScan.service | — |
| Lifestyle | /lifestyle | useLifestyleStore | lifestyle.service | — |
| Sample | /sample | useSampleQueueStore, useSampleComplianceStore, useSampleInventoryStore | sampleQueue, sampleCompliance, sampleInventory, sampleLabBridge, sampleStorage, sampleAudit | samplePriorityConfig, samplePops, sampleAlertProtocols |
| Agenda | /agenda | useAgendaStore | appointments.service | — |
| Protocols | /protocols | useProtocolStore, useProtocolTemplateStore | protocols.service, protocolTemplates.service, protocolOutcomes.service | m1m7Templates, protocolIntelligenceMatrix, objectiveConvergenceRules |
| Patients | /patients | usePatientStore | patients.service | — |
sampleLabBridge.service.ts — Sample dispatch → LabResult creationStatusSyncService.ts — Lab complete → protocol readiness; Protocol cancel → meds pausePatientContextAggregator.ts — Parallel fetch from 4 modules → PatientFullContextProtocolDispatcher.ts — Protocol save → medications + sessions + lab requestsRoleGuard (ADMIN | DOCTOR) → ModuleGuard (module access check) → ModuleErrorBoundary (error isolation)
These cause bugs if forgotten. ALWAYS check before touching patient/protocol code:
| Gotcha | Detail |
|---|---|
Patient type | Single source: src/types/PatientTypes.ts — NEVER redefine |
Patient.allergies | Is Allergy[] — display with a.allergen, NOT a directly |
Patient.consent | Is { given: boolean; date?: Date } or undefined — ALWAYS use ?.given |
Patient.conditions | Optional array — ALWAYS (patient.conditions || []) |
Patient.modulesLinked | Optional array — ALWAYS (patient.modulesLinked || []) |
Modus Operandi | = Module selection ('endoinject' | 'imeddis' | 'labpro'), NOT therapeutic objective |
NEXUS ID | Format: NXID-XXXXX (5 digits). Legacy: NX + 4 digits |
Protocol.status | DRAFT → PENDING → APPROVED → ACTIVE → COMPLETED | CANCELLED — strict transitions |
Prescription.medication vs .name | aiContent uses .medication, iMeddis uses .name — normalization needed |
Prescription.dosage vs .dose | Same dual-field issue — ProtocolDispatcher normalizes both |
EndoInjectSession.adverseReactions | Plural string[], NOT .adverseReaction |
ExamEncyclopediaEntry.fullName | Use .fullName, NOT .name. The .id is number — use String(exam.id) |
EXAM_PANELS | UPPERCASE export name |
Button icon prop | Expects ReactNode (<Icon /> not Icon) |
ProgressBar | Has NO label prop |
jsPDF | ALWAYS lazy-load via import('jspdf') — NEVER top-level import |
Patient service | Use services/firestore/patients.service — NOT modules/Patient/PatientService |
ProtocolCard.tsx)use prefix (useProtocolGeneration.ts).service.ts suffixuse{Name}Store.tsI prefix for interfacessrc/types/PatientTypes.tssrc/services/firestore/src/ui/components/common/node_modules paths directlyTypeScript strict mode, no any typesfeat(module):, fix(module):, refactor(module):, docs:, security:feature/MODULE-description, fix/MODULE-descriptiontsc --noEmit + vite build must passsrc/services/ProtocolOrchestrator.ts
src/services/ProtocolDispatcher.ts
src/services/PatientContextAggregator.ts
src/services/StatusSyncService.ts
src/hooks/useProtocolGeneration.ts
src/types/PatientTypes.ts
src/types/ProtocolTypes.ts
src/services/firestore/protocols.service.ts
src/services/firestore/patients.service.ts
src/services/firestore/clinicPlan.service.ts
functions/src/http/geminiProxy.ts
functions/src/http/stripeWebhook.ts
functions/src/http/stripeCheckout.ts
src/services/firestore/*.service.ts (all other services)
src/stores/*.ts (all stores)
src/hooks/*.ts (all other hooks)
src/agents/*.ts (all agents)
src/services/firestore/sampleLabBridge.service.ts
firestore.rules
src/utils/*.ts
src/ui/components/common/*.tsx
src/ui/pages/modules/**/*.tsx (UI-only changes)
src/data/*.ts (static data)
src/services/protocol/protocolEnricher.ts
src/services/protocol/doseValidator.ts
src/services/protocol/genderFilter.ts
Pure functions without side-effects
| Skill | When to use | Loads after core |
|---|---|---|
nexus-design-system | UI/UX creation, design fixes, visual work | Yes |
nexus-slop-killer | Dead code removal, cleanup, imports audit | Yes |
nexus-deploy | Pre-flight checks, build, deploy, health check | Yes |
| Skill | When activates | Blocks if |
|---|---|---|
protocol-integrity | Protocol/AI code changed | Safety gate removed, hash broken |
regression-shield | Any code changed | Existing test fails |
firestore-rules-audit | Rules/collections changed | Data exposed, LGPD violated |
safe-refactor | Service/store/hook refactored | Red zone touched, signature changed |
| Command | Pipeline |
|---|---|
/deploy-ready | core → slop-killer(audit) → regression-shield → protocol-integrity → deploy |
/refactor | core → safe-refactor → [change] → regression-shield |
/design-audit | core → design-system → [scan all pages] → report |
/design-fix | core → design-system → [apply fixes] → tsc + build |
| Anti-Pattern | Why it breaks things |
|---|---|
Import Patient from anywhere except PatientTypes.ts | Creates type drift, breaks aggregator |
Top-level import jsPDF | Adds 560KB to initial bundle |
Use any type | Bypasses TypeScript safety net |
| Modify Firestore collection names | Hardcoded in 50+ locations |
| Change NEXUS ID format | Universal key across all collections |
| Remove safety gates (consent, allergy, interaction checks) | Clinical safety violation |
| Skip SHA-256 on protocols | Breaks audit trail chain |
Put secrets in code (use .env) | Security breach |
Use console.log with patient data | PII leakage (LGPD violation) |
| Modify protocol status enum order | Breaks strict transition logic |
| Create new store without paired service | Breaks store-service bridge pattern |
| Create inline UI when common component exists | Visual inconsistency |
Use shadow-[...] arbitrary values | Design system violation |
Forget dark: classes | Broken dark mode |
sprint-{N}/{feature-name}nexus-72034052-d80bc (Blaze plan)nexushealthtech.com.brgemini-2.5-flash (temperature 0.1)# Everything
cd nexus-app && npx firebase-tools deploy --only functions,hosting --project nexus-72034052-d80bc
# Hosting only
npx firebase-tools deploy --only hosting --project nexus-72034052-d80bc
# Functions only
npx firebase-tools deploy --only functions --project nexus-72034052-d80bc
# Pre-deploy checks
npx tsc --noEmit && npx vite build
NEXUS ANTIGRAVITY UI/UX Design System — the definitive guide for all visual work on the NEXUS healthcare SaaS. Use this skill whenever the user asks to: improve or redesign any page or component, create new UI components, update visual design, fix styling inconsistencies, add dark mode support, improve responsiveness, enhance animations/transitions, or do any UI/UX work on the NEXUS app. Also trigger when the user mentions 'design', 'visual', 'UI', 'UX', 'estilo', 'layout', 'tema', 'dark mode', 'responsivo', 'componente', 'tela', 'página', 'redesign', 'melhorar visual', or asks to make something 'mais bonito' or 'mais moderno'. If the user is working in the NEXUS codebase and the task involves anything visual, use this skill.
Sistema completo de gestão farmacêutica do Ecossistema NEXUS. Use este skill SEMPRE que o usuário mencionar: estoque, farmácia, lotes, validade, Stock-First, insumos, pharma, compostos disponíveis, ordem de compra, fornecedor, inventário, dispensação, movimentação de estoque, entrada de medicamento, saída de medicamento, ajuste de inventário, lote vencido, ou qualquer tarefa relacionada a gestão de medicamentos, vitaminas, suplementos e compostos no NEXUS. Este skill é a plataforma de farmácia do NEXUS — se o usuário menciona qualquer operação de estoque, prescrição baseada em disponibilidade, ou administração de insumos clínicos, use-o imediatamente.
Motor completo de geracão de protocolos clínicos do Ecossistema NEXUS. Use este skill SEMPRE que o usuário mencionar: protocolo clínico, gerar protocolo, NEXUS, Modus Operandi, EndoInject, LabPro, iMeddis, BodyScan3D, Lifestyle, TRH, objetivo terapêutico, trigger clínico, prescrição médica, farmacopeia, paciente NEXUS ID, contexto clínico, PDF de protocolo, pré-visualização de protocolo, ou qualquer tarefa relacionada a medicina personalizada e protocolos de saúde. Também use quando o usuário quiser entender a lógica clínica do NEXUS, validar regras de decisão, ou criar/editar conteúdo clínico para o ecossistema. Este skill é o cérebro clínico do NEXUS — se a conversa toca em saúde personalizada, protocolos ou o ecossistema NEXUS de qualquer forma, use-o.
NEXUS Creator — O segundo criador do NEXUS. Skill semi-autonoma que audita, corrige, poli e expande o ecossistema clinico NEXUS. Use quando quiser: auditar qualidade geral do app (dark mode, acentuacao, UX), corrigir problemas em batch, polir paginas/componentes, ou criar novos modulos. Tambem ativa quando o usuario diz 'finalizar o app', 'polir', 'refinar', 'revisar tudo', 'quality check', 'auditoria geral'.
Safe deployment pipeline skill for NEXUS. Runs pre-flight checks (TypeScript, build, tests, slop audit, security), executes Firebase deploy, and validates with post-deploy health checks. Always load nexus-core first. Prevents broken deploys during the critical launch phase.
Dead code detection and removal skill for NEXUS. Finds and eliminates unused imports, orphan exports, ghost components, dead types, console.logs, commented code, unused dependencies, and stale TODO/FIXME comments. Three modes: audit (report only), clean (safe removals), deep (aggressive with confirmation). Always load nexus-core first.