product-playbook 1.0.0

package/i18n/es/references/rules-commands.md

@@ -0,0 +1,98 @@
+# 🔧 Menú de Frameworks + Comandos Complementarios
+
+> Se carga cuando el usuario solicita "listar frameworks," "muéstrame los frameworks disponibles," o usa un comando complementario.
+
+## Especificar un Framework
+
+**Dos formas de activar:**
+
+**Método A (El usuario nombra directamente un framework):** Ir directo al flujo guiado de ese framework — no es necesario preguntar de nuevo.
+
+**Método B (El usuario dice "quiero elegir un framework," "listar todos los frameworks," etc.):** Presentar el siguiente menú:
+
+```
+📚 Frameworks disponibles — ingresa un número o nombre:
+
+【Entendiendo Usuarios】
+ 1. JTBD (Jobs to Be Done) — Identificar el trabajo que los usuarios realmente quieren lograr
+ 2. Persona — Construir perfiles de usuario impulsados por uso/tarea/motivación
+ 3. User Journey Map — Mapear el recorrido completo de experiencia del usuario
+ 4. Descubrimiento Continuo — Construir un hábito semanal de interactuar con usuarios
+
+【Definiendo el Problema】
+ 5. OST / Opportunity Solution Tree — Conectar sistemáticamente oportunidades con soluciones
+ 6. Posicionamiento / April Dunford — Encontrar la arena competitiva real y la diferenciación
+ 7. HMW — Reformular puntos de dolor como preguntas de diseño
+
+【Diseño de Solución】
+ 8. Working Backwards / PR-FAQ — Comenzar desde los resultados del usuario y trabajar hacia atrás
+ 9. Pre-mortem — Predecir y prevenir el fracaso antes de que suceda
+10. GEM — Priorización tridimensional Growth / Engagement / Monetization
+11. RICE — Priorización cuantitativa de funcionalidades
+12. MVP — Definir alcance mínimo viable del producto
+
+【Capa de Estrategia】
+13. Estrategia / Strategy Blocks — Jerarquía Misión → Visión → Estrategia
+14. Modelo DHM — Evaluación de oportunidad Delight / Hard to copy / Margin-enhancing
+15. Framework LNO — Asignación de tiempo Leverage / Neutral / Overhead
+16. Empowered Teams — Equipos empoderados vs. feature teams
+
+【Capa de Medición】
+17. North Star / North Star Metric — Definir la métrica única que representa el valor central para el usuario
+18. PMF — Evaluación de cuatro niveles de Product-Market Fit
+19. Sean Ellis Score — Cuantificar nivel de entusiasmo PMF
+
+【Capa de Negocio】
+20. Modelo de Negocio y Precios — Selección de modelo de ingresos y alineación de precios basados en valor
+21. Estrategia GTM — Estrategia de lanzamiento Go-to-Market y adquisición de clientes
+
+【Handoff de Desarrollo】
+22. Handoff de Desarrollo — Generar CLAUDE.md + TASKS.md + TICKETS.md para entregar a Claude Code para desarrollo
+
+Ingresa un número o nombre de framework (selección múltiple permitida, separada por comas):
+```
+
+## Omitir Discovery / Ir Directo a Build
+
+Cuando el usuario dice "omitir investigación de usuarios," "el problema ya es conocido," "ir directo a Desarrollo," lee `references/rules-build.md` y sigue la secuencia de pasos del Modo Build.
+
+> Recuerda al usuario: "Omitir la fase de investigación de usuarios significa que tu solución está construida sobre suposiciones. Recomendamos realizar Descubrimiento Continuo lo antes posible después de la ejecución para validar."
+
+## Activación del Modo Extensión de Funcionalidad
+
+- "Agregar una funcionalidad" / "Quiero agregar una nueva funcionalidad" / "nueva funcionalidad para producto existente" → activa el Modo Extensión de Funcionalidad (lee `references/rules-build.md` → Ruta Rápida de Extensión de Funcionalidad)
+
+## Comandos Complementarios
+
+| Comando | Comportamiento |
+|---------|---------------|
+| `"Cambiar a [framework]"` | Cambiar inmediatamente, preservando contenido completado |
+| `"Quiero cambiar la audiencia objetivo"` | Re-ajustar prioridad de frameworks y estilo de presentación |
+| `"Omitir este paso"` | Recordar necesidad, luego respetar la decisión y pasar al siguiente paso |
+| `"Volver a [paso/nombre de framework]"` | Regresar al paso especificado para re-guía (ver `references/rules-change-propagation.md`) |
+| `"Simplificar"` / `"Expandir"` | Condensar a puntos clave / Agregar análisis en profundidad |
+| `"Generar reporte"` | Leer `references/06-html-report.md`, producir un reporte de planificación HTML |
+| `"Generar PRD"` / `"Generar documentos de ingeniería"` | Leer `references/04b-solutions.md`, integrar PR-FAQ + MVP + User Story + Pre-mortem, **también generar automáticamente: diagrama de flujo (Mermaid) + esquema BD (Mermaid ERD) + UI wireframe (HTML)** |
+| `"Generar diagrama de flujo"` / `"Dibújame un diagrama de flujo"` | Producir diagrama de flujo en sintaxis Mermaid (activación independiente) |
+| `"Generar esquema BD"` / `"Diseñar la base de datos"` | Producir esquema BD en sintaxis Mermaid ERD (activación independiente) |
+| `"Generar UI wireframe"` / `"Dibújame un wireframe"` | Producir UI wireframe de baja fidelidad en HTML/SVG (activación independiente) |
+| `"Generar presentación"` / `"Hacer un PPT"` | Invocar el skill pptx del sistema |
+| `"Adaptar este documento para [audiencia]"` | Re-organizar puntos destacados de frameworks y lenguaje para la audiencia especificada |
+| `"Solo tengo 15 minutos"` | Proporcionar las tres preguntas o acciones de decisión más críticas |
+| `"Ejecutar evaluación de completitud"` | Evaluar qué áreas son sólidas y cuáles tienen riesgo |
+| `"Ayúdame a encontrar las suposiciones"` | Identificar todas las suposiciones centrales no validadas |
+| `"Ejecutar un Pre-mortem"` | Ejecutar inmediatamente un pre-mortem sobre cualquier solución |
+| `"Generar versiones para diferentes audiencias"` | Producir automáticamente resúmenes adaptados a múltiples audiencias |
+| `"¿En qué nivel de PMF está este producto?"` | Determinar el nivel de PMF y explicar el próximo hito |
+| `"Ayúdame a encontrar el cuello de botella"` | Analizar el mayor obstáculo para alcanzar el Aha Moment |
+| `"Esto es una revisión, no un producto nuevo"` | Cambiar a Modo Revisión (leer `references/rules-revision.md`) |
+| `"Necesito convencer a mi jefe de que apruebe"` | Cambiar a Modo Jefe — enfatizar valor de negocio y lógica de recursos |
+| `"Iniciar desarrollo"` / `"Generar paquete de handoff de desarrollo"` | Leer `references/07a-handoff-core.md`, confirmar stack tecnológico, luego generar el paquete completo de handoff de desarrollo |
+| `"Configurar el proyecto"` / `"Conectar con Claude Code"` | Igual que arriba |
+| `"Pausar"` / `"Guardar"` / `"Hacer otra cosa primero"` | Guardar progreso según `references/rules-progress.md` |
+| `"Continuar"` / `"Volver a planificación"` | Retomar según `references/rules-progress.md` |
+| `"Limpiar progreso"` / `"Empezar de nuevo"` | Eliminar archivo de progreso y comenzar desde cero |
+| `/export [formato]` | Exportar al formato especificado. formato = `pdf` / `docx` / `pptx` / `html` / `md`. Leer `references/rules-export-document.md`. En el primer uso, cargar `references/rules-document-tools.md` primero para verificar herramientas. |
+| `/parse [archivo]` | Analizar un documento subido a Markdown. Soporta PDF / DOCX / PPTX / imágenes. Leer `references/rules-import-document.md`. En el primer uso, cargar `references/rules-document-tools.md` primero para verificar herramientas. |
+
+**Sugerencias de comandos con contexto**: Después de completar cada paso, sugerir proactivamente 2-3 de los comandos disponibles más relevantes según el progreso actual.

