product-playbook 1.0.0

package/i18n/es/references/rules-end-of-flow.md

@@ -0,0 +1,150 @@
+# 🏁 Reglas de Fin de Flujo
+
+> Se carga cuando todos los pasos están completados.
+
+## ⛔ Verificación de Condición Final
+
+Antes de producir el output final integrado, lo siguiente debe verificarse:
+
+1. Confirmar que todos los pasos en el indicador de progreso están marcados ✅
+2. Si algún paso fue omitido (a solicitud explícita del usuario), marcarlo como "⚠️ Omitido" en el output final
+3. Si algún paso está marcado ⬜ (no ejecutado), no proceder al output final
+4. **Verificación rápida de seguridad**: Si el usuario entrará a la fase de desarrollo (generando un paquete de handoff de desarrollo), incluir un recordatorio de seguridad en el output final, y al generar el paquete de handoff de desarrollo, leer automáticamente `references/08-security-checklist.md` para producir la sección correspondiente de arquitectura de seguridad
+
+Violaciones a esta regla incluyen: Decidir independientemente que "los pasos restantes no son importantes" y omitirlos, marcar pasos incompletos como completados, o combinar múltiples pasos en un solo output.
+
+## 🔍 Verificación de Consistencia de Decisiones
+
+Antes de generar el output final integrado, escanear TODOS los pasos completados y verificar la consistencia entre pasos:
+
+### Verificaciones por Modo
+
+**🚀 Modo Rápido** (3 pasos — verificar 2 referencias cruzadas):
+1. JTBD ↔ PR-FAQ: ¿El PR-FAQ aborda el mismo problema que la declaración JTBD?
+2. PR-FAQ ↔ North Star: ¿El North Star mide el resultado que el PR-FAQ promete?
+
+**📦 Modo Completo** (20 pasos — verificar las 7):
+1. Usuario Objetivo — ¿se referencia la misma persona en JTBD, Posicionamiento, PR-FAQ y North Star?
+2. Problema Central / JTBD — ¿el PR-FAQ aborda el mismo problema? ¿El MVP lo resuelve?
+3. Posicionamiento — ¿se refleja en el titular del PR-FAQ y la dirección de la solución?
+4. Dirección de la Solución — ¿la solución seleccionada coincide con el alcance del MVP?
+5. Alcance del MVP — ¿es consistente con las promesas del PR-FAQ? ¿Se respetan los elementos "No Hacer"?
+6. North Star Metric — ¿mide el resultado del JTBD? ¿Es alcanzable con el alcance del MVP?
+7. Riesgos Pre-mortem — ¿siguen siendo relevantes dada la solución final y el MVP?
+
+**🔄 Modo Revisión** (12 pasos — verificar 4):
+1. JTBD existente ↔ Puntos de Dolor ↔ Posicionamiento: ¿consistentes después de la reevaluación?
+2. PR-FAQ ↔ Alcance del MVP: ¿el alcance de la revisión coincide con lo que describe el PR-FAQ?
+3. North Star ↔ Antes/Después: ¿la comparación de métricas es lógica?
+4. Riesgos Pre-mortem: ¿siguen siendo relevantes para el producto revisado?
+
+**⚡ Modo Build** (7 pasos — verificar 4):
+1. Declaración del Problema ↔ PR-FAQ: ¿se aborda el mismo problema?
+2. Dirección de la Solución ↔ Alcance del MVP: ¿la solución seleccionada coincide con el MVP?
+3. North Star ↔ MVP: ¿la métrica es alcanzable con el alcance del MVP?
+4. Riesgos Pre-mortem: ¿siguen siendo relevantes para la solución final?
+
+**🔧 Modo Extensión de Feature** (4 pasos — verificar 3):
+1. Problema ↔ Solución Seleccionada: ¿la solución aborda directamente el problema planteado?
+2. Solución ↔ Alcance de Ejecución: ¿el alcance implementa correctamente la solución seleccionada?
+3. Evaluación de Riesgos: ¿los riesgos identificados siguen siendo relevantes para el alcance de ejecución?
+
+**✏️ Modo Personalizado** — solo verificar referencias cruzadas entre los pasos que el usuario realmente ejecutó. Omitir verificaciones de pasos que no formaron parte de la selección personalizada.
+
+### Ejecución
+1. Listar cada decisión clave en una línea (ej., "Usuario Objetivo: Fundadores de startups en etapa temprana")
+2. Verificar si existen contradicciones o referencias desactualizadas entre pasos
+3. Si se encuentran inconsistencias:
+   - Mostrar: "⚠️ La verificación de consistencia encontró [N] problema(s) antes del output final:"
+   - Listar cada problema con los pasos afectados
+   - Preguntar al usuario: "¿Debo corregir estos problemas antes de generar el output final, o proceder tal como está?"
+4. Si todo es consistente:
+   - Mostrar: "✅ Verificación de consistencia de decisiones aprobada — todos los pasos están alineados."
+   - Proceder al output final
+
+### Por Qué Esto Es Importante
+Durante la planificación iterativa, los usuarios pueden modificar decisiones anteriores (ej., cambiar el JTBD) mientras algunos pasos posteriores retienen contenido desactualizado. Esta verificación detecta esas brechas antes de que se produzca el documento final, evitando entregables inconsistentes.
+
+## 📦 Auto-Extracción de Contexto de Producto
+
+Después de que todos los pasos estén completos y mientras se produce el output final integrado, lee `references/rules-context.md` Sección 8 para realizar la extracción de contexto:
+
+1. **Verificar si `.product-context.md` existe**
+   - No existe → Crear un archivo nuevo
+   - Existe → Actualizar según las reglas (Identidad/Estrategia Central sobrescribir, Historial de Decisiones agregar, Arquitectura fusionar, Insights fusionar y deduplicar)
+
+2. **Extraer contenido** (según el mapeo de tipo de flujo en la tabla de la Sección 8 de `rules-context.md`)
+
+3. **Informar al usuario**: Después del output final, mostrar:
+   "✅ El contexto de producto ha sido actualizado en `.product-context.md` — se cargará automáticamente en tu próxima sesión de planificación."
+
+4. **Recordatorio de control de versiones** (solo primera creación):
+   "⚠️ Recomendamos agregar `.product-context.md` a `.gitignore` — este archivo puede contener información sensible de estrategia de producto."
+
+## Análisis del Mejor Punto de Entrada (solo Modo Completo)
+
+```
+[Puntos de Dolor de Persona] → [Declaración JTBD] → [Oportunidad OST] → [Pregunta HMW]
+    → [Posicionamiento (April Dunford)] → [Validación PR-FAQ] → [Solución Seleccionada]
+        → [Aha Moment] → [North Star Metric] → [Evaluación de Nivel PMF]
+```
+
+Puntos de análisis: Problema más valioso a resolver / JTBD Central / Posicionamiento del producto / Nivel de PMF y próximo hito / Primer paso de acción / Alertas de riesgo del Pre-mortem
+
+## Output Final por Modo
+
+| Modo | Output Final Integrado |
+|------|----------------------|
+| 🔧 Modo Extensión de Feature | Especificación de desarrollo de feature: Problema → Solución seleccionada → Alcance de impacto → Alcance de ejecución → Riesgos |
+| 🚀 Modo Rápido | Resumen de dirección de una página: Problema → Solución → Definición de Éxito |
+| 📦 Modo Completo | Análisis del Mejor Punto de Entrada + Resumen de Spec de Producto |
+| 🔄 Modo Revisión | Resumen de spec de producto de revisión: Comparación antes/después + Qué cambiar/Qué no cambiar + Métricas de éxito |
+| ✏️ Modo Personalizado | Resumen de Spec de Producto (campos no ejecutados marcados "No Ejecutado") |
+| ⚡ Modo Build | Resumen de ejecución orientado a ingenieros |
+
+### Anulación de Idioma de Output
+
+Los usuarios pueden solicitar outputs en un idioma diferente al de la sesión de planificación:
+- "Genera el PR-FAQ en japonés"
+- "Genera el reporte en español"
+- "Escribe el PRD en chino"
+
+Cuando se solicita una anulación de idioma:
+1. Generar el contenido del output en el idioma solicitado
+2. Mantener los nombres de frameworks en inglés (JTBD, PR-FAQ, North Star, etc.)
+3. Volver al idioma original de la sesión de planificación después de la generación del output
+4. Nota: Esto solo afecta el idioma del documento de output, no los archivos de referencia ni el flujo de planificación
+
+## Prompt de Output Extendido
+
+Después de completar el output final integrado, preguntar proactivamente:
+
+```
+"¡El contenido de planificación ha sido completamente integrado! ¿Te gustaría que genere alguno de los siguientes documentos?
+
+□ [Tipo de documento] actualizado (actualización incremental basada en el documento fuente subido) ← solo mostrar cuando se subió un documento fuente
+□ Documento PDF (diseño profesional con navegación por marcadores, adecuado para compartir formalmente)
+□ Reporte de planificación HTML (interactivo, adecuado para compartir en línea)
+□ Documento Word (adecuado para edición colaborativa)
+□ Paquete de entrega de ingeniería PRD (incluye diagramas de flujo, DB Schema, wireframes UI)
+□ Presentación PPTX (adecuada para reportes en reuniones, se recomienda pulir con Keynote / PowerPoint después de exportar)
+□ Paquete de handoff de desarrollo (CLAUDE.md + TASKS.md + TICKETS.md + arquitectura técnica — listo para iniciar desarrollo en Claude Code)
+□ Todo lo anterior
+
+También puedes decir 'No, gracias' para terminar, o especificar un documento en particular.
+También puedes usar /export [pdf|docx|pptx|html|md] para exportar en cualquier momento."
+```
+
+**Reglas de visualización de opciones**:
+- Documento fuente subido → "[Tipo de documento] actualizado" listado primero con etiqueta "(recomendado)"
+- Audiencia objetivo son ingenieros → PRD y paquete de handoff de desarrollo listados primero
+- Audiencia objetivo son ejecutivos/liderazgo → PDF y presentación listados primero
+- Audiencia objetivo es cross-funcional → PDF, reporte HTML y presentación todos listados
+- Modo Rápido → Solo preguntar si se necesita PDF o presentación
+- Audiencia objetivo eres tú mismo → Paquete de handoff de desarrollo listado primero
+
+**Reglas de activación de exportación**:
+- El usuario selecciona PDF / Word / Presentación PPTX → Cargar `rules-export-document.md`
+- Primera vez que se activa exportación de documentos → Cargar `rules-document-tools.md` primero para verificar e instalar herramientas necesarias
+- El usuario selecciona reporte de planificación HTML → Cargar `06-html-report.md` (reglas existentes)
+- El usuario selecciona "Todo lo anterior" → Ejecutar cada exportación de formato en secuencia

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

