## Asset Header

- **Asset ID:** SOP-MPX-BookFactory-Fase6-Publicacion-v01
- **Version:** v01
- **Status:** Draft
- **Owner:** Victor Heredia
- **IntellBank:** IB-MPX-MasterPlaybooks
- **Tipo:** SOP — Standard Operating Procedure
- **Propósito:** FASE 6 — Publicación
- **Última actualización:** 2026-04-11

---

# FASE 6 — Publicación
## Upload final + Checkpoint humano #3 + Go-live de Sherpa

> **Status:** 🔲 Sprint 3 — Pendiente de implementar
> **Posición en el flujo:** Después de Fase 5 (QA aprobado) · Fin del pipeline
> **Checkpoint humano:** #3 — El tercero y último del sistema

---

## Propósito

La Fase 6 es el momento en que los artefactos producidos por la fábrica llegan a sus destinos finales:

- El `.docx` de Fase 3 → **al lector** (publicación en la plataforma)
- La Fuente Completa de Fase 4 → **al sistema RAG** (Sherpa activo)

Solo se ejecuta si el QA de Fase 5 emitió dictamen **APROBADO** o **REVISIÓN HUMANA resuelta**.

**Principio:** La publicación es irreversible desde la perspectiva del lector. El checkpoint humano existe exactamente aquí para dar una última oportunidad de revisión antes de que Sherpa esté en producción.

---

## Condiciones de Entrada

| Condición | Acción |
|-----------|--------|
| QA dictamen = APROBADO | → Proceder a Checkpoint #3 |
| QA dictamen = REVISIÓN HUMANA | → Operador resuelve → si aprueba: Checkpoint #3 |
| QA dictamen = RECHAZADO | → ❌ No entra a Fase 6. Regresar a fase indicada |

---

## Flujo de la Fase 6

```
[QA Aprobado]
      ↓
[PROMPT 6.1] Preparación del Paquete de Publicación
      ↓
Paquete completo con todos los artefactos verificados
      ↓
⚑ CHECKPOINT HUMANO #3 — Revisión y aprobación final
      ↓
    [Aprueba]                    [Rechaza / Solicita ajuste]
      ↓                                    ↓
[Acción 6.A] Upload .docx          → Regresa a fase específica
[Acción 6.B] Upload Fuente RAG          con nota del operador
[Acción 6.C] Activar Sherpa
      ↓
[PROMPT 6.2] Verificación Post-Publicación
      ↓
Registro final en sistema
```

---

## PROMPT 6.1 — Preparación del Paquete de Publicación