package/i18n/es/references/rules-context.md

@@ -0,0 +1,291 @@
+# 📦 Reglas de Acumulación de Contexto de Producto
+
+> Este archivo define el formato, reglas de lectura/escritura, manejo de escenarios y resolución de conflictos para `.product-context.md`.
+> Cargado por el flujo de inicio de SKILL.md o por el pre-paso S1 de cada modo.
+
+## 1. Ubicación del Archivo y Ciclo de Vida
+
+- **Ruta**: `.product-context.md` en el directorio raíz del proyecto (mismo nivel que `.product-playbook-progress.md`)
+- **Retenido permanentemente**: Este archivo **no se elimina** cuando el flujo termina — persiste y acumula a través de sesiones
+- **En la primera creación**, recordar al usuario: "⚠️ Recomendamos agregar `.product-context.md` a `.gitignore` — este archivo puede contener información sensible de estrategia de producto."
+
+---
+
+## 2. Formato del Archivo
+
+```markdown
+# Contexto de Producto
+<!-- Mantenido automáticamente por product-playbook. No eliminar. -->
+<!-- last-updated: [timestamp ISO] -->
+
+## Identidad
+- **Nombre del producto**: [nombre]
+- **Tipo de producto**: [B2C / B2B / B2B2C / Herramienta interna]
+- **Descripción en una línea**: [Descripción de una oración]
+- **Audiencia objetivo**: [Resumen del Persona principal]
+
+## Estrategia Central
+- **JTBD Central**: [Cliente Objetivo] + quiere [Job] + en [Contexto]
+  - Funcional: [...]
+  - Emocional: [...]
+  - Social: [...]
+- **Posicionamiento (April Dunford)**:
+  - Alternativas competitivas reales: [...]
+  - Atributos únicos: [...]
+  - Valor central: [...]
+  - Mercado objetivo: [...]
+  - Categoría de mercado: [...]
+- **North Star Metric**: [Nombre de la métrica + definición]
+- **Aha Moment**: [Descripción]
+
+## Arquitectura y Stack Tecnológico
+- **Stack tecnológico**: [Lenguajes, frameworks, infraestructura]
+- **Módulos clave**: [Lista de módulos clave]
+- **Puntos destacados del modelo de datos**: [Entidades de datos centrales, si se conocen]
+
+## Historial de Decisiones
+<!-- Solo agregar. Agregar una entrada cada vez que se completa un flujo. -->
+
+### [fecha ISO] - [Tipo de flujo: Full/Quick/Revision/Feature Extension/Custom/Build]
+- **Alcance**: [Alcance de planificación/cambio]
+- **Decisiones clave**: [Decisiones principales]
+- **Riesgos identificados**: [Riesgos]
+- **Límites del MVP**: [Qué hacer / Qué no hacer]
+- **Métricas de éxito**: [Métricas de éxito + valores objetivo]
+
+## Preferencia de Idioma
+- **Idioma instalado**: [auto-detectado desde archivo .lang o idioma del usuario]
+- **Idioma preferido del usuario**: [el idioma en que el usuario se comunica]
+
+## Insights Acumulados
+- **Puntos de dolor conocidos**: [Lista de puntos de dolor, con fuentes]
+- **Temas de feedback de usuarios**: [Temas de feedback a través de sesiones]
+- **Estado de PMF**: [Nivel de evaluación más reciente + fecha]
+- **Postura de seguridad**: [Métodos de autenticación/autorización, vulnerabilidades conocidas]
+- **Deuda técnica**: [Deuda técnica acumulada a través de sesiones]
+```
+
+---
+
+## 3. Detección de Tres Escenarios
+
+Al inicio (después de verificación de archivo de progreso, antes de selección de modo), detectar el estado de `.product-context.md`:
+
+| Condición | Escenario | Acción |
+|-----------|----------|--------|
+| El archivo existe, la sección `Estrategia Central` tiene contenido real (no vacío / no placeholder) | **Escenario 1: Contexto completo** | Cargar silenciosamente. Mostrar: "📦 Contexto de producto detectado para **[nombre del producto]** — servirá como línea base para esta sesión de planificación." |
+| El archivo no existe | **Escenario 2: Sin contexto** | Registrar este estado. Activar Context Bootstrap al entrar en modo Extensión de Feature o Revisión (ver Sección 4) |
+| El archivo existe, `Estrategia Central` está vacío o contiene solo placeholders, pero `Historial de Decisiones` tiene al menos una entrada | **Escenario 3: Contexto parcial** | Mostrar un resumen de información conocida y ofrecer opciones de complemento (ver Sección 5) |
+
+**Lógica de detección**:
+1. ¿Existe el archivo?
+2. ¿La sección `Identidad` tiene un nombre de producto (no es placeholder)?
+3. ¿La sección `Estrategia Central` tiene un JTBD Central (no es placeholder)? → Sí = Escenario 1
+4. ¿La sección `Historial de Decisiones` tiene alguna entrada `###`? → Sí pero 3 es No = Escenario 3
+
+---
+
+## 4. Context Bootstrap (Solo Escenario 2)
+
+Cuando el usuario entra en **Extensión de Feature** o **Modo Revisión** pero no hay `.product-context.md`, insertar "Paso 0" antes del S1 del modo.
+
+**Presentación**:
+```
+📦 Esta es tu primera vez usando la herramienta de planificación de producto en este proyecto. Para hacer el flujo subsiguiente más eficiente,
+recopilaré información básica del producto primero (unos 2-3 minutos). Se guardará automáticamente para uso futuro.
+```
+
+### Recopilación Progresiva (no hacer todas las preguntas a la vez)
+
+**Ronda 1 (requerida para todos los modos)**:
+- ¿Cómo se llama el producto?
+- Describe lo que hace en una oración.
+- ¿Tipo de producto? (B2C / B2B / B2B2C / Herramienta interna)
+
+**Ronda 2 (requerida para Extensión de Feature, opcional para Revisión)**:
+- ¿Qué stack tecnológico usas? (Lenguajes, frameworks, bases de datos, infraestructura)
+- ¿Cuáles son los módulos o servicios clave?
+
+**Ronda 3 (requerida para Revisión, opcional para Extensión de Feature)**:
+- ¿Tienes datos de DAU/MAU o tasa de retención?
+- ¿Cuál es el feedback o queja más común de los usuarios?
+- ¿Hay problemas de seguridad o deuda técnica conocidos?
+
+### Auto-Detección de Stack Tecnológico
+
+Además del input verbal del usuario, Bootstrap puede **leer archivos del proyecto** para asistir la detección (solo lectura — no viola el Hard Gate):
+
+| Archivo | Contenido de Detección |
+|---------|----------------------|
+| `package.json` | Ecosistema Node.js, frameworks, dependencias |
+| `Cargo.toml` | Rust |
+| `go.mod` | Go |
+| `requirements.txt` / `pyproject.toml` | Python |
+| `Dockerfile` / `docker-compose.yml` | Arquitectura containerizada |
+| Estructura de directorios raíz del proyecto (`src/`, `app/`, `lib/`, etc.) | Inferencia de módulos |
+
+Después de la detección, presentar en **estilo confirmación**:
+```
+Detecté que tu proyecto usa:
+- Stack tecnológico: Next.js 14 + TypeScript + PostgreSQL + Redis
+- Módulos clave: auth/, billing/, dashboard/, api/
+¿Es correcto? ¿Algo que agregar o corregir?
+```
+
+Solo escribir a `.product-context.md` después de que el usuario confirme.
+
+### Después de Completar Bootstrap
+
+Escribir la información recopilada a `.product-context.md`, dejar secciones no recopiladas vacías (usando placeholders), luego proceder al S1 formal del modo.
+
+---
+
+## 5. Manejo de Contexto Parcial (Escenario 3)
+
+Cuando `.product-context.md` existe pero la Estrategia Central está vacía, con solo entradas en el Historial de Decisiones:
+
+**Presentación**:
+```
+📦 Tengo registros de tus [N] sesiones de planificación anteriores:
+- Stack tecnológico: [Stack conocido fusionado del Historial de Decisiones]
+- Módulos previamente modificados: [Módulos afectados fusionados del Historial de Decisiones]
+- La estrategia central del producto aún no ha sido registrada.
+
+¿Te gustaría:
+  1️⃣ Iniciar directamente (usar información conocida, omitir sección de estrategia)
+  2️⃣ Llenar información de estrategia primero (JTBD, Posicionamiento, North Star Metric)
+  3️⃣ Esta información es incorrecta — déjame corregirla
+```
+
+**Intento de auto-reconstrucción**: Escanear todas las entradas del Historial de Decisiones, extraer nombres de productos recurrentes, stacks tecnológicos y nombres de módulos de `Módulos afectados`, `Alcance` y `Decisiones clave`, y auto-llenar en `Arquitectura y Stack Tecnológico`. Marcar con `<!-- inferido del historial de decisiones -->` para indicar la fuente inferida.
+
+---
+
+## 6. Reglas de Auto-Lectura de Contexto
+
+Al cargar contexto en el pre-paso S1 de cada modo, **solo inyectar secciones relevantes** — no mostrar el contenido completo del archivo al usuario:
+
+| Modo + Paso | Secciones de Contexto Inyectadas |
+|-------------|--------------------------------|
+| Extensión de Feature S1 | Identidad, Arquitectura y Stack Tecnológico, 3 entradas más recientes del Historial de Decisiones |
+| Revisión S1 | Identidad, Estrategia Central, Insights Acumulados (puntos de dolor, PMF, seguridad), 3 entradas más recientes del Historial de Decisiones |
+| Full/Quick/Build S1 | Solo Identidad (nombre del producto, tipo, descripción en una línea) |
+| Pre-mortem en cualquier modo | Postura de seguridad + Deuda técnica (de Insights Acumulados) |
+
+**Control de volumen**: El Historial de Decisiones por defecto solo inyecta las 3 entradas más recientes. El usuario puede solicitar más.
+
+---
+
+## 7. Reglas de Omisión de Secciones Vacías
+
+Cuando el archivo de contexto existe pero algunas secciones están vacías, determinar si omitir o recopilar basándose en el **modo**:
+
+| Sección | Extensión de Feature | Modo Revisión | Full/Quick/Build |
+|---------|---------------------|--------------|-----------------|
+| Identidad | Requerida (Bootstrap si falta) | Requerida (Bootstrap si falta) | El flujo mismo producirá esto — no se necesita pre-carga |
+| Estrategia Central | **Puede omitirse** | Requerida (recopilación rápida Q&A dentro de S1 si falta) | El flujo mismo producirá esto |
+| Arquitectura y Stack Tecnológico | Requerida (Bootstrap o auto-detección si falta) | Puede omitirse | El flujo mismo producirá esto |
+| Historial de Decisiones | Puede omitirse | Incluir si disponible, omitir si no | El flujo mismo producirá esto |
+| Insights Acumulados | Puede omitirse | Incluir si disponible, omitir si no | El flujo mismo producirá esto |
+
+| Extensión de Funcionalidad | Identity (solo confirmar), Architecture & Tech Stack (requerido), Core Strategy (se permite omitir) |
+
+**Principio**: Las secciones vacías **no bloquean el flujo**. Solo las secciones que son "requeridas" para el modo actual y están vacías activarán la recopilación.
+
+---
+
+## 8. Reglas de Auto-Escritura de Contexto (Extracción al Final del Flujo)
+
+Al final de un flujo (en sincronía con la verificación de condición final en `rules-end-of-flow.md`), extraer contexto automáticamente:
+
+| Tipo de Flujo | Secciones Escritas/Actualizadas |
+|---------------|-------------------------------|
+| Quick | Identidad, Estrategia Central (JTBD + North Star), agregar al Historial de Decisiones |
+| Full | **Todas las secciones** (sobrescribir Identidad/Estrategia/Insights, agregar al Historial) |
+| Revision | Actualizar Estrategia Central (si se reposicionó), actualizar Insights, agregar al Historial |
+| Feature Extension | Fusionar Arquitectura, agregar al Historial de Decisiones (plantilla específica de feature) |
+| Custom | Actualizar secciones correspondientes a pasos completados |
+| Build (7 pasos) | Identidad, Estrategia Central (parcial), agregar al Historial |
+
+### Estrategia de Escritura
+
+| Sección | Estrategia | Notas |
+|---------|-----------|-------|
+| Identidad | **Sobrescribir con lo más reciente** | Siempre sobrescribir con los datos del flujo más reciente |
+| Estrategia Central | **Sobrescribir con lo más reciente** | Igual que arriba. La estrategia post-revisión reemplaza la estrategia pre-revisión |
+| Arquitectura y Stack Tecnológico | **Fusionar** | Nuevos módulos se agregan sin eliminar los antiguos. Nuevos ítems tecnológicos se agregan al final |
+| Historial de Decisiones | **Solo agregar** | Nunca eliminar entradas anteriores. Agregar una entrada cada vez que se completa un flujo |
+| Insights Acumulados | **Fusionar y deduplicar** | Puntos de dolor y temas de feedback se deduplicán y agregan. PMF y Seguridad se sobrescriben con los valores más recientes |
+
+### Plantilla de Entrada al Historial de Decisiones
+
+**Plantilla general**:
+```markdown
+### [fecha ISO] - [Tipo de flujo]
+- **Alcance**: [...]
+- **Decisiones clave**: [...]
+- **Riesgos identificados**: [...]
+- **Límites del MVP**: [...]
+- **Métricas de éxito**: [...]
+```
+
+**Plantilla de Extensión de Feature**:
+```markdown
+### [fecha ISO] - Extensión de Feature: [Nombre del feature]
+- **Problema**: [Declaración del problema en una oración]
+- **Solución elegida**: [Solución seleccionada + justificación]
+- **Módulos afectados**: [Módulos afectados]
+- **Alcance**: [Qué hacer / Qué no tocar]
+- **Criterios de aceptación**: [Criterios de aceptación]
+```
+
+### Notificación de Finalización
+
+```
+✅ El contexto de producto ha sido actualizado en `.product-context.md` — se cargará automáticamente en tu próxima sesión de planificación.
+```
+
+---
+
+## 9. Resolución de Conflictos
+
+### El usuario corrige contexto existente
+
+Completamente permitido. Las correcciones proporcionadas por el usuario sobrescriben directamente la sección correspondiente (lo más reciente gana).
+
+### Datos del usuario entran en conflicto con el codebase
+
+Cuando el pre-paso S1 lee tanto `.product-context.md` como archivos del proyecto (p.ej., `package.json`) y encuentra inconsistencias:
+
+```
+⚠️ Inconsistencia detectada:
+- El contexto registra: [valor del contexto]
+- Codebase del proyecto: [valor detectado del código]
+¿Cuál es correcto?
+  1️⃣ Usar codebase como fuente de verdad (actualizar contexto)
+  2️⃣ Usar contexto como fuente de verdad (puede estar en medio de una migración)
+  3️⃣ Ambos están incompletos — déjame explicar
+```
+
+**Principios de manejo**:
+- **No auto-sobrescribir** — dejar que el usuario decida
+- Actualizar `.product-context.md` después de que el usuario elija
+- Si se selecciona "en medio de una migración," anotar en la sección de Arquitectura: `[Migrando] React → Vue 3`
+- Registrar el conflicto en el Historial de Decisiones
+
+### Nuevos datos del flujo sobrescriben contexto
+
+Si los datos producidos durante un flujo difieren de datos antiguos en el contexto (p.ej., Modo Revisión redefine el JTBD), **los datos del flujo tienen prioridad**. Se sobrescribe automáticamente al final del flujo.
+
+---
+
+## 10. Preferencia de Idioma
+
+Cuando `.product-context.md` se crea o actualiza, registrar la preferencia de idioma en la sección `Preferencia de Idioma`:
+
+- **Idioma instalado**: Detectado desde el archivo `.lang` en el directorio de instalación del skill, o desde la configuración regional del usuario.
+- **Idioma preferido del usuario**: El idioma en que el usuario se comunica durante la sesión.
+
+**Regla de carga**: Al cargar un `.product-context.md` existente, si hay una preferencia de idioma registrada, continuar la sesión en ese idioma.
+
+**Momento de escritura**: La preferencia de idioma se escribe durante el Context Bootstrap (Sección 4) o al final del primer flujo que crea el archivo de contexto. Se actualiza cuando el usuario cambia explícitamente de idioma durante la sesión.

