--- asset_id: SP-EL-WORX-SetupSherpaX-Guion-v01 version: v01 tipo: SP — Starter Prompt / Guion ejecutable (procedimiento técnico) status: Active · v01 · Pendiente Ratificación Victor owner: Victor Heredia sherpa: Jay fecha_creacion: 2026-06-08 fecha_ultima_actualizacion: 2026-06-08 intellbank: IB-EL-EmpowerLabs subbank: PB-EL-Project-Bank / PB-WORX-Worx ejecutado_por: /SetupSherpaX actor: Sistemas / Soporte técnico contexto_base: XP-EL-WORX-ArranqueBasico-v01 proposito: Guion del comando /SetupSherpaX que corre sistemas (~10-15 min) para validar la configuración del SherpaX del usuario, escribir su perfil del operador y dejar luz verde. Es el handshake que habilita /ArrancaWorX. referencia_canonica: XP-EL-WORX-ArranqueBasico-v01 · SOP-EL-SX-InstalacionCompleta-v01 · SOP-EL-SX-Instalacion-PrimerColaborador-v01 · SOP-EL-SX-InstalacionCowork-v01 · CP-EL-WORX-EmpowerLabsComoOrganizacion-v01 (matriz §5) tags: [SP, guion, setupsherpax, sistemas, validacion, perfil-operador, luz-verde, handshake, worx] --- # Guion del comando · `/SetupSherpaX` ## Lo que hace sistemas para dejar el SherpaX listo y en luz verde > **Quién lo corre:** sistemas / soporte técnico. **No** el usuario final. > **Cuánto toma:** ~10-15 min. > **Qué NO hace:** no instala Cowork ni contrata el plan de Claude ni instala la IntelliBanks app — eso es el **SOP previo** (ver prerequisitos). `/SetupSherpaX` solo valida lo que ya vive dentro de Cowork, escribe el perfil y enciende la luz verde. > **Resultado:** el usuario puede correr `/ArrancaWorX` y ser reconocido por su SherpaX. --- ## 0. Prerequisitos (SOP previo · fuera del alcance del comando) Antes de correr `/SetupSherpaX`, sistemas ya completó la instalación física: 1. **Cowork instalado** + **plan de Claude** contratado y activo en el equipo del usuario. 2. **Sincronización del vault asegurada** — el SherpaX debe poder leer el vault. Según el caso: **IntelliBanks app** instalada con sesión, **o** **Obsidian sincronizado** con el vault, **o** lo que aplique. Esta es la superficie de lectura; sin ella el SherpaX arranca ciego. 3. **Plugin `worx-empowerlabs` instalado** en el Cowork del usuario. Los comandos WORX viven donde se instala el plugin — **sin esto, ni `/SetupSherpaX` ni `/ArrancaWorX` existen en esa máquina.** Por eso el plugin es prerequisito, no paso interno. 4. **SherpaX del usuario** dado de alta y conectado a Cowork por **MCP**. Referencias canónicas: `SOP-EL-SX-InstalacionCompleta-v01` (end-to-end) · `SOP-EL-SX-InstalacionCowork-v01` (Cowork) · `SOP-EL-SX-Instalacion-PrimerColaborador-v01` (molde por rol). > Si algún prerequisito falta, `/SetupSherpaX` **se detiene** y remite al SOP correspondiente. No improvisa la instalación. --- ## 1. Secuencia del comando (paso a paso para sistemas) ### Paso 1 · Identificar al operador Captura los datos del usuario que se va a dar de alta: - **Nombre** del usuario. - **Rol en EL** (`rol_el`). - **Rol DOIX** en el arranque (`rol_doix`). - **Accesos a IntelliBanks** según la **matriz §5** del `CP-EL-WORX-EmpowerLabsComoOrganizacion-v01`. ### Paso 2 · Validar la conexión MCP del SherpaX **Prueba:** pídele al SherpaX un handshake básico — que responda y confirme que alcanza el IntelliBank del usuario. - ✅ **Pasa:** el SherpaX responde y lee al menos un archivo conocido del vault. - ❌ **Falla:** revisar la conexión MCP en Cowork (servidor activo, credenciales, ruta del vault). No avanzar hasta resolver. Ver `SOP-EL-SX-InstalacionCowork-v01`. ### Paso 3 · Validar la sincronización + lectura del vault **Prueba:** confirma que el usuario puede **leer** el vault por su superficie (IntelliBanks app **o** Obsidian sync), al menos los IntelliBanks que le corresponden por la matriz §5 (mínimo `IB-EL-EmpowerLabs`). - ✅ **Pasa:** abre y lee un archivo de prueba del IB-EL (ej. el CheatSheet de la pre-lectura). - ❌ **Falla:** revisar la sincronización (app o Obsidian) y los permisos contra la matriz §5. No avanzar hasta resolver. ### Paso 4 · Escribir el perfil del operador Con las dos validaciones en verde, escribe el **perfil del operador** (esquema en §2) en la carpeta canónica del usuario: ``` IB-EL-EmpowerLabs/.../02-PerfilOperador/DC-EL-PerfilOperador-[Nombre]-v01.md ``` ### Paso 5 · Encender la luz verde Marca `luz_verde: true` en el perfil. Esta es la señal que `/ArrancaWorX` verifica en su guardia mínimo. ### Paso 6 · Cierre Mensaje de sistemas al usuario: > "Tu SherpaX ya está configurado y validado. Cuando quieras, abre Cowork y corre `/ArrancaWorX` — tu SherpaX te va a reconocer y te guía desde ahí." --- ## 2. Esquema del perfil del operador Artefacto que escribe `/SetupSherpaX` y lee `/ArrancaWorX`. Vive en la carpeta `02-PerfilOperador` del usuario. ```yaml --- asset_id: DC-EL-PerfilOperador-[Nombre]-v01 tipo: DC — Perfil del Operador owner: [Nombre] sherpa: [nombre del SherpaX · vacío hasta que el usuario lo nombre en /ArrancaWorX] fecha_setup: [YYYY-MM-DD] setup_por: [responsable de sistemas] --- operador: nombre: "[Nombre]" rol_el: "[rol en EmpowerLabs]" rol_doix: "[rol en el arranque]" accesos_intellibanks: lectura: "[IBs con lectura · matriz §5]" escritura: "[IBs con escritura · matriz §5]" ratificacion: "[IBs con ratificación · matriz §5]" validaciones: mcp_conectado: true intellibanks_accesible: true luz_verde: true # señal que verifica /ArrancaWorX arranque_completado: false # lo marca /ArrancaWorX al cerrar la inducción ``` > El campo `arranque_completado` lo cierra `/ArrancaWorX` al terminar la inducción — así la minuta viva del Caso 0 sabe quién ya está operativo. --- ## 3. Tabla de validaciones · criterio y falla | # | Validación | Criterio de ✅ | Si ❌ | |---|---|---|---| | 1 | Prerequisitos del SOP previo | Cowork + plan + IntelliBanks app + SherpaX por MCP listos | Detener · remitir al SOP de instalación | | 2 | Conexión MCP | El SherpaX responde y lee el vault | Revisar MCP en Cowork | | 3 | Acceso IntelliBanks | Lee un archivo de IB-EL según matriz §5 | Revisar permisos vs matriz §5 | | 4 | Perfil escrito | Existe `DC-EL-PerfilOperador-[Nombre]-v01` | Reintentar escritura · validar naming/ubicación | | 5 | Luz verde | `luz_verde: true` | Sin esto, `/ArrancaWorX` falla suave | --- ## NEXTs - [ ] Probar `/SetupSherpaX` con Alex (Piloto 0 técnico) como primer caso · capturar fricciones en LabPraxis. - [ ] Confirmar la ruta exacta de `02-PerfilOperador` una vez migrado el vault a `/intellibanks`. - [ ] Ratificación de Victor. --- ## CHANGELOG | Versión | Fecha | Cambio | |---|---|---| | v01 | 2026-06-08 | Creación. Guion de `/SetupSherpaX`: prerequisitos del SOP previo, secuencia de 6 pasos con 2 validaciones (MCP + IntelliBanks), esquema del perfil del operador en `02-PerfilOperador`, luz verde y tabla de fallas. Construido sobre XP-EL-WORX-ArranqueBasico-v01. |