--- asset_id: SPEC-EL-SOO-KitEnsamblaje-v01 version: v01 tipo: SPEC — Especificación de Componente status: Draft (L0 · pendiente ratificación Victor) owner: Victor Heredia sherpa_owner: Jay (SherpaX maestro) ratificador: Victor Heredia (L3+) intellibank: IB-EL-EmpowerLabs subbank: PB-EL-Project-Bank / PB-SOO-SistemaOperativoOrganizacional proposito: Especificar el Kit de Ensamblaje que convierte la instalación del WORX OS de proyecto a ensamblaje casi plug-and-play (kernel universal + capa específica intercambiable). prioridad: P1a (según OUT-EL-SOO-Diagnostico-Fable5-v02 · G6a) inheritance: - MAP-EL-SOO-EcosistemaCompleto-v01 (separación universal/específico) - CP-EL-SOO-Concepto-SistemaOperativoOrganizacional-v01 (§6 plug-and-play) - MePB-EL-OrganizationalKernel-v01 (2 capas: universal WORX + específica EL) - SPEC-EL-SOO-DecisionEngine-v01 (se instala vacío) gates: - Baseline desde el primer caso externo (Posta) antes de afirmar ROI/semanas — NO se corre EmpowerScan a EL - Posta cerrado (precondición del build del instalador · G6b) fecha_creacion: 2026-07-04 fecha_ultima_actualizacion: 2026-07-04 tags: [SPEC, kit-ensamblaje, plug-and-play, WORX-OS, instalacion, universal-especifico, P1a] --- # SPEC · Kit de Ensamblaje del WORX OS ## De proyecto de meses a ensamblaje de semanas · plug-and-play · ensambla una instancia SOOI ## 0. Asset Header - **Asset ID:** `SPEC-EL-SOO-KitEnsamblaje-v01` - **Tipo:** SPEC — Especificación de componente - **Status:** Draft · L0 · pendiente ratificación - **Owner:** Victor · **Sherpa:** Jay · **Ratificador:** Victor - **Prioridad:** P1a (el mandato del room, según diagnóstico Fable5 v02). ## 1. Problema y promesa Hoy instalar el WORX OS es un **proyecto**: se re-deriva contexto, se re-arma taxonomía, se induce a mano. Eso no escala ni se vende como producto. > **Promesa del Kit:** que una organización nueva **ensamble** su instancia del WORX OS —un **SOOI**: kernel universal + su capa específica— conecte sus datos, corra la inducción (Rally) y **opere en semanas**, no en meses. Lo repetible se ensambla; lo único se configura. Esta es la pieza que convierte "categoría validada" en "solución replicable" y habilita la comunidad (cada instancia comparte el mismo kernel). ## 2. Principio rector — 2 capas (hereda del Organizational Kernel) | Capa | Definición | Viaja | |---|---|---| | **Universal (el kernel)** | Lo que es igual en toda organización: método WORX, gobernanza, agentes base, esquemas del Corp Brain OS, naming BMF. | **Intacto** (no se toca al instalar) | | **Específica (la instancia)** | Lo que cambia por organización: su taxonomía, sus datos, su roster/roles, sus dashboards, su Rally, su Decision Engine (vacío). | **Se intercambia/configura** | > **BrainCodes:** no vienen en la **base** del Kit. La **Cognición/BrainCodes se ofrece como Add-On Premium** (opción avanzada · ver `ARQ-XX-SOOI-DisenoConceptual` §3.4 · Cubo D). El roster propietario de EL nunca se vende. Modelo comercial: **Base + Add-Ons Premium**. El Kit = el empaque de la capa universal + el **asistente de configuración** de la capa específica. ## 3. Bill of Materials (BOM) — qué se ensambla ### 3.1 Universal (viene en el Kit, intacto) 1. **Kernel BMF** (7 invariantes) + **Organizational Kernel** como plantilla instanciable. 2. **Método WORX**: 3 Niveles + 5 Capacidades + comandos (`/arrancaroom`, `/wx-mindia`, `/wx-minsemana`, `/wx-resumenroom`, `/wx-listaskills`). 3. **Gobernanza**: niveles L0–L3, tripleta, Gate G0, MEL, plantilla de Control Plane + Registry. 4. **Agentes base**: SherpaX core, plantilla UltraSherpaX, generador de UltraSherpas. 5. **BrainCodes: NO en la base** — la Cognición se ofrece como **Add-On Premium** (opción avanzada · `ARQ-XX-SOOI-DisenoConceptual` §3.4). La base opera sin BrainCodes. 6. **Esquemas Corp Brain OS** (Supabase + RLS · Kit Assembler) e **Identity/Security** base. 7. **Plugins**: `worx-core.plugin` + esqueleto de `worx-.plugin`. 8. **Superficie visual**: plantillas de dashboards HOY (HOY, WeekDashboard, Home) con el sistema de diseño. 9. **Rally de Aprendizaje** (plantilla de inducción) + **EmpowerScan** (diagnóstico de entrada). 10. **Decision Engine** — instalado **vacío** (el ledger se llena con las decisiones de la nueva org). ### 3.2 Específico (se configura al instalar) | Parámetro | Qué define | Fuente | |---|---|---| | **Identidad org** | nombre, código de entidad (ENT), misión, roster + roles | intake | | **Taxonomía / bancos** | estructura `IB--*` y sub-bancos | plantilla + intake | | **Conexiones de datos** | CRM/ERP/archivos/chat a indexar en el Vault | conectores | | **BrainCodes propios** *(Add-On Premium)* | parte del Add-On de Cognición, no de la base | Add-On | | **capa `worx-.plugin`** | skills y comandos específicos | esqueleto + intake | | **Dashboards** | HOY/Week con métricas y links de la org | plantillas | | **Clases de decisión** | las 3–5 clases piloto del Decision Engine (decisores ≠ fundador) | SPEC Decision Engine | | **Rally** | misiones de inducción adaptadas al roster | plantilla Rally | ## 4. Flujo de instalación (5 fases) ``` F0 · PROVISIÓN crear instancia: Vault (bancos IB--*) + Corp Brain OS + plugin core ▼ F1 · DIAGNÓSTICO EmpowerScan de entrada AL CLIENTE → define alcance y ROI objetivo ▼ F2 · ENSAMBLAJE desplegar capa universal intacta + configurar capa específica (§3.2) ▼ F3 · CONEXIÓN conectar datos, indexar al Vault (sin BrainCodes en esta fase) ▼ F4 · INDUCCIÓN correr el Rally de Aprendizaje (instala las 5 Capacidades como conducta) ▼ F5 · OPERACIÓN SherpaX activo · Decision Engine capturando · dashboards vivos ``` **Time-to-value objetivo:** semanas (no meses). Cada fase con criterio PASS/FAIL (p.ej. F4 PASS = el operador corre `/arrancaroom` y crea su primera minuta solo). ## 5. Niveles de madurez plug-and-play | Nivel | Descripción | Estado | |---|---|---| | **PnP-0 · Manual** | EL instala a mano, room por room (hoy · Caso 0). | Actual | | **PnP-1 · Templated** | Kit con plantillas + asistente de configuración guiado por SherpaX. | **Meta de este spec** | | **PnP-2 · Self-serve** | La org ensambla su instancia con supervisión mínima. | Post-Posta | | **PnP-3 · Community** | Instancias comparten skills/BrainCodes/plugins vía marketplace. | Visión (G7) | ## 6. Gating y precondiciones (de Fable5 v02) - **Baseline de un caso real (Posta):** las cifras de "semanas/ROI" se respaldan con el **primer caso externo**, no con auto-medición. **No se corre EmpowerScan a EL.** No bloquea *diseñar* el Kit; bloquea *afirmar* números sin ese caso. - **Posta cerrado:** el segundo caso externo es precondición del **build del instalador** (G6b) — el Kit se especifica ahora, se construye contra un cliente real. - **Specs ratificadas:** antes de que la narrativa comercial (G1) nombre "Kit de Ensamblaje" como capacidad vendible. ## 7. Interfaces con el resto del ecosistema - **Decision Engine** (`SPEC-...DecisionEngine`) — se ensambla vacío; su Autonomy Ledger es puro específico. - **Rally** — es la fase F4; el Kit provee la plantilla. - **EmpowerScan / Org IBX** — F1 (entrada) y medición del gap. - **Marketplace / plugins** — la capa `worx-.plugin` es el punto de extensión de comunidad. - **Mapa del ecosistema** (`MAP-...`) — define qué es universal vs. específico (insumo directo del BOM). ## 8. Riesgos - **Sobre-ensamblaje:** meter demasiado en "universal" hace el Kit pesado y frágil. Regla: universal = lo que NO cambia por org; ante duda, va a específico. - **Fuga de IP:** la **base** no incluye BrainCodes; la Cognición se vende como Add-On Premium **sin el roster propietario de EL**. El **LabPraxis** y el roster propietario de EL nunca viajan. - **Falsa promesa de semanas:** sin un caso real medido (Posta), "semanas" es marketing. Atar la cifra al primer caso externo. - **Configuración = nuevo proyecto:** si la capa específica no está bien acotada, el "ensamblaje" recae en proyecto. El asistente de configuración debe forzar defaults. ## 9. NEXTs - [ ] Ratificación de Victor del spec. - [ ] Con el `MAP-...Ecosistema`: etiquetar cada componente universal/específico (BOM definitivo). - [ ] Definir el **asistente de configuración** (guion del SherpaX que ensambla la capa específica). - [ ] Fijar el baseline de "semanas/ROI" con el **primer caso externo (Posta)** — no se corre EScan a EL. - [ ] Especificar F0 (provisión técnica) con Alex/Jesús. - [ ] Al cerrar Posta: build del instalador (G6b) contra ese caso. ## CHANGELOG | Versión | Fecha | Cambio | |---|---|---| | v01 | 2026-07-04 | Creación. Kit de Ensamblaje: principio de 2 capas, BOM universal/específico, flujo de 5 fases, 4 niveles de madurez PnP, gating (baseline desde caso externo Posta — **sin EmpowerScan a EL**, decisión de Victor — + specs ratificadas), interfaces y riesgos. |