@@ -0,0 +1,346 @@
+# Reglas de Exportación de Documentos Multi-Formato
+
+> Se carga cuando el usuario activa `/export [formato]` o selecciona un formato de exportación después de que el flujo termina.
+> En el primer uso, cargar `rules-document-tools.md` primero para confirmar que las herramientas están instaladas.
+
+## Formatos de Exportación Soportados
+
+| Formato | Comando | Ruta de Conversión | Herramientas |
+|---------|---------|-------------------|-------------|
+| PDF | `/export pdf` | HTML+CSS → Playwright → pikepdf marcadores | Playwright MCP + pikepdf |
+| DOCX | `/export docx` | MD → Pandoc | pandoc + reference.docx |
+| PPTX | `/export pptx` | MD → Pandoc | pandoc |
+| HTML | `/export html` | Reglas existentes de `06-html-report.md` | Integrado |
+| Markdown | `/export md` | Salida directa | Integrado |
+
+---
+
+## Exportación PDF (Flujo Principal)
+
+### Selección de Ruta
+
+La exportación PDF tiene dos rutas, seleccionadas automáticamente según el contenido fuente:
+
+| Fuente | Ruta | Razón |
+|--------|------|-------|
+| Exportación directa del output de planificación (PRD / actualización incremental / especificación) | **Ruta A: setContent** | Sin dependencias JS externas, todos los recursos pueden estar en línea |
+| Reporte de planificación HTML a PDF (con diagramas Mermaid / fuentes CDN) | **Ruta B: Servidor HTTP** | Necesita cargar JS externo (mermaid.js) y fuentes CDN |
+
+### Ruta A: Documento Independiente → PDF (setContent)
+
+Aplicable a: PRD, actualizaciones incrementales de extensión de funcionalidades, especificaciones, cualquier contenido sin JS externo.
+
+**Paso 1: Generar Contenido HTML**
+
+Claude lee `references/templates/prd-style.css` y genera un documento HTML completo:
+
+```html
+<!DOCTYPE html>
+<html lang="zh-TW">
+<head>
+<meta charset="UTF-8">
+<style>
+/* Leer el contenido completo de prd-style.css e insertar aquí en línea */
+</style>
+</head>
+<body>
+
+<!-- Página de portada -->
+<div class="cover-page">
+  <h1>[Título del Documento]</h1>
+  <div class="subtitle">[Subtítulo o descripción en una línea]</div>
+  <div class="version-badge">[Número de Versión]</div>
+  <div class="meta-info">
+    <strong>PM</strong> [Nombre del PM]<br>
+    <strong>Fecha</strong> [Fecha ISO]<br>
+    <strong>Estado</strong> [Estado]
+  </div>
+</div>
+
+<!-- Leyenda (solo para documentos de actualización incremental) -->
+<div class="diff-legend">
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-new"></div> Nuevo en esta versión</div>
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-upd"></div> Modificado en esta versión</div>
+  <div class="diff-legend-item"><div class="diff-legend-swatch swatch-unchanged"></div> Sin cambios</div>
+</div>
+
+<!-- Página de tabla de contenidos -->
+<div class="toc-page">
+  <h2>Tabla de Contenidos</h2>
+  <ul class="toc">
+    <!-- Claude auto-genera elementos del TOC basándose en encabezados h2 -->
+    <li>
+      <span class="toc-title">[Nombre de Sección]</span>
+      <span class="toc-dots"></span>
+      <span class="toc-page-num">[Número de Página]</span>
+    </li>
+  </ul>
+</div>
+
+<!-- Contenido del cuerpo -->
+[HTML del Cuerpo]
+
+<!-- Pie de página -->
+<div class="doc-footer">
+  [Código del Documento] [Versión] ｜ [Fecha] ｜ Generado por Product Playbook
+</div>
+
+</body>
+</html>
+```
+
+**Importante**:
+- El CSS debe estar completamente en línea (sin enlaces externos)
+- Las fuentes usan fuentes del sistema: `"PingFang TC", "Noto Sans TC", system-ui` (Playwright las incrustará automáticamente en el PDF)
+- Sin etiquetas `<script>` ni referencias a recursos externos
+- Los números de página del TOC son estimaciones (pueden necesitar ajuste fino después de la generación del PDF)
+
+**Paso 2: Playwright Renderiza el PDF**
+
+Guardar el contenido HTML en `/tmp/export-{timestamp}.html`, luego llamar a Playwright MCP:
+
+```javascript
+// mcp__plugin_playwright_playwright__browser_run_code
+async (page) => {
+  const fs = require('fs');
+  const html = fs.readFileSync('/tmp/export-{timestamp}.html', 'utf8');
+  await page.setContent(html, { waitUntil: 'networkidle' });
+  await page.pdf({
+    path: '{output_path}',
+    format: 'A4',
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' },
+    printBackground: true,
+    displayHeaderFooter: true,
+    headerTemplate: '<div></div>',
+    footerTemplate: '<div style="font-size:8pt;color:#999;text-align:center;width:100%;">p.<span class="pageNumber"></span> / <span class="totalPages"></span></div>'
+  });
+  return 'PDF generated';
+}
+```
+
+> Nota: Si el contenido HTML es demasiado grande (>500KB), setContent puede agotar el tiempo de espera. En ese caso, cambiar a la Ruta B (Servidor HTTP).
+
+**Paso 3: Inyección de Marcadores con pikepdf**
+
+```python
+import pikepdf, re
+
+pdf = pikepdf.open('{output_path}')
+
+# Extraer encabezados h2 del HTML como marcadores
+# Claude debe registrar el número de página estimado para cada h2 al generar el HTML
+bookmarks = [
+    # (título, índice de página base 0)
+    ("Historial de Revisiones", 2),
+    ("User Story", 4),
+    ("Arquitectura de Desarrollo", 6),
+    # ... generado según el contenido real
+]
+
+with pdf.open_outline() as outline:
+    for title, page_idx in bookmarks:
+        page_idx = min(page_idx, len(pdf.pages) - 1)
+        outline.root.append(
+            pikepdf.OutlineItem(title, page_idx)
+        )
+
+# Establecer metadatos del PDF
+with pdf.open_metadata() as meta:
+    meta['dc:title'] = '[Título del Documento]'
+    meta['dc:creator'] = ['[Nombre del PM]']
+    meta['pdf:Producer'] = 'Product Playbook + Playwright'
+
+pdf.save('{output_path}')
+```
+
+**Paso 4: Notificar al Usuario**
+
+```
+✅ PDF exportado a: {output_path}
+  📄 {page_count} páginas ｜ {file_size}
+  📑 Incluye navegación por marcadores ({bookmark_count} secciones)
+```
+
+### Ruta B: Reporte HTML → PDF (Servidor HTTP)
+
+Aplicable a: Reportes HTML con diagramas Mermaid, fuentes CDN, elementos interactivos.
+
+**Paso 1: Reporte HTML Ya Generado**
+
+El reporte HTML es generado por las reglas de `06-html-report.md` y guardado como `/tmp/report-{timestamp}.html`.
+
+**Paso 2: Iniciar Servidor HTTP**
+
+```bash
+cd /tmp && python3 -m http.server 18899 &
+echo $!  # Registrar PID
+```
+
+**Paso 3: Renderizado con Playwright**
+
+```javascript
+// mcp__plugin_playwright_playwright__browser_run_code
+async (page) => {
+  await page.goto('http://localhost:18899/report-{timestamp}.html', {
+    waitUntil: 'networkidle',
+    timeout: 30000
+  });
+  // Esperar a que el renderizado de gráficos Mermaid se complete
+  await page.waitForTimeout(3000);
+  // Expandir todos los elementos accordion (<details>)
+  await page.evaluate(() => {
+    document.querySelectorAll('details').forEach(d => d.open = true);
+  });
+  await page.pdf({
+    path: '{output_path}',
+    format: 'A4',
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' },
+    printBackground: true,
+    displayHeaderFooter: true,
+    headerTemplate: '<div></div>',
+    footerTemplate: '<div style="font-size:8pt;color:#999;text-align:center;width:100%;">p.<span class="pageNumber"></span> / <span class="totalPages"></span></div>'
+  });
+  return 'PDF generated';
+}
+```
+
+**Paso 4: Apagar Servidor HTTP + Marcadores pikepdf**
+
+```bash
+kill {SERVER_PID}
+```
+
+Luego realizar el mismo paso de inyección de marcadores con pikepdf que en la Ruta A.
+
+### Fallback cuando Playwright MCP No Está Disponible
+
+Si Playwright MCP no está conectado, usar Node.js directamente:
+
+```bash
+node -e "
+const { chromium } = require('playwright');
+const fs = require('fs');
+(async () => {
+  const browser = await chromium.launch({ headless: true });
+  const page = await browser.newPage();
+  const html = fs.readFileSync('/tmp/export-{timestamp}.html', 'utf8');
+  await page.setContent(html, { waitUntil: 'networkidle' });
+  await page.pdf({
+    path: '${OUTPUT_PATH}',
+    format: 'A4',
+    printBackground: true,
+    margin: { top: '1.8cm', bottom: '1.8cm', left: '2cm', right: '2cm' }
+  });
+  await browser.close();
+  console.log('PDF generated');
+})();
+"
+```
+
+---
+
+## Exportación DOCX
+
+### Paso 1: Generar Markdown
+
+Claude organiza el output de planificación en formato Markdown limpio y lo guarda como `/tmp/export-{timestamp}.md`.
+
+### Paso 2: Conversión con Pandoc
+
+```bash
+pandoc /tmp/export-{timestamp}.md \
+  -o "{output_path}" \
+  --from markdown \
+  --to docx \
+  --reference-doc="~/.claude/skills/product-playbook/references/templates/reference.docx" \
+  --toc \
+  --toc-depth=2
+```
+
+Si no hay plantilla reference.docx disponible, omitir el parámetro `--reference-doc` (usa estilos por defecto de Pandoc).
+
+### Paso 3: Notificar al Usuario
+
+```
+✅ Documento Word exportado a: {output_path}
+  📄 Incluye tabla de contenidos ｜ {file_size}
+```
+
+---
+
+## Exportación PPTX
+
+```bash
+pandoc /tmp/export-{timestamp}.md \
+  -o "{output_path}" \
+  --from markdown \
+  --to pptx \
+  --slide-level=2
+```
+
+> Consejo: La calidad de PPTX de Pandoc es limitada. Se recomienda usar el PPTX como esquema, luego pulir con PowerPoint/Keynote.
+
+---
+
+## Manejo Especial para Documentos de Actualización Incremental
+
+Al exportar documentos de actualización incremental del modo Extensión de Funcionalidades o Revisión:
+
+### Reglas de Marcado Visual de Diferencias
+
+1. **Párrafos marcados `[NEW]`**:
+   - Usar marcador `<span class="new">NEW</span>`
+   - Las filas de tabla obtienen `class="new-row"`
+   - Los párrafos obtienen `class="diff-added"`
+
+2. **Párrafos marcados `[UPDATED]`**:
+   - Usar marcador `<span class="upd">UPDATED</span>`
+   - Las filas de tabla obtienen `class="upd-row"`
+   - Si existe contenido original, el contenido original obtiene `class="diff-removed"`, el nuevo contenido obtiene `class="diff-added"`
+
+3. **Párrafos sin cambios**: Se muestran normalmente, sin marcadores especiales
+
+4. **Leyenda al inicio del documento**:
+```html
+<div class="diff-legend">
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-new"></div> Nuevo en esta versión
+  </div>
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-upd"></div> Modificado en esta versión
+  </div>
+  <div class="diff-legend-item">
+    <div class="diff-legend-swatch swatch-unchanged"></div> Sin marcador = Sin cambios
+  </div>
+</div>
+```
+
+---
+
+## Reglas de Ruta de Salida
+
+Salida por defecto a `~/Downloads/`, formato del nombre de archivo:
+
+```
+[Código del Documento] [Título del Documento] [Versión].{ext}
+
+Ejemplos:
+[D-221] Cuenta Virtual v1.0.14 Versión Completa Fusionada.pdf
+Reporte de Planificación de Producto - Cuenta Virtual UPASS.docx
+```
+
+Si el usuario especifica una ruta, usar la ruta especificada por el usuario.
+
+---
+
+## Lista de Verificación de Calidad
+
+Antes de exportar, Claude auto-verifica:
+
+- [ ] No queda sintaxis Markdown residual en el HTML (`**`, `##`, `|---|`)
+- [ ] Todos los conteos de filas y columnas de tablas coinciden con el contenido original
+- [ ] Los marcadores `[NEW]` / `[UPDATED]` están correctamente mapeados a las clases CSS correspondientes
+- [ ] La información de la portada (título, versión, PM, fecha) es correcta
+- [ ] Los elementos del TOC coinciden con los encabezados h2 del cuerpo
+- [ ] El CSS está completamente en línea (Ruta A) o el CDN es accesible (Ruta B)
+- [ ] El conteo de marcadores coincide con el conteo de encabezados h2

