--- type: PLAN asset_id: PLAN-MPX-KatIA-SherpaAnfitrion-v01 version: v01 status: Draft owner: Victor Heredia sherpa_owner: Jay fecha_creacion: 2026-05-20 fecha_ultima_actualizacion: 2026-05-20 fecha_migracion_bmf: 2026-05-20 intellbank: IB-MPX-MasterPlaybooks subbank: PB-MPX-MasterPlaybooks proposito: PLAN · KatIA SherpaAnfitrion · IB-MPX-MasterPlaybooks nota_migracion: Frontmatter BMF agregado en batch masivo 2026-05-20 · Workbench FASE 5C · proposito pendiente revisión manual --- # PL-MPX-KatIA-SherpaAnfitrión — Plan Maestro **Versión:** 1.0 **Fecha:** 13 de abril de 2026 **Estado:** Listo para ejecución por equipo **Responsable inicial:** Victor **Equipo ejecutor:** Equipo MasterPlaybooks (Cowork) --- ## 1. Contexto y Objetivo MasterPlaybooks.com está construyendo un agente de chat inteligente llamado **KatIA** — la Sherpa Anfitriona de la plataforma. Su rol es triple: 1. **Onboarding activo** — guiar a nuevos miembros en sus primeros pasos dentro de la plataforma 2. **Soporte inteligente** — responder preguntas sobre funcionalidades, membresías y contenidos 3. **Anfitriona de la comunidad** — compartir novedades, noticias y ser el primer punto de contacto con la experiencia MasterPlaybooks KatIA operará sobre una **base de conocimiento en .md** y será gobernada por un **Prompt Maestro** (Sherpa Prompt). Este documento es el plan de trabajo para construir ambos entregables, más la auditoría del prompt actual. --- ## 2. Diagnóstico: Estado Actual del Vault ### ✅ Activos Listos (usar como fuente) | Archivo | Ubicación | Uso para KatIA | | ------------------------------------------------ | ---------------------------- | --------------------------------------------------- | | `MPB-MAGIC-Cap1 al Cap10` + Prólogo | `MPB-MPX- Magic-MPlaybooks/` | Base de conocimiento principal sobre la plataforma | | `DC-MPX-ModeloMembresias-v03.md` | `PB-MPX-MasterPlaybooks/` | Info de tiers: Free / Basic / Basic Pro + precios | | `DC-MPX-NarrativaCentral-v01.md` | `PB-MPX-MasterPlaybooks/` | Voz, misión y propuesta de valor de MasterPlaybooks | | `DC-MPX-BusinessModel-v01.md` | `PB-MPX-MasterPlaybooks/` | Modelo de negocio y estructura | | `TP-MPX-AI-SherpaOS-BCBDistiller-v01.md` | `PB-MPX-MasterPlaybooks/` | Arquitectura técnica del Sherpa OS | | `DC-MPX-ContextoEquipo-AISherpaOS-v01.md` | `PB-MPX-MasterPlaybooks/` | Contexto del equipo para Sherpa OS | | `TP-MPX-BateriaEvaluacionSherpa-v01.md` | `PB-MPX-MasterPlaybooks/` | QA y evaluación del Sherpa | | `DC-MPX-MPbooksInteligentes-Compilacion-v0.1.md` | `PB-MPX-MasterPlaybooks/` | Compilación de MPBooks inteligentes | ### ⚠️ Activos a Completar / Crear | Entregable | Estado | Acción requerida | | ------------------------------------ | ----------- | ------------------------------------------------------- | | Flujo de onboarding de KatIA | ❌ No existe | Diseñar desde cero (ver Sección 4.2) | | Catálogo de contenidos vigente | ⚠️ Parcial | Compilar catálogo actualizado de MPBooks disponibles | | Perfil de KatIA (personalidad + voz) | ❌ No existe | Definir en el documento de base de conocimiento | | FAQ de plataforma | ❌ No existe | Crear listado de preguntas frecuentes con respuestas | | Protocolo de escalación a humano | ❌ No existe | Definir cuándo y cómo KatIA transfiere a soporte humano | --- ## 3. Auditoría del Prompt Actual > **Archivo base:** `Mpbook Prompt Chat - Sherpa.md` (versión 1.0, febrero 2026) ### 3.1 Arquitectura del Prompt (lo que funciona bien) El prompt actual está bien construido como **Sherpa genérico de playbook**. Sus fortalezas: - **Modularidad** — usa variables `${role}`, `${deliverables}`, `${outputSpec}` que permiten configurar el Sherpa por caso de uso - **Clasificador de intención** — el `INTENT CLASSIFIER PROMPT` identifica el modo correcto antes de responder - **7 modos especializados** — conocimiento, artefacto, decisión, plan, escenario, tabla, imagen - **Guardrails claros** — "usa SOLO información del playbook, no inventes datos" - **Output estructurado en JSON** — consistente para el frontend ### 3.2 Brechas Críticas (para el rol de KatIA) | # | Brecha | Descripción del problema | Prioridad | | --- | --------------------------- | ------------------------------------------------------------------------------------------ | --------- | | 1 | Sin identidad de plataforma | KatIA no tiene nombre, personalidad ni tono propio de MasterPlaybooks | 🔴 Alta | | 2 | Sin flujo de onboarding | No hay secuencia de bienvenida ni detección de usuario nuevo vs. existente | 🔴 Alta | | 3 | Intenciones insuficientes | Solo 6 intenciones — faltan: `onboarding`, `soporte`, `membresia`, `novedades`, `contacto` | 🔴 Alta | | 4 | Sin conciencia de membresía | No puede guiar upgrades ni explicar diferencias entre tiers Free/Basic/Pro | 🟡 Media | | 5 | Sin módulo de novedades | No existe intención ni prompt para compartir noticias/actualizaciones de la plataforma | 🟡 Media | | 6 | Sin ruta de escalación | No hay protocolo para cuando el usuario necesita soporte humano | 🟡 Media | | 7 | Output siempre JSON | Mensajes de bienvenida y conversaciones casuales en JSON se sienten mecánicos | 🟡 Media | | 8 | Sin estado de conversación | Cada exchange es stateless — KatIA no "recuerda" el contexto de la sesión | 🟢 Baja | ### 3.3 Recomendación El prompt actual es una **base sólida** que debe ser **extendido**, no reemplazado. La estrategia es: 1. Mantener la arquitectura modular actual 2. Añadir un **SHERPA IDENTITY BLOCK** al inicio con la personalidad de KatIA 3. ==Añadir 5 nuevos prompts especializados (onboarding, membresía, novedades, soporte,== escalación) 4. Ampliar el clasificador de intención de 6 a 11 intenciones 5. Añadir modo `conversacional` para respuestas sin JSON cuando aplique --- ## 4. Plan de Entregables ### 4.1 Entregable 1 — Base de Conocimiento: "KatIA Knowledge Base" **Nombre del archivo:** `KB-MPX-KatIA-BaseConocimiento-v01.md` **Destino:** `PB-MPX-MasterPlaybooks/` **Estructura del documento:** ``` # KatIA — Base de Conocimiento MasterPlaybooks ## Bloque 1: Quién es KatIA - Nombre, personalidad, tono de voz - Misión como anfitriona - Lo que puede y no puede hacer ## Bloque 2: Qué es MasterPlaybooks - Misión y propuesta de valor - Cómo funciona la plataforma - El ecosistema: MPBooks, AI Sherpa, Destilerías BCB ## Bloque 3: Catálogo de Contenidos - MPBooks disponibles (títulos, categorías, descripción breve) - Formatos: Resúmenes, Libros completos, Colecciones ## Bloque 4: Membresías y Precios - Free: 5 resúmenes/mes, sin AI Sherpa - Basic: $10/mes — todos los resúmenes - Basic Pro: $19.99/mes — todos los resúmenes + AI Sherpa - Sistema de créditos para usuarios Free - Proceso de upgrade ## Bloque 5: Proceso de Onboarding (diseñar — ver 4.2) - Paso 1: Registro y bienvenida - Paso 2: Tour de la plataforma - Paso 3: Primer MPBook recomendado - Paso 4: Activación del AI Sherpa (si tiene membresía Pro) - Paso 5: Comunidad y recursos ## Bloque 6: Preguntas Frecuentes - [30 preguntas + respuestas a crear] ## Bloque 7: Protocolo de Escalación - Cuándo KatIA transfiere a humano - Cómo hacerlo - Información de contacto del equipo de soporte ``` **Fuentes a usar:** - `DC-MPX-ModeloMembresias-v03.md` → Bloques 4 y 6 - `DC-MPX-NarrativaCentral-v01.md` → Bloque 2 - `MPB-MAGIC-Cap1 al Cap10` → Bloques 2, 3 y 5 - `DC-MPX-BusinessModel-v01.md` → Bloque 2 - Información nueva a crear → Bloques 1, 5, 6 (parcial), 7 --- ### 4.2 Diseño del Flujo de Onboarding de KatIA El onboarding es conversacional — KatIA guía al usuario a través de preguntas y respuestas. Propuesta de flujo: ``` TRIGGER: Usuario nuevo entra al chat por primera vez [Mensaje 1 — Bienvenida] KatIA: "¡Hola! Soy KatIA, tu guía en MasterPlaybooks. ¿Es tu primera vez aquí o ya conoces la plataforma?" [RAMA A: Usuario nuevo] → KatIA: "¡Bienvenido/a! Te cuento en 1 minuto cómo funciona todo..." → Tour rápido de 3 puntos clave → Pregunta: "¿Qué tipo de contenido te interesa más?" (opciones: liderazgo, productividad, deportes, negocios) → Recomendación de primer MPBook personalizada → Explicación de membresías y cómo acceder a todo [RAMA B: Usuario existente] → KatIA: "¡Qué bueno verte de nuevo! ¿En qué puedo ayudarte hoy?" → Clasificador de intención normal TRIGGER: Usuario pregunta por membresía o precio → KatIA activa MEMBERSHIP ADVISOR PROMPT TRIGGER: Usuario expresa confusión o frustración → KatIA activa ESCALATION PROTOCOL → "Entiendo que esto puede ser confuso. ¿Quieres que te conecte con alguien del equipo?" ``` **Decisiones a tomar por el equipo:** - [ ] ¿Cómo detecta el sistema si el usuario es nuevo? (¿señal del frontend?) - [ ] ¿Cuáles son las categorías de contenido disponibles actualmente? - [ ] ¿Quién recibe las escalaciones? (¿email, WhatsApp, ticket?) - [ ] ¿Hay un link directo de signup que KatIA debe conocer? --- ### 4.3 Entregable 2 — Prompt KatIA Anfitriona v2.0 **Nombre del archivo:** `TP-MPX-KatIA-SherpaPrompt-v20.md` **Destino:** `PB-MPX-MasterPlaybooks/` **Estructura del prompt rediseñado:** ``` ### KATIA IDENTITY BLOCK (nuevo) Eres KatIA, la Sherpa Anfitriona de MasterPlaybooks... [Personalidad, tono, misión, límites] ### SHERPA PROMPT (GENERAL) — mantener + ajustar variables [igual que versión actual, con ajuste de tono para KatIA] ### INTENT CLASSIFIER PROMPT — ampliar a 11 intenciones Nuevas intenciones a añadir: - onboarding (usuario nuevo en la plataforma) - membresia (preguntas sobre planes, precios, upgrade) - soporte (problema técnico o con cuenta) - novedades (quiere saber qué hay de nuevo) - contacto (quiere hablar con alguien del equipo) ### ONBOARDING PROMPT (nuevo) ### MEMBERSHIP ADVISOR PROMPT (nuevo) ### NEWS & UPDATES PROMPT (nuevo) ### SUPPORT TRIAGE PROMPT (nuevo) ### ESCALATION PROTOCOL PROMPT (nuevo) ### [Prompts existentes — mantener] KNOWLEDGE QA PROMPT ARTIFACTS PROMPT DECISION ADVISOR PROMPT IMAGE PROMPT SCENARIO SIMULATOR PROMPT PLAN PROMPT TABLE GENERATOR PROMPT ``` --- ### 4.4 Entregable 3 — Auditoría Formal del Prompt Actual **Nombre del archivo:** `AUD-MPX-SherpaPrompt-v10-Auditoria-v01.md` **Destino:** `PB-MPX-MasterPlaybooks/` Documento que formaliza el análisis de la Sección 3 de este plan, con: - Scoring por dimensión (completitud, claridad, cobertura de intenciones, calidad de output, escalabilidad) - Matriz de brechas vs. requerimientos de KatIA - Recomendaciones priorizadas con ejemplos de prompt reescrito - Checklist de validación para el equipo de programación --- ## 5. Secuencia de Ejecución Recomendada ``` FASE 1 — Fundamentos (1-2 días) ├── Leer y compilar los 10 capítulos del libro Magic + docs de plataforma ├── Definir personalidad y tono de KatIA (reunión de 30 min con Victor) ├── Definir respuestas a las 4 decisiones del onboarding (Sección 4.2) └── OUTPUT: KB-MPX-KatIA-BaseConocimiento-v01.md (draft) FASE 2 — Prompts (1-2 días) ├── Rediseñar el Prompt Sherpa con identidad KatIA ├── Escribir los 5 nuevos prompts especializados ├── Documentar auditoría formal del prompt v1.0 └── OUTPUT: TP-MPX-KatIA-SherpaPrompt-v20.md + AUD-MPX-SherpaPrompt-v10-Auditoria-v01.md FASE 3 — Integración y QA (1 día) ├── Conectar KB + Prompt en el entorno del chat ├── Correr batería de evaluación Sherpa (archivo TP-MPX-BateriaEvaluacionSherpa-v01.md) ├── Detectar alucinaciones o brechas en la KB └── OUTPUT: Reporte de QA + ajustes finales FASE 4 — Lanzamiento ├── Activar KatIA en el chat de masterplaybooks.com └── Monitor de primeras 2 semanas + iteración ``` --- ## 6. Preguntas Abiertas para Victor (antes de ejecutar Fase 1) - [ ] **Personalidad de KatIA** — ¿Cómo la describes en 3 palabras? ¿Formal o casual? ¿Usa "tú" o "usted"? - [ ] **Catálogo actual** — ¿Hay una lista oficial de todos los MPBooks disponibles hoy? - [ ] **Escalación** — ¿A qué canal va un usuario que necesita soporte humano? (email, WhatsApp, Slack, etc.) - [ ] **Señal de usuario nuevo** — ¿El chat puede saber si el usuario es nuevo o ya tiene cuenta? ¿O KatIA debe preguntarlo? - [ ] **Novedades** — ¿Las novedades de la plataforma se actualizarán en la KB manualmente o hay un feed? - [ ] **Límite de KatIA** — ¿Puede KatIA referir a MPBooks específicos o solo describir la plataforma en general? --- ## 7. Archivos del Proyecto | Entregable | Archivo | Estado | |---|---|---| | Este plan | `PL-MPX-KatIA-SherpaAnfitrion-PlanMaestro-v01.md` | ✅ Listo | | Base de conocimiento | `KB-MPX-KatIA-BaseConocimiento-v01.md` | 🔲 Por crear | | Prompt KatIA v2.0 | `TP-MPX-KatIA-SherpaPrompt-v20.md` | 🔲 Por crear | | Auditoría del prompt | `AUD-MPX-SherpaPrompt-v10-Auditoria-v01.md` | 🔲 Por crear | | Batería de QA | `TP-MPX-BateriaEvaluacionSherpa-v01.md` | ✅ Existe (reutilizar) | --- ## 💬 THREAD **@Victor — 2026-04-15:** KatIA necesita ser adaptable por canal/comunidad. Cuando MasterPlaybooks se integre con una comunidad específica (ej: Tribus RRHH), KatIA no puede operar solo con la KB genérica de la plataforma. Cada canal tiene características propias: membresías distintas, políticas específicas, funcionalidades del canal (foro, bolsa de trabajo, clasificados en Tribus RRHH). KatIA debe poder responder preguntas del canal completo, no solo de MasterPlaybooks. → **NEXT[@Anahí]:** Definir si la arquitectura de KatIA incluye una "KB de canal" adicional a la KB base de MasterPlaybooks. Para Tribus RRHH: crear `KB-TriRH-KatIA-CanalContexto-v01.md` con info específica del canal (membresías, foro, bolsa de trabajo, políticas, anuncios clasificados). → **NEXT[@Victor]:** Confirmar si este modelo multi-KB (KB base MPX + KB canal) es la arquitectura definitiva antes de que Anahí comience a producirla. --- **@Anahí — 2026-04-16:** ✅ RESUELTO. Arquitectura decidida: **Core + Channel Overlay**. Una KB base única de plataforma + una KB aditiva por canal. El canal extiende, no sobreescribe. KatIA resuelve por variable `${channel}` en el Sherpa Prompt. Para Tribus RRH: comparte modelo de membresías con MasterPlaybooks; solo añade funcionalidades propias (foro, bolsa de trabajo, noticias, comunidad). **Entregables publicados:** - `ARQ-MPX-KatIA-MultiKB-v01.md` — ADR con arquitectura, reglas de resolución y plantilla de KB de canal. - `KB-TriRH-KatIA-CanalContexto-v01.md` — esqueleto listo para poblar con el contenido real del canal. → **NEXT[@Anahí]:** Poblar secciones `[PENDIENTE]` del esqueleto de Tribus RRH con información real del canal (funcionalidades, políticas, FAQs, curaduría). → **NEXT[@Victor]:** Ratificar el ADR `ARQ-MPX-KatIA-MultiKB-v01.md` como arquitectura definitiva para canales futuros (Tribus RRH, Mi Sherpa IA as a Service, etc.). → **NEXT[@Equipo técnico / Alex]:** Confirmar viabilidad de inyectar `${channel}` desde el frontend al Sherpa Prompt, y planear bump a `TP-MPX-KatIA-SherpaPrompt-v21` que incluya `${channel}` y el CONTEXT ROUTER (ver Sección 6 del ADR). --- *Documento generado por Claude / Cowork — MasterPlaybooks.com* *Siguiente paso: el equipo ejecuta Fase 1 desde su sesión Cowork con acceso completo al vault*