```
Eres el coordinador de publicación del sistema Master Playbooks.

Tu tarea es preparar el paquete completo de publicación,
verificar que todos los artefactos estén correctos y listos,
y generar el briefing para el checkpoint humano final.

LIBRO: {{titulo}}
AUTOR: {{autor}}
SCORE QA: {{score_qa}} / 10
DICTAMEN QA: {{dictamen}}

ARTEFACTOS DISPONIBLES:
- Resumen publicable .docx (Fase 3): {{ruta_docx}}
- Fuente Completa RAG .md (Fase 4): {{ruta_fuente_completa}}
- Reporte QA (Fase 5): {{reporte_qa}}
- Chunks .md (Fase 3): {{ruta_chunks}}
- Prompts visuales (Fase 3): {{prompts_visuales}}

VERIFICACIÓN AUTOMÁTICA:

## 1. Verificación del .docx
[ ] El archivo existe y es un ZIP válido
[ ] Tiene estructura de estilos correcta (H2/H3/H4/H5/Body)
[ ] Contiene: Sinopsis · Resumen Express · Resumen Amplio · Playbooks · Sobre el Autor · Disclaimer
[ ] Resumen Express está entre 400-500 palabras
[ ] Cada sección del Resumen Amplio tiene su Playbook completo (7 elementos)
[ ] El Disclaimer está presente y completo
Estado: [✅ LISTO / ⚠️ PROBLEMA: ...]

## 2. Verificación de la Fuente Completa RAG
[ ] El archivo .md existe y tiene los 4 bloques en el orden correcto
[ ] Bloque 1 contiene todos los lentes cognitivos y filtros negativos
[ ] Todos los chunks tienen headers semánticos
[ ] Todos los chunks tienen Prioridad RAG y Preguntas activadoras
[ ] El Índice de Chunks está presente al final
[ ] Versión del documento registrada
Estado: [✅ LISTO / ⚠️ PROBLEMA: ...]

## 3. Verificación del Reporte QA
[ ] Score global: [X.X]/10 ≥ 8.0
[ ] Ningún fallo en Tipo D (trampas)
[ ] Máximo 1 fallo en Tipo C (bordes)
[ ] Dictamen oficial emitido
Estado: [✅ LISTO / ⚠️ PROBLEMA: ...]

## 4. Artefactos complementarios
[ ] 5 prompts visuales disponibles para diseño
[ ] Metadata de clasificación completa (para configurar la plataforma)
Estado: [✅ LISTO / ⚠️ PROBLEMA: ...]

---

## BRIEFING PARA CHECKPOINT HUMANO #3

**Libro:** {{titulo}}
**Autor:** {{autor}}
**Score QA:** {{score_qa}}/10
**Fecha de procesamiento:** {{fecha}}
**Flujo ejecutado:** {{flujo}} [Con libro / Sin libro]

### Resumen del proceso
- Fase 1A: [✅/⚠️] Investigación del libro y autor
- Fase 2: [✅/N/A] Libro Virtual (score de cobertura: {{score_cobertura}}%)
- Fase 1B: [✅/⚠️] {{N}} lentes cognitivos · {{N}} filtros negativos
- Fase 3: [✅/⚠️] .docx generado · {{N}} chunks RAG
- Fase 4: [✅/⚠️] Fuente Completa · {{N}} chunks totales
- Fase 5: [✅/⚠️] {{N}} preguntas QA · Score {{score_qa}}

### Puntos de atención
[Lista de cualquier elemento que el operador debe revisar especialmente:
- Preguntas limítrofes del QA
- Advertencias del proceso
- Áreas de menor cobertura]

### Lo que el operador puede ajustar
1. Corregir errores tipográficos menores en el .docx
2. Ajustar la Sinopsis si no captura bien la esencia del libro
3. Solicitar re-ejecución de una sección específica
4. Rechazar y enviar de regreso a una fase con nota

### Lo que NO puede ajustarse aquí
- La estructura técnica de la Fuente Completa (requiere Fase 4)
- El score QA (se necesita re-ejecutar Fase 5)
- Los lentes cognitivos del autor (requiere Fase 1B)

### Decisión requerida
[ ] ✅ APRUEBO la publicación → proceder con upload
[ ] ⚠️ APRUEBO con ajustes menores → [describir ajuste]
[ ] 🔴 RECHAZO → regresar a [fase] por [motivo]
```

---

## Acciones de Publicación

### Acción 6.A — Upload del Resumen al Lector

**Qué se sube:** El archivo `.docx` generado en Fase 3

**Destino:** Plataforma Master Playbooks (sección pública)

**Metadata requerida para configurar en la plataforma:**

```yaml
titulo: "{{titulo}}"
autor: "{{autor}}"
categoria: "{{categoria}}"
subcategoria: "{{subcategoria}}"
tipo_libro: "{{tipo_libro}}"
audiencia: "{{audiencia}}"
fecha_publicacion: "{{fecha}}"
version: "1.0"
sherpa_activo: true
```

**Verificación post-upload:**
- [ ] El .docx es descargable desde la plataforma
- [ ] La metadata aparece correctamente en la ficha del libro
- [ ] El resumen es visible y navegable

---

### Acción 6.B — Upload de la Fuente Completa al Sistema RAG

**Qué se sube:** El archivo `.md` maestro generado en Fase 4

**Destino:** Sistema RAG de Sherpa (backend de la plataforma)

**Configuración técnica del RAG:**

```yaml
documento_fuente: "{{ruta_fuente_completa}}"
libro_id: "{{id_libro_en_plataforma}}"
version_fuente: "1.0"
chunking: "por-headers-H1"        # El sistema RAG chunka usando los H1 del documento
embedding_model: "{{modelo}}"     # A definir según plataforma
chunk_overlap: 50                 # palabras de overlap entre chunks
prioridad_bloque_1: "alta"        # El Bloque 1 (perfil del autor) siempre se recupera
```

**Verificación post-upload:**
- [ ] El documento está indexado en el sistema RAG
- [ ] El Bloque 1 (Perfil del autor) es recuperable
- [ ] La versión está registrada

---

### Acción 6.C — Activación de Sherpa

**Qué se configura:** El asistente Sherpa queda vinculado a la Fuente Completa del libro

**Configuración del sistema prompt de Sherpa:**

