## Asset Header

- **Asset ID:** DC-MPX-SistemaDiseno-v01
- **Version:** v01
- **Status:** Draft
- **Owner:** Victor Heredia
- **IntellBank:** IB-MPX-MasterPlaybooks
- **Tipo:** DC — Document Canónico
- **Propósito:** MASTER PLAYBOOKS — Diseño del Sistema
- **Última actualización:** 2026-04-11

---

# MASTER PLAYBOOKS — Diseño del Sistema
## Documento vivo · Se actualiza conforme se define cada fase

---

## INTAKE (Entrada del sistema)

### Campos requeridos

| Campo | Tipo | Valores | Notas |
|---|---|---|---|
| `titulo` | texto | libre | Título completo del libro |
| `autor` | texto | libre | Nombre completo del autor/directora |
| `libro_disponible` | booleano | `sí` / `no` | El operador decide antes de entrar al sistema. Si el PDF está incompleto, el operador elige si lo considera disponible o no. |
| `tipo_autoria` | enum | `individual` / `colectiva` | Ver reglas de flujo abajo |

### Reglas de flujo según libro_disponible

```
si libro_disponible = sí
  → Fase 1A: investigación del libro y del autor
  → Fase 2:  SE OMITE
  → Fase 1B: lentes cognitivos y voz derivados del libro original
  → Fase 3:  producción del resumen desde el libro original

si libro_disponible = no
  → Fase 1A: investigación del libro y del autor
  → Fase 2:  SE ACTIVA → creación del Libro Virtual
  → Fase 1B: lentes cognitivos y voz derivados del Libro Virtual
  → Fase 3:  producción del resumen desde el Libro Virtual
```

### Reglas de flujo según tipo_autoria

```
si tipo_autoria = individual
  → Voz intelectual de Sherpa = voz del autor
  → Lentes cognitivos = específicos del autor

si tipo_autoria = colectiva
  → Voz intelectual de Sherpa = filosofía editorial del director/coordinador
  → Lentes cognitivos = posición académica del director, no de los colaboradores
  → ALERTA: indicar en la Fuente Completa que es obra colectiva
  → Sherpa debe poder responder "este capítulo fue escrito por X experto"
    cuando sea relevante
```

---

## FASE 1A — Investigación del Libro y del Autor

### Status: ✅ Definida y probada (como "Fase 1" original, ahora dividida)

### Propósito
Producir el contexto completo del libro y del autor que servirá de base
para construir el Libro Virtual (Fase 2) o para leer el libro original.
Los lentes cognitivos y la voz NO se derivan aquí — se derivan en Fase 1B
una vez que existe el contenido del libro (real o virtual).

### Input
```
titulo: string
autor: string
[archivo PDF si libro_disponible = sí]
```

### Output
Documento MD con 3 bloques:
1. Clasificación (categoría, subcategoría, enfoque, audiencia, tipo)
2. Investigación del libro (contexto, tesis, argumentos clave, recepción, impacto, limitaciones)
3. Investigación del autor (biografía intelectual, formación, influencias, obra, posición en campo)

### Prompt

```
Eres un investigador especializado en análisis de libros y autores.
Tu tarea es producir una investigación profunda y estructurada
sobre el siguiente libro:

TÍTULO: {{titulo}}
AUTOR: {{autor}}

Realiza una investigación exhaustiva usando todas las fuentes
disponibles: sitio del autor, entrevistas, artículos académicos,
reseñas, podcasts transcritos, Wikipedia, Goodreads, y cualquier
fuente pública relevante.

Produce el siguiente documento estructurado:

---

## 1. CLASIFICACIÓN

- Categoría principal: [Negocios / Desarrollo Personal / Psicología /
  Filosofía / Ciencia / Historia / Otro]
- Subcategoría: [ej. Productividad, Liderazgo, Hábitos, etc.]
- Enfoque primario: [una frase que describe el problema central
  que resuelve o aborda el libro]
- Audiencia objetivo: [a quién va dirigido principalmente]
- Tipo de libro: [Prescriptivo / Narrativo / Analítico / Académico / Híbrido]
- Tipo de autoría: [Individual / Colectiva — si es colectiva,
  identificar al director o coordinador principal]

---

## 2. INVESTIGACIÓN DEL LIBRO

- Contexto de publicación: [año, circunstancias, qué estaba
  pasando en el campo cuando se publicó]
- Tesis central: [la idea principal del libro en 2-3 oraciones,
  con suficiente precisión para guiar una reconstrucción del contenido]
- Argumentos clave: [los 3-5 argumentos principales que sostienen
  la tesis, en orden lógico]
- Estructura del libro: [capítulos o secciones principales
  si se puede determinar desde fuentes externas]
- Recepción crítica: [cómo fue recibido, premios, críticas
  positivas y negativas]
- Impacto y legado: [cómo influyó en su campo, qué cambió]
- Limitaciones conocidas: [críticas válidas, qué no cubre
  o dónde es débil]

---

## 3. INVESTIGACIÓN DEL AUTOR

- Biografía intelectual: [formación, carrera, momentos clave
  que formaron su pensamiento]
- Influencias declaradas: [autores, pensadores, disciplinas que
  el autor cita como influencias]
- Obra completa: [lista de todos sus libros con año y tema central]
- Posición en su campo: [cómo se ubica respecto a otros autores
  del mismo tema]
- Evolución de pensamiento: [cómo han cambiado sus ideas
  a lo largo del tiempo, si aplica]

---

CRITERIOS DE CALIDAD:
- La tesis central debe ser suficientemente precisa para que
  alguien pueda reconstruir el libro sin haberlo leído
- Los argumentos clave deben estar en orden lógico,
  no como lista aleatoria
- La investigación del autor debe revelar qué experiencias
  o formación generaron las ideas del libro
- Cita las fuentes de donde obtuviste la información
```

