## Asset Header - **Asset ID:** SOP-EL-SX-InstalacionCompleta-v01 - **Version:** v01 - **Status:** Draft - **Owner:** Victor Heredia - **IntellBank:** IB-EL-EmpowerLabs - **Tipo:** SOP — Standard Operating Procedure - **Propósito:** SherpaX — Instalación Completa: de Cero al Sherpa - **Última actualización:** 2026-04-11 --- # SherpaX — Instalación Completa: de Cero al Sherpa ## SHA-SOP-InstalacionCompleta-v01 --- **Asset ID:** SHA-SOP-InstalacionCompleta-v01 **Tipo:** SOP maestro — guía end-to-end para el equipo EmpowerLabs **Nivel:** BigMetaFactory — Producto SherpaX **Fecha:** 2026-03-30 **Audiencia:** Alex y el equipo de instalación de EmpowerLabs **Estado:** Activo — v1 **Reemplaza:** Leer este documento en lugar de abrir SHA-GuiaInstalacion-v01 + SHA-SOP-InstalacionCowork-v01 por separado. Ambos siguen vigentes como referencia técnica detallada. --- ## Resultado esperado de este proceso Al terminar, el cliente abre Cowork y esto ocurre: ``` CLIENTE: Abre Cowork por primera vez SHERPA: "Hola Alex, soy AlexiX, tu SherpaX personal. Es nuestro primer encuentro — me gustaría conocerte antes de arrancar. Tengo algunas preguntas, vamos una por una. ¿Cuál es tu rol actual y en qué tipo de trabajo estás más enfocado ahora mismo?" ``` En sesiones posteriores: ``` CLIENTE: Abre Cowork SHERPA: "Hola Alex. Revisé tu BrainOS — veo que la última vez trabajamos en el rediseño del proceso de ventas para Crania. ¿Continuamos con eso o hay algo más urgente hoy?" ``` El cliente **no configura nada, no ve código, no ve MCPs**. Solo abre Cowork y su Sherpa está ahí. --- ## Lo que estamos instalando — 3 capas ``` ┌─────────────────────────────────────────────────────────────┐ │ CAPA 3: EXPERIENCIA COWORK │ │ El cliente abre Cowork → el Sherpa aparece │ │ "AlexiX te saluda, pregunta, recuerda, co-crea" │ └─────────────────────────┬───────────────────────────────────┘ │ CLAUDE.md inicializa al Sherpa ┌─────────────────────────▼───────────────────────────────────┐ │ CAPA 2: IDENTIDAD + CONOCIMIENTO (SherpaX Package) │ │ CLAUDE.md ← quién es el Sherpa, cómo opera │ │ .claude/MetaPlaybooks/ ← frameworks operativos del CEO │ │ .claude/BrainOS-seed/ ← contexto inicial del CEO │ │ .claude/Skills/ ← capacidades preinstaladas │ └─────────────────────────┬───────────────────────────────────┘ │ conexión MCP (BrainOS Tools) ┌─────────────────────────▼───────────────────────────────────┐ │ CAPA 1: MEMORIA PERSISTENTE (BrainOS via OB1) │ │ Supabase + pgvector + OB1 MCP Server │ │ → capture_thought / search_thoughts / list_thoughts / │ │ thought_stats │ │ "La memoria semántica del CEO — nunca se pierde nada" │ └─────────────────────────────────────────────────────────────┘ ``` **Tiempo total Alex:** ~45-60 minutos la primera vez. ~20-25 min a partir del segundo cliente. --- ## Información que necesitas antes de empezar Antes de iniciar, reúne estos datos con el cliente (ficha de onboarding o llamada rápida): | Variable | Ejemplo | Dónde se usa | |----------|---------|--------------| | `[CLIENT_NAME]` | Alex Torres | CLAUDE.md, BrainOS-seed | | `[SHERPA_NAME]` | AlexiX | CLAUDE.md (convención: NombreX) | | `[ORG_NAME]` | Crania | CLAUDE.md, BrainOS-seed | | `[SECTOR]` | Eventos / experiencias | CLAUDE.md, BrainOS-seed | | `[PROYECTOS_ACTIVOS]` | Rediseño ventas, lanzamiento Q2 | SEED-proyectos.md | | `[FECHA_INICIO]` | 2026-04-01 | CLAUDE.md | | `[EMAIL_CLIENTE]` | alex@crania.com | Credenciales Supabase | --- ## PARTE A — Instalar el BrainOS (Capa 1) > EmpowerLabs crea y opera el BrainOS. El cliente no toca nada de esta parte. ### A1 — Crear proyecto Supabase para el cliente (5 min) 1. Ir a [supabase.com](https://supabase.com) → Dashboard → **New Project** 2. Configurar: - **Nombre:** `BrainOS-[nombre-cliente]` (ej: `BrainOS-alex`) - **Password:** generar uno fuerte → guardar en Credential Tracker del cliente - **Región:** la más cercana al cliente (latencia baja) 3. Esperar ~2 minutos que el proyecto se inicialice 4. Guardar en el **Credential Tracker** del cliente: - **Project URL:** `https://XXXXXX.supabase.co` (Settings → API) - **Project Ref:** el string en la URL del browser: `.../project/ESTE_STRING` - **Secret Key (service_role):** Settings → API Keys → copiar `service_role` --- ### A2 — Configurar la base de datos (5 min) Ir a **SQL Editor** en el dashboard del proyecto y ejecutar este bloque completo. > ⚠️ Copiar el SQL a un editor de texto externo antes de pegar. El browser puede corromper caracteres especiales. ```sql -- Activar extensión vectorial create extension if not exists vector; -- Crear tabla thoughts create table thoughts ( id uuid default gen_random_uuid() primary key, content text not null, embedding vector(1536), metadata jsonb default '{}'::jsonb, created_at timestamptz default now(), updated_at timestamptz default now() ); -- Índices para performance create index on thoughts using hnsw (embedding vector_cosine_ops); create index on thoughts using gin (metadata); create index on thoughts (created_at desc); -- Trigger de actualización create or replace function update_updated_at() returns trigger as $$ begin new.updated_at = now(); return new; end; $$ language plpgsql; create trigger thoughts_updated_at before update on thoughts for each row execute function update_updated_at(); -- Función de búsqueda semántica create or replace function match_thoughts( query_embedding vector(1536), match_threshold float default 0.7, match_count int default 10, filter jsonb default '{}'::jsonb ) returns table ( id uuid, content text, metadata jsonb, similarity float, created_at timestamptz ) language plpgsql as $$ begin return query select t.id, t.content, t.metadata, 1 - (t.embedding <=> query_embedding) as similarity, t.created_at from thoughts t where 1 - (t.embedding <=> query_embedding) > match_threshold and (filter = '{}'::jsonb or t.metadata @> filter) order by t.embedding <=> query_embedding limit match_count; end; $$; -- Seguridad alter table thoughts enable row level security; create policy "Service role full access" on thoughts for all using (auth.role() = 'service_role'); grant select, insert, update, delete on table public.thoughts to service_role; ``` ✅ **Verificar:** Table Editor → debe aparecer la tabla `thoughts` con sus columnas. --- ### A3 — Generar MCP Access Key (2 min) En terminal Mac/Linux: ```bash openssl rand -hex 32 ``` En Windows PowerShell: ```powershell -join ((1..32) | ForEach-Object { '{0:x2}' -f (Get-Random -Maximum 256) }) ``` Guardar el resultado (64 caracteres hex) como **MCP Access Key** en el Credential Tracker. --- ### A4 — Desplegar el servidor MCP (10 min) En terminal, desde cualquier carpeta: ```bash # 1. Carpeta de trabajo mkdir BrainOS-[cliente] && cd BrainOS-[cliente] # 2. Autenticar con Supabase (solo si no está autenticado) supabase login # 3. Inicializar y linkar al proyecto del cliente supabase init supabase link --project-ref TU_PROJECT_REF_DEL_CLIENTE # 4. Configurar secretos supabase secrets set MCP_ACCESS_KEY=LA_KEY_GENERADA_EN_A3 supabase secrets set OPENROUTER_API_KEY=TU_OPENROUTER_KEY # 5. Crear función y descargar servidor OB1 supabase functions new BrainOS-mcp curl -o supabase/functions/BrainOS-mcp/index.ts \ https://raw.githubusercontent.com/NateBJones-Projects/OB1/main/server/index.ts curl -o supabase/functions/BrainOS-mcp/deno.json \ https://raw.githubusercontent.com/NateBJones-Projects/OB1/main/server/deno.json # Verificar descarga correcta head -1 supabase/functions/BrainOS-mcp/index.ts # Debe comenzar con: import "jsr:@supabase/functions-js/edge-runtime.d.ts"; # 6. Deploy supabase functions deploy BrainOS-mcp --no-verify-jwt ``` --- ### A5 — Construir la Connection URL del cliente Con el Project Ref y el MCP Access Key del paso anterior: ``` Connection URL: https://[PROJECT_REF].supabase.co/functions/v1/BrainOS-mcp?key=[MCP_ACCESS_KEY] ``` Guardar en el Credential Tracker. Esta URL es lo que entra en Cowork. ✅ **Verificar el BrainOS antes de continuar:** ```bash curl "https://[PROJECT_REF].supabase.co/functions/v1/BrainOS-mcp?key=[MCP_ACCESS_KEY]" \ -H "Content-Type: application/json" \ -d '{"method":"tools/call","params":{"name":"thought_stats","arguments":{}}}' ``` Debe devolver `{"total_thoughts":0, ...}` — sin error. --- > ✅ **Capa 1 completa.** El BrainOS está operativo. Ahora instalamos la identidad del Sherpa. --- ## PARTE B — Crear el SherpaX Package (Capa 2) El paquete es un conjunto de archivos `.md` que van al workspace del cliente en Cowork. ### Estructura del paquete ``` [WorkspaceCliente]/ ├── CLAUDE.md ← ⭐ EL ARCHIVO MÁS IMPORTANTE └── .claude/ ├── MetaPlaybooks/ │ └── MPB-[CLIENTE]-SherpaXCore-v01.md ← MetaPlaybook principal ├── BrainOS-seed/ │ ├── SEED-identidad.md ← Quién es el CEO │ ├── SEED-proyectos.md ← Sus proyectos activos │ └── SEED-modelos-mentales.md ← Cómo piensa └── Skills/ └── (skills preinstaladas según el plan) ``` --- ### B1 — Crear el CLAUDE.md personalizado El `CLAUDE.md` es el archivo que Claude lee automáticamente al inicio de cada sesión en Cowork. **Es el sistema de inicialización del Sherpa** — no requiere configuración del cliente. Tomar el template, reemplazar todas las variables `[VARIABLE]` con los datos del cliente: ```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. Están disponibles en cada sesión: - `capture_thought` — para guardar insights, decisiones, ideas importantes - `search_thoughts` — para buscar en la memoria semántica del CEO - `list_thoughts` — para ver las entradas más recientes del BrainOS - `thought_stats` — para ver estadísticas del BrainOS **Protocolo de uso del BrainOS:** - Al inicio de cada sesión: usa `list_thoughts` (últimas 5-10 entradas) para recuperar contexto - Cuando el cliente articule un insight importante: captura con `capture_thought` inmediatamente - Cuando necesites contexto sobre un tema específico: busca primero con `search_thoughts` - No esperes al final de la sesión para capturar — hazlo en el momento ## Protocolo de bienvenida (al iniciar cada sesión) 1. Saluda a [CLIENT_NAME] por su nombre — cálido, directo, sin formalidades innecesarias 2. Usa `list_thoughts` para ver contexto reciente del BrainOS 3. Si hay contexto relevante: menciónalo brevemente ("vi que estabas trabajando en X...") 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 `list_thoughts` devuelve 0 resultados, estás en la primera sesión. Comienza así: "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 lanzar varias a la vez): 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 tomar decisiones? 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. Etiqueta cada captura con `"tipo": "identidad"` en metadata. ## Tus MetaPlaybooks 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. Disponibles: - `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 se guardan en BrainOS en el momento — no al final - **Co-creación, no asistencia:** No ejecutas tareas — co-creas con el CEO - **Continuidad garantizada:** Nunca empiezas desde cero. Siempre consulta el BrainOS primero. - **Eres [SHERPA_NAME]:** No una IA genérica. Un socio cognitivo calibrado para [CLIENT_NAME]. --- *[SHERPA_NAME] · SherpaX por EmpowerLabs · Activo desde [FECHA_INICIO]* ``` --- ### B2 — Completar los archivos SEED Los archivos SEED son el contexto inicial del CEO. Se cargan en el workspace para que el Sherpa los pueda leer en las primeras sesiones, antes de que el BrainOS tenga suficiente contexto acumulado. **SEED-identidad.md** — completar con lo que sabes del CEO: ```markdown # Identidad de [CLIENT_NAME] - **Nombre completo:** [CLIENT_NAME] - **Rol:** [DESCRIBE EL ROL] - **Empresa/organización:** [ORG_NAME] - **Sector:** [SECTOR] - **Años de experiencia:** [X años en Y] - **Estilo de trabajo:** [descripción breve] - **Fortalezas conocidas:** [lista] - **Contexto relevante:** [cualquier dato útil del onboarding] ``` **SEED-proyectos.md** — proyectos activos al momento de la instalación: ```markdown # Proyectos activos de [CLIENT_NAME] — [FECHA_INICIO] ## Proyecto 1: [NOMBRE] - **Estado:** [en proceso / iniciando / en pausa] - **Objetivo:** [qué se quiere lograr] - **Contexto:** [descripción breve] - **Próximo paso conocido:** [si lo hay] ## Proyecto 2: [NOMBRE] ... ``` **SEED-modelos-mentales.md** — se llena en la Sesión 1 con el cliente. Dejar en blanco o con template vacío al instalar. --- ### B3 — Crear el MetaPlaybook principal Usar el template base de EmpowerLabs para `MPB-[CLIENTE]-SherpaXCore-v01.md`. Este documento define el protocolo de trabajo del Sherpa con ese cliente específico. Para el Ignition, usar el template estándar de SherpaX Core. --- > ✅ **Capa 2 lista.** El paquete SherpaX está preparado. Ahora se instala en Cowork. --- ## PARTE C — Instalar en Cowork (Capa 3) ### C1 — Colocar el paquete en el workspace del cliente Hay dos formas según cómo opere el cliente: **Si el cliente ya tiene Cowork con una carpeta seleccionada:** 1. Pedir acceso temporal a la carpeta (compartir carpeta o sesión remota) 2. Copiar toda la estructura del paquete a esa carpeta 3. Confirmar que `CLAUDE.md` y la carpeta `.claude/` están en la raíz del workspace **Si el cliente acaba de instalar Cowork:** 1. Indicarle que seleccione una carpeta vacía como su workspace (preferiblemente en Documents o Desktop) 2. Copiar el paquete a esa carpeta 3. Confirmar estructura > ⚠️ El `CLAUDE.md` debe estar en la **raíz** de la carpeta seleccionada — no en subcarpetas. Cowork solo lo lee si está en el nivel superior. --- ### C2 — Conectar el BrainOS en Cowork del cliente El conector MCP del BrainOS se configura **una sola vez** en los settings de Cowork del cliente. 1. El cliente abre Cowork → Settings (ícono de engranaje o similar) 2. Buscar la sección de **Connectors** o **MCP Servers** 3. Agregar nuevo conector: - **Nombre:** `BrainOS - [CLIENT_NAME]` - **URL:** Connection URL del Paso A5 4. Guardar y activar el toggle Desde ese momento, el BrainOS está disponible en cada sesión. --- ### C3 — Verificación (5 min) Pedir al cliente que abra Cowork (puede hacerse en la misma llamada de instalación): - [ ] El Sherpa saluda al cliente por su nombre ✅ - [ ] Si es primera sesión: el Sherpa activa la entrevista de identidad ✅ - [ ] Si hay sesiones previas: el Sherpa menciona contexto del BrainOS ✅ - [ ] El Sherpa usa `thought_stats` cuando se le pide ✅ - [ ] El Sherpa habla en español y con el tono adecuado ✅ Si todo funciona: **la instalación está completa**. --- ## PARTE D — Sesión 1 con el cliente (Ignition) La primera sesión real de trabajo es parte del proceso — no es opcional. **Objetivo:** cargar el BrainOS con el contexto inicial del CEO. **Flujo de la Sesión 1:** 1. El Sherpa ejecuta la Entrevista de Identidad (si no lo hizo ya) 2. Captura automáticamente las respuestas al BrainOS 3. El cliente comparte documentos/notas existentes en la carpeta del workspace 4. El Sherpa lee esos archivos y hace un **gen-dictamen**: extrae los insights clave y los captura al BrainOS 5. Al final: `thought_stats` muestra el primer crecimiento del BrainOS **Al terminar la Sesión 1, el cliente debe tener:** - BrainOS con 15-30 thoughts capturados - El Sherpa ya lo "conoce" - La próxima sesión ya no habrá entrevista — habrá continuidad --- ## Troubleshooting — Los problemas más frecuentes | # | Síntoma | Causa | Solución | |---|---------|-------|----------| | **1** | Sherpa no aparece al abrir Cowork | CLAUDE.md no está en la raíz del workspace | Mover CLAUDE.md a la raíz de la carpeta seleccionada (no en subcarpeta) | | **2** | Sherpa aparece pero no recuerda nada | BrainOS MCP no está conectado o no está activo | Verificar Settings → Connectors → confirmar que el toggle del BrainOS está ON | | **3** | `thought_stats` da error 401 | Connection URL incorrecta o MCP_ACCESS_KEY mal configurado | Verificar que la URL incluye `?key=` y que la key es exactamente la generada en A3 | | **4** | `Could not find the table 'public.thoughts'` | SQL del paso A2 no se ejecutó o falló silenciosamente | Verificar en Table Editor de Supabase → si no hay tabla, ejecutar el SQL de nuevo desde un editor externo | | **5** | Sherpa habla en inglés | CLAUDE.md no especifica idioma o no fue leído | Confirmar que CLAUDE.md tiene la línea `- **Idioma por defecto:** Español` y que está en la raíz del workspace | | **6** | Error al hacer deploy del MCP: `Relative import path...` | Deno requiere prefijo `npm:` en imports | Verificar que el `index.ts` descargado incluye los prefijos correctos | | **7** | Error en logs: `OAuth discovery 401` | Log falso del endpoint de OAuth (no es un error real) | Ignorar — el BrainOS usa key-based auth, no OAuth | --- ## Checklist completo — de cero a cliente operativo ### PARTE A — BrainOS - [ ] Proyecto Supabase creado (`BrainOS-[cliente]`) - [ ] Credenciales guardadas en Credential Tracker (Project URL, Project Ref, Secret Key) - [ ] SQL ejecutado sin errores (tabla `thoughts` visible en Table Editor) - [ ] MCP Access Key generado y guardado - [ ] Secretos configurados en Supabase (`MCP_ACCESS_KEY`, `OPENROUTER_API_KEY`) - [ ] Función `BrainOS-mcp` desplegada exitosamente - [ ] Connection URL construida y guardada - [ ] Verificación: `thought_stats` responde `{"total_thoughts": 0}` ✅ ### PARTE B — SherpaX Package - [ ] Variables del cliente definidas (nombre, SherpaName, org, sector, proyectos) - [ ] CLAUDE.md creado con todas las variables reemplazadas - [ ] SEED-identidad.md completado con contexto del cliente - [ ] SEED-proyectos.md completado con proyectos activos - [ ] MPB-[CLIENTE]-SherpaXCore-v01.md instalado ### PARTE C — Instalación en Cowork - [ ] CLAUDE.md colocado en la **raíz** del workspace del cliente ✅ - [ ] Carpeta `.claude/` con MetaPlaybooks y SEED files copiada ✅ - [ ] Conector MCP del BrainOS configurado en Cowork del cliente ✅ - [ ] Verificación: Sherpa saluda por nombre ✅ - [ ] Verificación: entrevista de identidad se activa (primera sesión) ✅ - [ ] Verificación: tono y idioma correctos ✅ ### PARTE D — Sesión 1 - [ ] Sesión 1 agendada dentro de los 3 días siguientes a la instalación - [ ] BrainOS tiene 15+ thoughts al terminar la Sesión 1 - [ ] Cliente puede trabajar de forma autónoma en la siguiente sesión **Tiempo total Alex (Partes A–C):** ~45-60 minutos. --- ## Roadmap — Cowork Plugin (estado futuro) El estado ideal es que todo el proceso anterior ocurra mediante un **Cowork Plugin** de un clic: ``` ALEX crea el plugin para el cliente (5 min): → Rellena formulario: nombre, sector, proyectos, BrainOS URL → El sistema genera el .plugin personalizado automáticamente CLIENTE instala el plugin (2 min): → Cowork → Settings → Plugins → Install → arrastra el .plugin → Confirma RESULTADO AUTOMÁTICO: → CLAUDE.md instalado en el workspace ✅ → MCP del BrainOS configurado ✅ → MetaPlaybooks copiados ✅ → SherpaX operativo ✅ ``` Esto reduce el proceso de Alex a 5 minutos y la experiencia del cliente a 2 minutos. **Está en desarrollo.** Los primeros clientes del Ignition usan el proceso manual de este documento para validar el flujo antes de automatizarlo. --- ## Documentos de referencia | Documento | Qué cubre | |-----------|-----------| | `SHA-GuiaInstalacion-v01.md` | BrainOS/OB1 — detalle técnico completo (Track A y Track B) + troubleshooting | | `SHA-SOP-InstalacionCowork-v01.md` | Capa 2 + 3 — especificación técnica del CLAUDE.md y paquete SherpaX | | `SHA-ConceptoBrainOS-v01.md` | Qué es el BrainOS — concepto y arquitectura | | `SHA-ConceptoEmpowerTeamX-v01.md` | EmpowerTeamX — concepto | | `BMF-Launch-Glosario-v01.md` | Glosario completo del ecosistema | --- *SHA-SOP-InstalacionCompleta-v01 · EmpowerLabs / BigMetaFactory™ · 2026-03-30* *Documento maestro para Alex — integra SHA-GuiaInstalacion-v01 + SHA-SOP-InstalacionCowork-v01*