```
Eres Sherpa — el asistente de {{titulo}} de {{autor}}.

Tu función es responder preguntas de los lectores sobre el libro
como si fueras el propio autor explicando sus ideas.

LIBRO DE REFERENCIA: {{titulo}}
AUTOR: {{autor}}

FUENTE DE CONOCIMIENTO: [Fuente Completa v1.0 indexada en RAG]

REGLAS DE VOZ:
- Responde siempre usando el vocabulario y los lentes cognitivos
  del perfil intelectual del autor
- Aplica los filtros negativos ("Lo que NUNCA diría") en cada respuesta
- Si una pregunta excede el contenido del libro, sigue las instrucciones
  de manejo de incertidumbre del perfil

REGLAS DE LÍMITES:
- No inventes información que no esté en la Fuente Completa
- Si no sabes algo, dilo honestamente y en la voz del autor
- No atribuyas al autor ideas que no aparecen en el libro

TIPO DE AUTORÍA: {{tipo_autoria}}
[Si colectiva: "Cuando sea relevante, puedes indicar que este capítulo
fue escrito por {{colaborador}} — mantén la voz filosófica del director"]
```

**Verificación de activación:**
- [ ] Sherpa responde preguntas básicas sobre el libro
- [ ] Sherpa usa el vocabulario del autor
- [ ] Sherpa rechaza afirmaciones falsas (test rápido con 1-2 preguntas Tipo D)
- [ ] Sherpa está vinculado al libro correcto en la plataforma

---

## PROMPT 6.2 — Verificación Post-Publicación

```
Realiza una verificación rápida post-publicación de Sherpa.

LIBRO: {{titulo}} | AUTOR: {{autor}}
PERFIL DEL AUTOR (para verificar voz): {{perfil_intelectual}}

Ejecuta las siguientes 5 preguntas de verificación rápida:

1. [Pregunta sobre la tesis central]
2. [Pregunta de aplicación básica]
3. [Pregunta de borde: tema que el libro no cubre]
4. [Pregunta trampa simple]
5. "¿Quién eres?" / "¿Qué libro representa este asistente?"

Para cada respuesta de Sherpa:
- ¿Pasa el estándar mínimo? [Sí / No]
- ¿Alguna señal de alarma? [describir si aplica]

RESULTADO FINAL:
[ ] ✅ Sherpa verificado — publicación completa
[ ] ⚠️ Detecté [problema] — requiere atención inmediata
```

---

## Registro Final en Sistema

Una vez completada la publicación, se registra:

```
LIBRO PROCESADO: {{titulo}} — {{autor}}
FECHA DE PUBLICACIÓN: {{fecha}}
FLUJO EJECUTADO: {{flujo}} [Con libro / Sin libro]
SCORE QA FINAL: {{score_qa}} / 10
VERSIÓN DE LA FUENTE COMPLETA: 1.0
OPERADOR QUE APROBÓ: {{operador}}
ARTEFACTOS GENERADOS: {{lista_artefactos}}
PRÓXIMA ACTUALIZACIÓN PROGRAMADA: {{fecha_revision}} [opcional]
```

---

## Checklist Completo — Fase 6

**Entrada:**
- [ ] QA dictamen = APROBADO o REVISIÓN HUMANA resuelta
- [ ] .docx disponible y válido (Fase 3)
- [ ] Fuente Completa .md disponible y válida (Fase 4)

**Paquete de publicación:**
- [ ] PROMPT 6.1 ejecutado con verificación automática completa
- [ ] Todos los artefactos en estado ✅ LISTO
- [ ] Briefing para Checkpoint #3 generado

**Checkpoint humano #3:**
- [ ] El operador revisó el briefing
- [ ] El operador tomó decisión explícita (Aprobar / Rechazar)
- [ ] Si aprueba con ajustes: los ajustes están documentados

**Upload y activación:**
- [ ] .docx subido a la plataforma (Acción 6.A)
- [ ] Metadata del libro configurada en la plataforma
- [ ] Fuente Completa indexada en el sistema RAG (Acción 6.B)
- [ ] Sherpa activado y vinculado al libro (Acción 6.C)
- [ ] Verificación post-publicación completada (PROMPT 6.2)

**Registro:**
- [ ] Registro final completado en el sistema
- [ ] Libro marcado como PUBLICADO en el tracker de producción

---

## Preguntas Abiertas (a resolver durante implementación)

1. **Plataforma técnica:** ¿Qué sistema RAG usa la plataforma? (Pinecone, Weaviate, pgvector, etc.) — afecta la configuración técnica del upload
2. **Chunking automático:** ¿El sistema RAG procesa el .md y lo chunka él solo, o se sube ya chunkeado?
3. **Sistema prompt de Sherpa:** ¿Hay un sistema prompt base de la plataforma que se combina con la configuración del libro?
4. **Revisiones futuras:** ¿Cómo se gestiona la v1.1 de la Fuente Completa sin interrumpir a Sherpa en producción?
5. **Métricas de uso:** ¿Se registra qué preguntas hace la gente a Sherpa para mejorar la Fuente Completa?

---

*Fase 6 · Sprint 3 · Master Playbooks Book Factory v2.0*