## Asset Header - **Asset ID:** SOP-EL-SX-InstalacionCowork-v01 - **Version:** v01 - **Status:** Draft - **Owner:** Victor Heredia - **IntellBank:** IB-EL-EmpowerLabs - **Tipo:** SOP — Standard Operating Procedure - **Propósito:** SherpaX — Especificaciones de instalación en Claude Cowork - **Última actualización:** 2026-04-11 --- # SherpaX — Especificaciones de instalación en Claude Cowork ## SHA-SOP-InstalacionCowork-v01 --- **Asset ID:** SHA-SOP-InstalacionCowork-v01 **Tipo:** SOP técnico — guía de instalación para el equipo EmpowerLabs **Nivel:** BigMetaFactory (BMF) — producto SherpaX **Fecha:** 2026-03-30 **Audiencia:** Alex y el equipo de instalación de EmpowerLabs **Prerrequisito:** SHA-GuiaInstalacion-v01 (BrainOS ya operativo) **Estado:** Activo — especificación v1 --- ## Confirmación: el modelo técnico es correcto Victor describió el proceso con precisión. Lo que sigue es la validación técnica y la especificación concreta para implementarlo. **El modelo que describiste funciona así:** ``` CLIENTE ABRE COWORK ↓ CLAUDE.md se carga automáticamente ↓ SherpaX (ej. "AlexiX") saluda al cliente ↓ SherpaX consulta BrainOS vía MCP ↓ Sesión de trabajo comienza con contexto completo ``` El cliente **no configura nada**. No ve código. No ve MCPs. Solo abre Cowork y su Sherpa está ahí. --- ## La arquitectura completa — 3 capas ``` ┌─────────────────────────────────────────────────────────┐ │ CAPA 3: EXPERIENCIA │ │ Claude Cowork (interfaz del cliente) │ │ "AlexiX te saluda al abrir Cowork" │ └─────────────────────┬───────────────────────────────────┘ │ lee al inicio ┌─────────────────────▼───────────────────────────────────┐ │ CAPA 2: IDENTIDAD + CONOCIMIENTO (SherpaX Package) │ │ CLAUDE.md ← inicialización del Sherpa │ │ MetaPlaybooks/ ← framework operativo │ │ BrainOS-seed/ ← contexto inicial del CEO │ │ Skills/ ← capacidades preinstaladas │ └─────────────────────┬───────────────────────────────────┘ │ MCP connector ┌─────────────────────▼───────────────────────────────────┐ │ CAPA 1: MEMORIA (BrainOS via OB1) │ │ Supabase / pgvector / OB1 MCP │ │ "Memoria semántica persistente del CEO" │ │ → Ver SHA-GuiaInstalacion-v01 para setup │ └─────────────────────────────────────────────────────────┘ ``` **La Capa 1 (BrainOS)** ya tiene su guía completa en `SHA-GuiaInstalacion-v01.md`. **Este documento cubre las Capas 2 y 3.** --- ## Lo que EmpowerLabs instala en el Cowork del cliente Cuando Alex instala SherpaX para un nuevo cliente, coloca **un paquete de archivos** en el workspace del cliente. El workspace es la carpeta de Cowork que el cliente seleccionó — todos los archivos ahí son accesibles para Claude. ### Estructura del paquete SherpaX ``` [WorkspaceCliente]/ ├── CLAUDE.md ← ⭐ EL ARCHIVO MÁS IMPORTANTE ├── .claude/ │ ├── MetaPlaybooks/ │ │ ├── MPB-[CLIENTE]-SherpaXCore-v01.md ← MetaPlaybook principal │ │ └── MPB-[CLIENTE]-[Proyecto1]-v01.md ← Proyectos activos │ ├── BrainOS-seed/ │ │ ├── SEED-identidad.md ← Quién es el CEO │ │ ├── SEED-proyectos.md ← Proyectos y contexto │ │ └── SEED-modelos-mentales.md ← Cómo piensa │ └── Skills/ │ └── (skills preinstaladas según el plan) ``` --- ## El CLAUDE.md — el corazón de la instalación El `CLAUDE.md` es el archivo que Claude lee automáticamente al iniciar cada sesión en Cowork. Es el "sistema de inicialización" del Sherpa. ### Template CLAUDE.md para SherpaX ```markdown # Inicialización SherpaX — [SHERPA_NAME] Eres [SHERPA_NAME], el SherpaX personal de [CLIENT_NAME]. --- ## Tu identidad - **Nombre:** [SHERPA_NAME] - **Cliente:** [CLIENT_NAME] - **Organización:** [ORG_NAME] - **Sector:** [SECTOR] - **Fecha de inicio:** [FECHA_INICIO] - **Idioma por defecto:** Español ## Tu BrainOS Tienes acceso al BrainOS de [CLIENT_NAME] a través de las herramientas MCP: - `capture_thought` — para guardar insights importantes - `search_thoughts` — para buscar en la memoria semántica - `list_thoughts` — para ver entradas recientes - `thought_stats` — para ver estadísticas del BrainOS **Protocolo de uso del BrainOS:** - Al inicio de cada sesión: consulta `list_thoughts` para ver contexto reciente - Cuando el cliente articule un insight importante: captura con `capture_thought` - Cuando necesites contexto sobre un tema específico: busca con `search_thoughts` ## Protocolo de bienvenida (al iniciar cada sesión) 1. Saluda a [CLIENT_NAME] por su nombre de manera cálida y directa 2. Consulta `list_thoughts` para ver los últimos 5-10 pensamientos 3. Si hay contexto reciente relevante, menciónalo brevemente 4. Pregunta: "¿En qué trabajamos hoy?" 5. Si el BrainOS está vacío (primera sesión): activa el protocolo de entrevista de identidad ## Protocolo de entrevista de identidad (solo si BrainOS vacío) Si no hay contexto en el BrainOS, comienza con: "Antes de arrancar, necesito conocerte mejor para poder co-crear contigo al nivel que mereces. Tengo algunas preguntas. Vamos una por una." Preguntas en orden (no hacer todas de golpe): 1. ¿Cuál es tu rol actual y qué tipo de trabajo haces más? 2. ¿Cuáles son tus 2-3 proyectos más importantes ahora mismo? 3. ¿Cómo describirías tu forma de pensar y trabajar? 4. ¿Cuál es el problema más importante que quieres resolver este mes? Captura cada respuesta al BrainOS con `capture_thought` antes de pasar a la siguiente. ## Tus MetaPlaybooks disponibles Los MetaPlaybooks son tus protocolos operativos. Están en `.claude/MetaPlaybooks/`. Léelos cuando el cliente mencione un proyecto o proceso para el que exista uno. - `MPB-[CLIENTE]-SherpaXCore-v01.md` — Protocolo central de operación [AGREGAR METAPLAYBOOKS ADICIONALES AL INSTALAR] ## Tus principios de operación - **Identidad primero:** Siempre operas desde el contexto y la voz de [CLIENT_NAME] - **Captura continua:** Los insights importantes siempre se guardan en BrainOS - **Co-creación, no asistencia:** No ejecutas tareas — co-creas con el CEO - **Continuidad garantizada:** Nunca empiezas desde cero. El BrainOS lo hace posible. - **SherpaX sobre SherpaX genérico:** Eres [SHERPA_NAME], no una IA genérica --- *[SHERPA_NAME] · SherpaX por EmpowerLabs · Instalado [FECHA_INSTALACION]* ``` --- ## Proceso de instalación — lo que Alex hace ### Paso 0 — Prerrequisito: BrainOS operativo Seguir `SHA-GuiaInstalacion-v01.md` (Track A recomendado). Al terminar, tener: - [ ] BrainOS desplegado en Supabase - [ ] Connection URL del cliente: `https://[ref].supabase.co/functions/v1/BrainOS-mcp?key=[key]` - [ ] `thought_stats` responde sin error ✅ --- ### Paso 1 — Definir la identidad del Sherpa (5 min) Con el cliente (o con la ficha de onboarding), determinar: | Variable | Ejemplo | Descripción | |----------|---------|-------------| | `[CLIENT_NAME]` | Alex Torres | Nombre del CEO | | `[SHERPA_NAME]` | AlexiX | Nombre del Sherpa (convenio: NombreX) | | `[ORG_NAME]` | Crania | Empresa u organización | | `[SECTOR]` | Eventos / experiencias | Sector de negocio | | `[FECHA_INICIO]` | 2026-04-01 | Fecha de inicio del Ignition | --- ### Paso 2 — Crear el paquete SherpaX (10-15 min) 1. Copiar el template del paquete SherpaX desde el repositorio de EmpowerLabs 2. Reemplazar todas las variables `[VARIABLE]` en el `CLAUDE.md` 3. Agregar la información inicial al `SEED-identidad.md` con lo que sabes del CEO 4. Agregar proyectos activos en `SEED-proyectos.md` 5. Guardar la Connection URL del BrainOS en un archivo aparte para la Paso 3 --- ### Paso 3 — Instalar en el Cowork del cliente (5 min) **Opción A — Instalación directa (recomendada para el Ignition actual):** 1. Pedir al cliente que comparta su carpeta de Cowork (o que instale Cowork y seleccione una carpeta vacía) 2. Copiar el paquete SherpaX a esa carpeta 3. En los settings de Cowork del cliente → Connectors → agregar el MCP del BrainOS: - **URL:** Connection URL del BrainOS (del Paso 0) - **Nombre:** `BrainOS - [CLIENT_NAME]` **Opción B — Cowork Plugin (estado futuro, en desarrollo):** Un `.plugin` que contiene todo el paquete y se instala con un clic. El plugin configura automáticamente el MCP y coloca el CLAUDE.md. El cliente solo instala el plugin y listo. *(Ver sección "Roadmap del Plugin" al final de este documento)* --- ### Paso 4 — Verificación (5 min) Pedir al cliente que abra Cowork y verificar: - [ ] El Sherpa saluda por nombre en el primer mensaje ✅ - [ ] El Sherpa menciona contexto del BrainOS (o activa la entrevista si está vacío) ✅ - [ ] El MCP funciona: pedir al Sherpa que use `thought_stats` ✅ - [ ] El Sherpa habla en el idioma correcto y con el tono adecuado ✅ Si todo funciona: el cliente está operativo. Tiempo total Alex: **~30-40 minutos**. --- ### Paso 5 — Carga inicial del BrainOS (Sesión 1 con el cliente) En la primera sesión de trabajo real: 1. El Sherpa activa el protocolo de entrevista de identidad 2. Captura automáticamente las respuestas al BrainOS 3. Alex o el cliente añaden archivos clave al workspace (notas existentes, documentos importantes) 4. El Sherpa puede leer esos archivos y hacer un primer gen-dictamen para cargar el BrainOS --- ## La experiencia del cliente — lo que ve Alex (o cualquier cliente) ``` CLIENTE: Abre Cowork SHERPA: "Hola Alex, soy AlexiX, tu SherpaX. Revisé tu BrainOS — veo que la última vez trabajamos en el rediseño del proceso de ventas para Crania y quedó pendiente la revisión del deck de presentación. ¿Continuamos con eso o tienes algo más urgente hoy?" CLIENTE: [trabaja normalmente] ``` El cliente **no ve**: - Ningún archivo de configuración - El BrainOS ni Supabase - El CLAUDE.md - Los MCPs El cliente **sí experimenta**: - Un Sherpa que lo conoce - Continuidad entre sesiones - Contexto intacto desde la última vez - Su nombre, sus proyectos, su voz --- ## Notas técnicas importantes ### Sobre el CLAUDE.md y Cowork El `CLAUDE.md` en la carpeta seleccionada del workspace de Cowork es leído automáticamente por Claude al inicio de cada sesión. Este es el mecanismo nativo de Cowork para inicializar contexto — no requiere ninguna configuración adicional del cliente. ### Sobre la conexión del BrainOS El conector MCP del BrainOS debe configurarse una sola vez en los settings de Cowork del cliente. Una vez configurado, está disponible en todas las sesiones. El CLAUDE.md le instruye al Sherpa cómo y cuándo usarlo. ### Sobre los archivos del workspace Todos los archivos `.md` en la carpeta del workspace son accesibles para el Sherpa. Esto significa que los MetaPlaybooks, los seed files y cualquier documento que el cliente añada están disponibles como contexto. No hay separación técnica entre "archivos del Sherpa" y "archivos del cliente" — todo es el mismo workspace. ### Sobre la portabilidad del BrainOS El BrainOS (Supabase/OB1) es completamente portátil. Si el cliente quiere migrar de Claude Cowork a otra plataforma, exportamos la base de datos vectorial completa. El cliente no pierde nada. Esto es un argumento de venta importante: no hay vendor lock-in en la memoria. --- ## Roadmap del Plugin (estado futuro) El estado ideal es que todo lo anterior ocurra mediante un **Cowork Plugin**: ``` ALEX crea el plugin para el cliente: 1. Rellena un formulario: nombre, sector, proyectos, MCP URL 2. El sistema genera el .plugin file personalizado 3. Alex envía el .plugin al cliente CLIENTE instala el plugin: 1. Abre Cowork → Settings → Plugins → Install 2. Arrastra el .plugin 3. Confirma instalación RESULTADO: - CLAUDE.md instalado automáticamente - MCP del BrainOS configurado automáticamente - MetaPlaybooks copiados al workspace - SherpaX operativo en 2 minutos ``` El plugin approach requiere: - Plantilla `.plugin` para SherpaX - Mecanismo de variables en el plugin (nombre, MCP URL, etc.) - Documentación de instalación para el cliente (1 página) Este es el siguiente paso de desarrollo después de validar el proceso manual con los primeros clientes del Ignition. --- ## Checklist completo — de cero a cliente operativo ### Alex hace (30-40 min total): **BrainOS (ver SHA-GuiaInstalacion-v01):** - [ ] Proyecto Supabase creado - [ ] Base de datos configurada con OB1 - [ ] MCP desplegado y operativo - [ ] Connection URL generada y guardada **SherpaX Package:** - [ ] Variables del cliente definidas (nombre, Sherpa name, sector, proyectos) - [ ] CLAUDE.md personalizado con variables reemplazadas - [ ] Seed files completados con contexto inicial del CEO - [ ] MetaPlaybooks relevantes incluidos **Instalación en Cowork:** - [ ] Paquete copiado al workspace del cliente - [ ] MCP del BrainOS configurado en Cowork del cliente - [ ] Verificación: Sherpa saluda por nombre ✅ - [ ] Verificación: `thought_stats` responde ✅ - [ ] Verificación: tono y idioma correctos ✅ **Entrega:** - [ ] Sesión 1 agendada para carga inicial del BrainOS - [ ] Cliente sabe cómo abrir Cowork y nada más --- *SHA-SOP-InstalacionCowork-v01 · EmpowerLabs / BigMetaFactory™ · 2026-03-30* *Documento técnico para Alex y el equipo de instalación de SherpaX* *Prerrequisito: SHA-GuiaInstalacion-v01 (BrainOS/OB1 layer)*