### Checklist de validación
- [ ] Tesis central expresada con suficiente precisión para guiar el Libro Virtual
- [ ] Argumentos clave documentados (mínimo 3) en orden lógico
- [ ] Mínimo 3 fuentes distintas citadas
- [ ] Clasificación con granularidad suficiente para parametrizar el QA en Fase 5
- [ ] Tipo de autoría identificado (individual / colectiva)

### Prueba realizada
- **Libro:** Nutrición Deportiva: Desde la fisiología a la práctica
- **Autora:** María Marcela González-Gross
- **Resultado:** ✅ Checklist completo.
- **Archivo:** FASE1_NutricionDeportiva_GonzalezGross.md
  (Nota: el archivo incluye lentes y voz como borrador preliminar;
  en el proceso definitivo estos se moverán a Fase 1B)

---

## FASE 1B — Lentes Cognitivos y Voz Intelectual

### Status: 🔲 Pendiente de definir

### Propósito
Derivar los lentes cognitivos del autor y su voz intelectual
a partir del contenido real del libro (original o virtual).
Esta fase ocurre DESPUÉS de tener acceso al contenido.

### Input
```
[libro original PDF] o [Libro Virtual generado en Fase 2]
+ output de Fase 1A (contexto del autor)
```

### Output
Documento MD con 2 bloques:
1. Lentes cognitivos (3-6 frameworks mentales específicos del autor)
2. Voz intelectual (estilo, vocabulario, ejemplos, tono, lo que NO diría)

---

## FASE 2 — Creación del Libro Virtual
### Status: 🔲 Pendiente de definir
### Se activa SOLO cuando libro_disponible = no

---

## FASE 3 — Producción del Resumen
### Status: 🔲 Pendiente de definir

**Secciones del resumen publicable:**
- Sinopsis
- Resumen Express
- Resumen Amplio por capítulos (con Playbook por capítulo)
- Recursos Adicionales

**Estructura fija del Playbook por capítulo:**
1. Objetivo del paso
2. Qué hacer
3. Cómo hacerlo
4. Error común a evitar
5. Mini caso genérico

---

## FASE 4 — Construcción de la Fuente Completa (RAG)
### Status: 🔲 Pendiente de definir

**Arquitectura del documento para RAG:**
- Bloque 1: Perfil del Autor (contexto global siempre recuperable)
- Bloque 2: Mapa Conceptual del Libro
- Bloque 3: Contenido por Capítulo (chunks independientes)
- Bloque 4: Contexto Externo

**Formato:** PDF o MD
**Sistema:** RAG

---

## FASE 5 — QA Automático
### Status: 🔲 Pendiente de definir

**Tipos de preguntas a generar:**
- Recuperación directa
- Aplicación / inferencia
- Preguntas de borde
- Preguntas trampa

---

## FASE 6 — Publicación
### Status: 🔲 Pendiente de definir

---

## DECISIONES DE DISEÑO TOMADAS

| # | Decisión | Motivo | Fecha |
|---|---|---|---|
| 1 | Intake solo pide Título, Autor, libro_disponible y tipo_autoria | El tipo/categoría se genera automáticamente en Fase 1A | Sprint 1 |
| 2 | `libro_disponible` es booleano sí/no | El operador decide antes de entrar. Si el PDF está incompleto, el operador elige. | Rediseño post-prueba |
| 3 | Fase 2 solo se activa cuando libro_disponible = no | Cuando hay libro, se va directo de Fase 1A → 1B → Fase 3 | Rediseño post-prueba |
| 4 | `tipo_autoria` en el intake | Libros multiautor requieren lógica distinta para voz de Sherpa | Fase 1 prueba |
| 5 | Voz de Sherpa en libros colectivos = director, no colaboradores | Mantiene coherencia en las respuestas | Fase 1 prueba |
| 6 | Playbook de libros académicos requiere revisión en Fase 3 | La estructura prescriptiva popular puede no encajar en manuales universitarios | Fase 1 prueba |
| 7 | Fase 1 dividida en 1A y 1B | Lentes cognitivos y voz se derivan siempre del contenido del libro (real o virtual), no de fuentes externas. Esto produce lentes más precisos y consistentes. | Rediseño arquitectónico |

---

## VOLUMEN Y ESCALA

- Target: 20 libros/semana mínimo
- Intervención humana prevista: 3 puntos de control
  1. Validar clasificación y estado del libro (Intake)
  2. Revisar score de QA y aprobar publicación (Fase 6)
  3. Revisión editorial cuando cobertura de fuentes < 60% (Fase 2, solo casos críticos)