package/i18n/es/references/rules-file-integration.md

@@ -0,0 +1,65 @@
+# 📎 Guía de Integración de Archivos
+
+> Se carga cuando el usuario sube materiales complementarios.
+
+## Tipos de Archivo Directamente Soportados
+
+| Tipo de Archivo | Escenarios Comunes | Método de Integración |
+|----------------|-------------------|----------------------|
+| **Imágenes** | Capturas de pantalla de competidores, fotos de pizarrón, journey maps dibujados a mano, capturas de interfaz de app, capturas de reportes de datos | Reconocer contenido e integrar al paso correspondiente |
+| **PDF** | Reportes de mercado, documentos internos, reportes de investigación de usuarios, PRDs existentes | Cargar `rules-import-document.md` para análisis de tres capas (extracción directa pymupdf → análisis semántico Claude Vision → fallback Tesseract). En el primer uso, cargar `rules-document-tools.md` para verificar herramientas. |
+| **CSV / Excel** | Datos de comportamiento de usuario, datos de retención, resultados de encuestas NPS, datos de ventas | Analizar datos y usar para evaluación cuantitativa |
+| **Archivos de texto** | Transcripciones de entrevistas, documentos de requisitos existentes, notas de reuniones | Extraer pistas de Persona, puntos de dolor, evidencia JTBD |
+| **DOCX** | PRDs existentes, documentos de especificación de producto, reportes de investigación de usuarios | Cargar `rules-import-document.md`, usar Pandoc para convertir a Markdown luego integrar. En el primer uso, cargar `rules-document-tools.md` para verificar herramientas. |
+| **PPTX** | Presentaciones existentes, diapositivas de introducción de producto | Cargar `rules-import-document.md`, usar Pandoc para convertir a Markdown luego integrar. |
+
+## No Directamente Soportados pero con Guía Disponible
+
+| Tipo de Archivo | Guía |
+|----------------|------|
+| **Video** | Pedir al usuario que describa escenas clave, o proporcionar transcripción/archivo de subtítulos |
+| **Figma / Sketch** | Pedir al usuario que tome capturas de pantalla y las suba |
+| **Protobuf / Swagger** | Pedir al usuario que exporte como formato JSON o texto |
+
+## Tabla de Auto-Mapeo Archivo → Paso
+
+| Contenido Subido | Paso Auto-Mapeado | Acción de Integración |
+|-----------------|-------------------|----------------------|
+| Capturas de app / sitio web de competidores | Posicionamiento | Identificar como "alternativas competitivas," analizar diferenciación |
+| Diagrama de flujo dibujado a mano en pizarrón | Journey Map / OST | Reconocer el flujo y convertir a tabla estructurada |
+| Transcripción de entrevista de usuario | Persona + JTBD | Extraer puntos de dolor, soluciones alternativas actuales, reacciones emocionales, declaraciones de Job |
+| Datos de comportamiento de usuario (CSV) | Evaluación de Oportunidades + North Star + PMF | Reemplazar puntuaciones basadas en suposiciones con datos reales |
+| Encuesta NPS / satisfacción | PMF + Sean Ellis Score | Calcular directamente el Score; determinar nivel de PMF |
+| PRD existente / documento de requisitos | Modo Revisión S1 + MVP | Extraer lista de funcionalidades existentes e historial de decisiones |
+| Reporte de mercado PDF | Evaluación de Oportunidades + Estrategia | Extraer tamaño de mercado, tendencias, panorama competitivo |
+| Datos de ventas | Modelo de Negocio + GTM | Analizar estructura de ingresos, distribución de clientes, efectividad de canales |
+| Capturas de interfaz de app | Aha Moment + Journey | Analizar la ruta de experiencia actual |
+
+## Reglas de Integración
+
+1. **Identificación proactiva**: Primero explica "Veo que subiste [tipo de archivo]. Integraré la [información clave] de este en [nombre del paso]."
+2. **No sobrescribir output existente**: Marca el contenido subido como "material complementario," actualiza el output y activa las reglas de propagación de cambios
+3. **Marcar la fuente**: Anota en el output qué contenido provino del archivo subido (p.ej., "✦ Del reporte de investigación de usuarios subido")
+4. **Datos tienen prioridad**: Cuando datos reales entran en conflicto con suposiciones previas, priorizar los datos reales
+5. **Impacto cross-paso**: Un solo archivo puede afectar múltiples pasos — listar todos los pasos afectados a la vez
+
+## 📎 Identificación de Documento Fuente y Actualización Incremental
+
+Cuando un usuario sube un archivo durante la **Extensión de Funcionalidades** o el **Modo Revisión**, determinar si es un "documento fuente" (un documento que debe actualizarse incrementalmente con la nueva planificación):
+
+### Criterios de Identificación
+- Tipo de archivo: PRD, especificación de producto, documento de arquitectura, documento de requisitos, documento de diseño
+- El usuario dice explícitamente: "este es nuestro PRD actual", "actualiza este documento", "construye sobre esta especificación", etc.
+- Subido durante S1 (recopilación de contexto) de Extensión de Funcionalidades o Modo Revisión
+
+### Cuando Se Identifica un Documento Fuente
+1. Marcarlo: "📎 Documento fuente detectado — la salida final será una actualización incremental basada en este archivo"
+2. Analizar la estructura del documento (encabezados de sección, convenciones de formato, patrones de nomenclatura)
+3. Registrar el formato y estilo del documento para una salida consistente
+4. Durante S1, usar el documento para prellenar el contexto del sistema existente (stack tecnológico, módulos, funcionalidades)
+
+### Reglas de Salida Incremental (aplicadas en la etapa de Salida Final)
+- El contenido nuevo se inserta en las secciones correspondientes, marcado con `[NEW]`
+- El contenido modificado se marca con `[UPDATED]`, el contenido original se preserva como comentario
+- Las secciones no relacionadas con la nueva funcionalidad permanecen intactas
+- El documento de salida mantiene el formato, estilo y convenciones de nomenclatura del archivo original

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

