## Asset Header

- **Asset ID:** ARQ-XX-DOIX-Corp-EspecificacionesTecnicas-v01
- **Version:** v01
- **Status:** Draft
- **Owner:** Victor Heredia
- **IntellBank:** IB-XX-Maestro
- **Tipo:** ARQ — Architecture
- **Propósito:** SherpaX — Especificaciones Técnicas para Implementación Empresarial
- **Última actualización:** 2026-04-11

---

# SherpaX — Especificaciones Técnicas para Implementación Empresarial
**EmpowerLabs · Documento Ejecutivo · Confidencial**

---

## ¿Qué es SherpaX?

SherpaX es un sistema de asistente personal con inteligencia artificial diseñado para ejecutivos. Cada ejecutivo tiene un Sherpa propio — un agente de IA que lo conoce, recuerda su contexto y crece con él sesión tras sesión.

No es un chatbot genérico. Es un asistente que sabe quién eres, en qué proyectos estás, cómo piensas, y qué ocurrió la última vez que trabajaron juntos. La diferencia es la memoria: persistente, estructurada y semánticamente buscable.

---

## Estado actual del sistema

SherpaX está en producción. Los componentes que lo conforman son:

### Motor de memoria — BrainOS

El corazón del sistema es BrainOS, una base de conocimiento personal por ejecutivo. Cada pensamiento, decisión, insight o contexto capturado durante las sesiones queda almacenado con embeddings vectoriales, lo que permite recuperarlo por similitud semántica — no solo por palabras clave exactas.

La infraestructura actual corre sobre AWS EC2 con PostgreSQL 16 y pgvector como motor de búsqueda semántica. El modelo de datos es multitenant con schema aislado por cliente, lo que garantiza que la información de cada ejecutivo es completamente separada de los demás.

### Protocolo de comunicación — MCP

El Sherpa se conecta al BrainOS de cada cliente a través de un servidor MCP (Model Context Protocol) propio, desplegado en infraestructura de EmpowerLabs. Este servidor expone cuatro operaciones: capturar un pensamiento, buscar en la memoria, listar pensamientos recientes y obtener estadísticas. La autenticación es por API key única por cliente.

### Interfaz de trabajo — Cowork

El ejecutivo interactúa con su Sherpa a través de Cowork, una aplicación de escritorio que integra el agente de IA con el sistema de archivos local del usuario. El Sherpa lee los documentos del workspace del cliente, puede hacer referencia a ellos, extraer insights y capturarlos al BrainOS.

### Protocolo de identidad — CLAUDE.md + SEED files

Cada Sherpa se personaliza con un archivo de inicialización (CLAUDE.md) que define su nombre, el perfil del cliente, el tono de trabajo y los protocolos de operación. En la primera sesión, el Sherpa conduce automáticamente una Entrevista de Identidad para cargar el contexto inicial del ejecutivo.

---

## Capacidades actuales

**Memoria continua entre sesiones.** El Sherpa recuerda lo que se habló en sesiones anteriores y retoma el contexto sin que el ejecutivo tenga que repetirse.

**Captura automática de conocimiento.** Durante cada sesión, el Sherpa identifica y almacena decisiones, insights, proyectos y contexto relevante sin interrumpir el flujo de trabajo.

**Búsqueda semántica.** El ejecutivo puede preguntar por temas o proyectos en lenguaje natural y el Sherpa recupera el contexto relevante de su historial aunque las palabras exactas no coincidan.

**Onboarding autónomo.** El sistema detecta automáticamente cuándo es la primera sesión de un cliente y conduce la Entrevista de Identidad sin intervención del equipo de EmpowerLabs.

**Personalización por ejecutivo.** Cada Sherpa tiene nombre propio, conoce la organización del cliente, su sector, su estilo de trabajo y sus proyectos activos.

**Escalabilidad multitenant.** La arquitectura permite agregar nuevos ejecutivos en minutos, con datos completamente aislados entre clientes.

---

## Potencial futuro del sistema

La arquitectura actual está diseñada para crecer. Las capacidades que se habilitarán en las próximas etapas incluyen:

**Inteligencia organizacional.** Cuando múltiples ejecutivos de una misma organización usan SherpaX, el sistema podrá generar una visión consolidada del estado de la organización — qué proyectos están activos, qué temas concentran la atención del equipo, qué señales de atención emergen de forma transversal. Todo esto sin que ningún ejecutivo tenga que producir reportes: el conocimiento ya está en el sistema.

**Análisis de actividad por períodos.** El historial de cada ejecutivo permitirá identificar tendencias, comparar el foco de atención entre semanas o meses, y detectar desalineaciones entre lo que los líderes dicen que es prioritario y lo que realmente ocupa su tiempo.

**Alertas y señales tempranas.** El sistema podrá identificar automáticamente cuando un tema recurrente no avanza, cuando un proyecto lleva tiempo sin actividad o cuando emerge una preocupación compartida entre varios ejecutivos.

**Integración con sistemas empresariales.** La arquitectura MCP está diseñada para conectarse con herramientas externas — CRMs, ERPs, plataformas de gestión de proyectos — enriqueciendo el contexto del Sherpa con información operativa en tiempo real.

---

## Consideraciones de seguridad

Este apartado es relevante para organizaciones con políticas de seguridad informática activas, especialmente en sectores regulados como logística, finanzas o salud.

### Aislamiento de datos

Cada ejecutivo tiene un schema de base de datos completamente independiente. No existe ninguna consulta que pueda cruzar datos entre clientes. El aislamiento es a nivel de base de datos, no solo a nivel de aplicación.

### Autenticación por API key

El acceso al BrainOS de cada ejecutivo requiere una API key de 64 caracteres generada criptográficamente (openssl rand -hex 32). Esta key no se almacena en texto plano en ningún sistema de gestión de contraseñas externo — vive en el servidor de EmpowerLabs y en el conector del cliente en Cowork.

### Comunicación cifrada

Toda la comunicación entre Cowork y el servidor MCP ocurre sobre HTTPS con certificados SSL/TLS gestionados por Let's Encrypt. No existe ninguna comunicación en texto plano.

### Infraestructura en la nube

El servidor MCP corre en AWS EC2 en una instancia dedicada. El acceso al servidor está restringido por grupos de seguridad de AWS — solo los puertos necesarios están abiertos (443 para HTTPS, 22 para administración con llave SSH). No hay acceso por contraseña al servidor.

### Modelo de datos

Los pensamientos almacenados en BrainOS son texto plano estructurado con metadata. No se almacenan credenciales, contraseñas, datos financieros ni información personal sensible más allá del contexto profesional que el propio ejecutivo decide compartir con su Sherpa.

### Opción de instancia privada

Para organizaciones con requisitos de soberanía de datos, SherpaX puede desplegarse en infraestructura propia de la empresa. Esto implica una instancia EC2 en la cuenta AWS del cliente, con la base de datos y el servidor MCP completamente bajo el control de la organización. EmpowerLabs provee la instalación, configuración y soporte — los datos nunca salen de la infraestructura del cliente.

### Acceso del proveedor

En el modelo estándar (infraestructura EmpowerLabs), el equipo técnico de EmpowerLabs tiene acceso administrativo al servidor. Este acceso es necesario para mantenimiento, actualizaciones y soporte. Para organizaciones que requieran garantías adicionales, el modelo de instancia privada elimina este vector.

### Retención y eliminación de datos

Los datos de un cliente pueden eliminarse completamente en cualquier momento eliminando su schema de PostgreSQL. No existe retención involuntaria — la eliminación es irreversible e inmediata.

---

## Requerimientos para una implementación empresarial

**Por cada ejecutivo a incorporar:** nombre, organización, rol, proyectos activos al momento de la instalación, y una dirección de correo de contacto.

**Por parte del cliente:** acceso a Cowork (aplicación de escritorio, disponible para Mac y Windows) y una carpeta de trabajo designada como workspace del Sherpa.

**Tiempo de instalación por ejecutivo:** entre 25 y 45 minutos incluyendo la Sesión de Ignición inicial.

**Para un equipo de 6-8 ejecutivos:** implementación escalonada recomendada en 2-3 semanas, con soporte de EmpowerLabs durante el periodo de adopción.

---

*EmpowerLabs · SherpaX · Documento ejecutivo confidencial · 2026-04-09*