package/i18n/es/references/rules-custom.md

@@ -0,0 +1,63 @@
+# ✏️ Secuencia de Pasos del Modo Personalizado
+
+> Este archivo es la definición autoritativa de pasos para el Modo Personalizado. Cargado por el despachador central de SKILL.md.
+
+Basado en el nivel de completitud seleccionado por el usuario:
+
+## 🔴 Bajo (Lean) — 4 Pasos
+
+```
+S1. Declaración JTBD → cargar references/02b-jtbd.md
+S2. Un HMW → cargar references/03-define.md → 2.3
+S3. PR-FAQ → cargar references/04a-prfaq.md
+S4. North Star → cargar references/05a-northstar-aha.md
+(Cualquier paso puede ser intercambiado por el usuario por un framework diferente)
+────
+Output Final → Resumen de spec de producto (campos no ejecutados marcados "No ejecutado")
+```
+
+## 🟡 Medio (Estándar) — 10 Pasos
+
+```
+S1.  Tabla de Personas + Tarjeta de Persona → cargar references/02a-persona.md
+S2.  Análisis JTBD → cargar references/02b-jtbd.md
+S3.  Tabla de Resumen de Puntos de Dolor → cargar references/03-define.md
+S4.  Reformulación de Preguntas HMW → cargar references/03-define.md
+S5.  Posicionamiento April Dunford → cargar references/03-define.md
+S6.  PR-FAQ → cargar references/04a-prfaq.md
+S7.  Soluciones Paralelas + MVP + Lista de No Hacer → cargar references/04b-solutions.md + references/04c-mvp.md
+S8.  North Star + Señales de Tres Capas + Aha Moment → cargar references/05a-northstar-aha.md
+S9.  Evaluación de Nivel PMF → cargar references/05b-pmf-gtm.md
+S10. Resumen de Spec de Producto → cargar references/05c-validation-spec.md
+```
+
+## 🟢 Alto (Integral) — 16 Pasos
+
+```
+S1.  Strategy Blocks + Rumelt → cargar references/01-strategy.md
+S2.  Tabla de Personas + Tarjeta de Persona → cargar references/02a-persona.md
+S3.  Análisis JTBD → cargar references/02b-jtbd.md
+S4.  OST Opportunity Solution Tree → cargar references/02c-ost-journey.md
+S5.  User Journey Map → cargar references/02c-ost-journey.md
+S6.  Tabla de Resumen de Puntos de Dolor → cargar references/03-define.md
+S7.  HMW + Posicionamiento April Dunford → cargar references/03-define.md
+S8.  Tabla de Evaluación de Oportunidades → cargar references/03-define.md
+S9.  PR-FAQ → cargar references/04a-prfaq.md
+S10. Prototipos Paralelos → cargar references/04b-solutions.md
+S11. Pre-mortem → cargar references/04b-solutions.md
+S12. GEM + RICE → cargar references/04b-solutions.md
+S13. MVP + Lista de No Hacer → cargar references/04c-mvp.md
+S14. North Star + Señales de Tres Capas + Aha Moment → cargar references/05a-northstar-aha.md
+S15. Plan de Validación de Hipótesis → cargar references/05c-validation-spec.md
+S16. Resumen de Spec de Producto → cargar references/05c-validation-spec.md
+```
+
+## Reglas de Carga de Referencias
+
+Al entrar a cada paso, solo carga el archivo de referencia correspondiente (no pre-cargar todos los archivos). Cada paso arriba tiene su ruta de referencia anotada.
+
+## Formato del Output Final
+
+**Resumen de Spec de Producto** (solo integra pasos completados; campos no ejecutados se marcan "No ejecutado")
+
+Al completar, ejecuta reglas de fin de flujo según `references/rules-end-of-flow.md`.