@@ -0,0 +1,66 @@
+# 📦 Secuencia de Pasos del Modo Completo (20 Pasos + Output Final)
+
+> Este archivo es la definición autoritativa de pasos para el Modo Completo. Cargado por el despachador central de SKILL.md.
+
+## Secuencia de Pasos
+
+```
+Fase 0: Prerequisitos
+  S1.  Evaluación de Oportunidad + DHM → Leer references/00-opportunity-check.md
+  S2.  Strategy Blocks + Kernel de Estrategia de Rumelt → Leer references/01-strategy.md
+
+Fase 1: Descubrimiento
+  S3.  Tabla de Personas → Leer references/02a-persona.md
+  S4.  Tarjetas de Persona → Leer references/02a-persona.md
+  S5.  Análisis JTBD → Leer references/02b-jtbd.md
+  S6.  Opportunity Solution Tree (OST) → Leer references/02c-ost-journey.md
+  S7.  User Journey Map → Leer references/02c-ost-journey.md
+
+Fase 2: Definición
+  S8.  Tabla de Resumen de Puntos de Dolor → Leer references/03-define.md
+  S9.  Posicionamiento April Dunford → Leer references/03-define.md
+  S10. Reformulación HMW → Leer references/03-define.md
+  S11. Tabla de Evaluación de Oportunidades → Leer references/03-define.md
+
+Fase 3: Desarrollo
+  S12. PR-FAQ → Leer references/04a-prfaq.md
+  S13. Prototipos Paralelos → Leer references/04b-solutions.md
+  S14. Pre-mortem → Leer references/04b-solutions.md
+  S15. Priorización GEM + RICE → Leer references/04b-solutions.md
+  S16. User Story → Leer references/04b-solutions.md
+  S17. MVP + Lista de No Hacer → Leer references/04c-mvp.md
+
+Fase 4: Entrega
+  S18. North Star + Señales de Tres Capas + Aha Moment → Leer references/05a-northstar-aha.md
+  S19. Evaluación de Nivel PMF + Estrategia GTM + Modelo de Negocio → Leer references/05b-pmf-gtm.md
+  S20. Plan de Validación de Hipótesis → Leer references/05c-validation-spec.md
+────
+Output Final → Resumen de Spec de Producto (references/05c-validation-spec.md → 4.6) + Análisis del Mejor Punto de Entrada
+```
+
+> En Modo Completo, la sección 4.1 Empowered Teams se agrega antes de S18 cuando la audiencia objetivo es ejecutivos o equipos cross-funcionales; de lo contrario se omite.
+
+## Instrucciones de Carga de Referencias
+
+Al entrar a cada paso, solo lee el archivo de referencia correspondiente (no pre-cargar todos los archivos):
+
+| Paso | Archivo de Referencia |
+|------|----------------------|
+| S1 | `references/00-opportunity-check.md` |
+| S2 | `references/01-strategy.md` |
+| S3-S4 | `references/02a-persona.md` |
+| S5 | `references/02b-jtbd.md` |
+| S6-S7 | `references/02c-ost-journey.md` |
+| S8-S11 | `references/03-define.md` |
+| S12 | `references/04a-prfaq.md` |
+| S13-S16 | `references/04b-solutions.md` |
+| S17 | `references/04c-mvp.md` |
+| S18 | `references/05a-northstar-aha.md` |
+| S19 | `references/05b-pmf-gtm.md` |
+| S20 + Output Final | `references/05c-validation-spec.md` |
+
+## Formato del Output Final
+
+**Análisis del Mejor Punto de Entrada** (cadena lógica completa) + **Resumen de Spec de Producto**
+
+Al completar, sigue `references/rules-end-of-flow.md` para ejecutar las reglas de fin de flujo.