package/i18n/es/references/rules-document-tools.md

@@ -0,0 +1,126 @@
+# Gestión de Dependencias de Herramientas de Conversión de Documentos
+
+> Se carga en el primer activación del comando `/export` o `/parse`.
+
+## Niveles de Dependencias
+
+| Nivel | Herramienta | Propósito | Instalación | Tamaño |
+|-------|-------------|-----------|-------------|--------|
+| **Core (Sin Instalación)** | Claude Read tool (Vision) | Análisis semántico de PDF | Integrado | 0 |
+| **Core (Sin Instalación)** | Playwright MCP | Renderizado de PDF | Integrado | 0 |
+| **Básico** | pymupdf (fitz) | Extracción de texto PDF + renderizado de imágenes | `pip3 install --break-system-packages pymupdf` | ~23MB |
+| **Básico** | pikepdf | Inyección de marcadores PDF + metadatos | `pip3 install --break-system-packages pikepdf` | ~5MB |
+| **Extendido** | pandoc | Conversión DOCX / PPTX | `brew install pandoc` | ~50MB |
+| **Fallback** | tesseract + chi_tra | OCR offline (cuando Vision no está disponible) | `brew install tesseract tesseract-lang` | ~150MB |
+| **Avanzado** | python-docx | Salida DOCX de alta calidad | `pip3 install --break-system-packages python-docx` | ~5MB |
+
+## Flujo de Detección al Inicio
+
+Cuando el usuario activa por primera vez una función de conversión de documentos, detectar e instalar según sea necesario en el siguiente orden:
+
+### Paso 1: Determinar Qué Herramientas Se Necesitan
+
+| Acción del Usuario | Herramientas Requeridas |
+|---------------------|------------------------|
+| `/export pdf` | pymupdf + pikepdf + Playwright MCP |
+| `/export docx` o `/export pptx` | pandoc |
+| `/parse [archivo PDF]` | pymupdf (+ Claude Vision o tesseract) |
+| `/parse [archivo DOCX/PPTX]` | pandoc |
+
+### Paso 2: Detectar Herramientas Instaladas
+
+Ejecutar los siguientes comandos Bash (detección silenciosa, sin output visible):
+
+```bash
+# pymupdf
+python3 -c "import fitz; print(fitz.version)" 2>/dev/null && echo "pymupdf: OK" || echo "pymupdf: MISSING"
+
+# pikepdf
+python3 -c "import pikepdf; print(pikepdf.__version__)" 2>/dev/null && echo "pikepdf: OK" || echo "pikepdf: MISSING"
+
+# pandoc
+which pandoc >/dev/null 2>&1 && echo "pandoc: OK" || echo "pandoc: MISSING"
+
+# tesseract (solo detectar cuando se necesita explícitamente)
+which tesseract >/dev/null 2>&1 && tesseract --list-langs 2>&1 | grep -q chi_tra && echo "tesseract: OK" || echo "tesseract: MISSING"
+```
+
+### Paso 3: Auto-Instalar Herramientas Faltantes
+
+Si se detectan herramientas faltantes, mostrar el siguiente mensaje e instalar automáticamente:
+
+```
+📦 La conversión de documentos requiere las siguientes herramientas:
+  ☐ [Nombre de herramienta] ([propósito], [tamaño])
+  ...
+Instalando, por favor espere...
+```
+
+Ejecutar comandos de instalación en secuencia:
+
+```bash
+# pymupdf + pikepdf (instalar juntos)
+pip3 install --break-system-packages pymupdf pikepdf
+
+# pandoc
+brew install pandoc
+
+# tesseract (solo cuando se necesita OCR offline)
+brew install tesseract tesseract-lang
+```
+
+Después de completar la instalación, mostrar:
+```
+✅ Instalación de herramientas completada, continuando...
+```
+
+### Paso 4: Detectar Playwright MCP
+
+Playwright MCP es una dependencia core para el renderizado de PDF. Método de detección:
+
+1. Intentar llamar a `mcp__plugin_playwright_playwright__browser_run_code`
+2. Si MCP está disponible → usar normalmente
+3. Si MCP no está disponible (no conectado) → mostrar:
+
+```
+⚠️ Playwright MCP no está conectado. El renderizado de PDF requiere el navegador Playwright.
+Por favor haga una de las siguientes opciones:
+  1. Iniciar Playwright MCP (recomendado)
+  2. O ejecutar ! npx playwright install chromium para instalar Chromium local
+```
+
+**Fallback de Playwright** (cuando MCP no está disponible):
+
+Si el usuario ha instalado Chromium local, usar Bash para ejecutar un script Node.js para renderizado de PDF:
+```bash
+node -e "
+const { chromium } = require('playwright');
+(async () => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage();
+  await page.setContent(require('fs').readFileSync('/tmp/export.html', 'utf8'));
+  await page.pdf({ path: '${OUTPUT_PATH}', format: 'A4', printBackground: true,
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' } });
+  await browser.close();
+})();
+"
+```
+
+## Caché de Estado de Herramientas
+
+Los resultados de la primera detección se registran en memoria (para evitar detección repetida):
+- Dentro de la misma sesión de conversación, las herramientas confirmadas como instaladas no se vuelven a detectar
+- Si la instalación falla, registrar el mensaje de error y reintentar en la próxima activación
+
+## Compatibilidad de Plataformas
+
+| Plataforma | pymupdf | pikepdf | pandoc | tesseract | Playwright |
+|------------|---------|---------|--------|-----------|------------|
+| macOS (Homebrew) | ✅ pip3 | ✅ pip3 | ✅ brew | ✅ brew | ✅ MCP/npx |
+| Linux (apt) | ✅ pip3 | ✅ pip3 | ✅ apt | ✅ apt | ✅ MCP/npx |
+| Windows (WSL) | ✅ pip3 | ✅ pip3 | ✅ choco | ✅ choco | ✅ MCP/npx |
+
+Seleccionar automáticamente el gestor de paquetes correspondiente según el sistema operativo del usuario. Método de detección:
+```bash
+[[ "$(uname)" == "Darwin" ]] && echo "macOS" || echo "Linux"
+```