docs/user-guide-ES.md

# Guía del Usuario

## Contenido de Innovación: Modos y Habilidades de Desarrollo de Contenido Educativo

**Versión:** 1.1.1
**Audiencia:** Desarrolladores de Contenido Educativo, Diseñadores Instruccionales, Productores de Contenido
**Fecha:** 2026-04-24

---

## 1. Introducción

### 1.1 ¿Qué es Contenido de Innovación?

Contenido de Innovación es un conjunto especializado de **modos** y **habilidades** para Roo Code que transforma cómo se crea, revisa y entrega el contenido educativo. Piensa en ello como tener seis colegas expertos—cada uno especializado en un aspecto diferente del desarrollo de contenido educativo—trabajando junto a ti en tu editor de código.

### 1.2 Conceptos Clave

#### Modos

Un **modo** es una configuración especializada de Roo Code adaptada a un rol específico. Cuando activas un modo, Roo Code adopta el comportamiento, permisos y experiencia de ese rol.

| Modo | Rol | Cuándo Usar |
|------|-----|-------------|
| 📝 Diseñador Curricular | Arquitecto educativo | Al diseñar currículos, objetivos de aprendizaje y estructuras de curso |
| 📖 Escritor Instruccional | Autor de contenido | Al escribir contenido de lecciones, ejercicios y documentación para aprendices |
| 🧪 Desarrollador de Evaluaciones | Especialista en medición | Al crear cuestionarios, rúbricas y criterios de evaluación |
| 🎬 Productor de Contenido | Creador multimedia | Al producir guiones de video, contenido interactivo y activos multimedia |
| 🎨 Diseñador de Experiencia de Aprendizaje | Especialista en engagement | Al diseñar journeys de aprendizaje, gamificación y microaprendizaje |
| ♿ Auditor de Accesibilidad | Especialista en inclusión | Al auditar contenido para cumplimiento WCAG y accesibilidad |

#### Habilidades

Una **habilidad** es una capacidad reutilizable que los modos pueden invocar. Las habilidades son como herramientas especializadas en un taller—cada una hace un trabajo específico bien.

Por ejemplo, el modo Diseñador Curricular tiene estas habilidades:
- `learning-objective-validator` — Verifica que los objetivos usen verbos apropiados de la Taxonomía de Bloom
- `competency-mapper` — Mapea objetivos a estándares como Common Core o NGSS
- `curriculum-gap-analyzer` — Encuentra brechas en la cobertura del currículo

### 1.3 Cómo Funciona

```
Proporcionas entrada → El modo la procesa usando habilidades → Obtienes salida estructurada
```

Cada modo sigue un flujo de trabajo definido, aplica mejores prácticas y se comunica con otros modos a través de transferencias estandarizadas.

---

## 2. Primeros Pasos

### 2.1 Tu Primera Sesión

**Paso 1: Elige Tu Modo**

Piensa en lo que intentas lograr:

- "Necesito diseñar un nuevo curso" → **Diseñador Curricular**
- "Necesito escribir contenido de lección" → **Escritor Instruccional**
- "Necesito crear un cuestionario" → **Desarrollador de Evaluaciones**
- "Necesito producir un video" → **Productor de Contenido**
- "Necesito diseñar un journey de aprendizaje" → **Diseñador LX**
- "Necesito verificar accesibilidad" → **Auditor de Accesibilidad**

**Paso 2: Activa el Modo**

En Roo Code, cambia a tu modo elegido:

```
Switch to curriculum-designer mode
```

**Paso 3: Proporciona Tu Entrada**

Da al modo contexto sobre en qué estás trabajando:

```
Necesito crear un currículo para un curso de biología de secundaria sobre fotosíntesis.
La audiencia objetivo son estudiantes de noveno grado. El curso debe alinearse con estándares NGSS.
```

**Paso 4: Revisa la Salida**

El modo generará salida estructurada. Revísala y proporciona retroalimentación:

```
Los objetivos de aprendizaje se ven bien, pero me gustaría más énfasis en las reacciones dependientes de la luz.
```

### 2.2 El Flujo de Trabajo de Desarrollo de Contenido

Los seis modos trabajan juntos en un pipeline:

```
1. El Diseñador Curricular define QUÉ enseñar
   ↓
2. El Escritor Instruccional crea CÓMO enseñarlo
   ↓
3. El Desarrollador de Evaluaciones crea CÓMO medir el aprendizaje
   ↓
4. El Productor de Contenido crea materiales MULTIMEDIA
   ↓
5. El Diseñador LX crea experiencias ATRACTIVAS
   ↓
6. El Auditor de Accesibilidad asegura que TODOS puedan acceder
```

Puedes comenzar en cualquier punto del pipeline dependiendo de tu rol.

---

## 3. Usar los Modos Efectivamente

### 3.1 Modo Diseñador Curricular

**Ideal para:** Arquitectos de cursos, coordinadores de currículo, diseñadores instruccionales

**Lo que hace:**
- Valida objetivos de aprendizaje usando la Taxonomía de Bloom
- Mapea objetivos a estándares educativos
- Identifica brechas en la cobertura del currículo
- Valida cadenas de prerrequisitos

**Cómo obtener los mejores resultados:**

1. **Sé específico sobre tu audiencia:**
   ```
   Bueno: "Crear objetivos para estudiantes de química de décimo grado"
   Mejor: "Crear 8 objetivos medibles para química de décimo grado sobre enlace químico, alineados a NGSS HS-PS1-2"
   ```

2. **Proporciona estándares existentes:**
   ```
   "Alinea este currículo a los estándares de Matemáticas Common Core para Álgebra II, específicamente los clústeres A-SSE, A-APR y F-IF"
   ```

3. **Solicita análisis de brechas:**
   ```
   "Analiza este currículo para brechas. ¿Hay alguna expectativa de desempeño NGSS no cubierta?"
   ```

**Consejo profesional:** Comienza con el fin en mente. Dile al Diseñador Curricular qué deberían poder HACER los estudiantes después de completar el curso, y trabajará hacia atrás para diseñar el currículo.

### 3.2 Modo Escritor Instruccional

**Ideal para:** Escritores de contenido, expertos en materia, profesores

**Lo que hace:**
- Analiza legibilidad del contenido (Flesch-Kincaid, SMOG)
- Asegura consistencia de tono en lecciones
- Diseña ejercicios de aprendizaje activo
- Evalúa calidad de explicaciones

**Cómo obtener los mejores resultados:**

1. **Especifica el nivel de lectura de tu audiencia:**
   ```
   "Escribe esta lección para nivel de lectura de octavo grado (Flesch-Kincaid grado 8)"
   ```

2. **Proporciona los objetivos de aprendizaje:**
   ```
   "Escribe una lección que ayude a los estudiantes a lograr este objetivo: 'Los estudiantes podrán explicar el proceso de fotosíntesis'"
   ```

3. **Solicita aprendizaje activo:**
   ```
   "Incluye 3 ejercicios de aprendizaje activo: uno individual, uno en pareja y uno en grupo"
   ```

**Consejo profesional:** Usa la estructura Enganchar-Definir-Ejemplo-Elaborar-Verificar para explicaciones. El Escritor Instruccional seguirá este patrón automáticamente si pides "explicaciones bien estructuradas."

### 3.3 Modo Desarrollador de Evaluaciones

**Ideal para:** Diseñadores de evaluaciones, desarrolladores de pruebas, evaluadores

**Lo que hace:**
- Valida alineación de evaluaciones a objetivos
- Realiza análisis de ítems (dificultad, discriminación)
- Genera rúbricas con descriptores de desempeño
- Detecta sesgo en ítems de evaluación

**Cómo obtener los mejores resultados:**

1. **Proporciona los objetivos de aprendizaje:**
   ```
   "Crea 10 preguntas de opción múltiple que evalúen este objetivo: 'Los estudiantes podrán resolver ecuaciones cuadráticas'"
   ```

2. **Especifica distribución de dificultad:**
   ```
   "Incluye 3 fáciles, 5 medias y 2 difíciles"
   ```

3. **Solicita revisión de sesgo:**
   ```
   "Revisa estos ítems de evaluación para sesgo de género, cultural y socioeconómico"
   ```

**Consejo profesional:** Siempre pide una rúbrica al crear evaluaciones de desempeño. La habilidad rubric-generator crea rúbricas analíticas con descriptores claros de desempeño para cada nivel.

### 3.4 Modo Productor de Contenido

**Ideal para:** Productores de video, diseñadores multimedia, desarrolladores de e-learning

**Lo que hace:**
- Valida storyboards contra objetivos
- Gestiona activos multimedia
- Empaqueta contenido para entrega SCORM/xAPI a LMS
- Crea contenido interactivo H5P

**Cómo obtener los mejores resultados:**

1. **Proporciona el storyboard o guion:**
   ```
   "Crea un storyboard de video explicativo de 5 minutos sobre el ciclo del agua para estudiantes de secundaria"
   ```

2. **Especifica requisitos de accesibilidad:**
   ```
   "Asegura que todo el contenido de video incluya subtítulos y transcripciones"
   ```

3. **Solicita empaquetado SCORM:**
   ```
   "Empaqueta este contenido como un paquete SCORM 2004 para Moodle LMS"
   ```

**Consejo profesional:** Mantén los videos bajo 6 minutos para engagement óptimo. El Productor de Contenido sugerirá automáticamente dividir contenido más largo en micro-videos.

### 3.5 Modo Diseñador de Experiencia de Aprendizaje

**Ideal para:** Diseñadores UX, especialistas en engagement, tecnólogos de aprendizaje

**Lo que hace:**
- Mapea journeys y rutas de aprendizaje
- Analiza patrones de engagement
- Diseña elementos de gamificación
- Arquitecta estructuras de microaprendizaje

**Cómo obtener los mejores resultados:**

1. **Proporciona el paquete de contenido:**
   ```
   "Diseña un journey de aprendiz para este curso de 8 módulos sobre ciencia de datos. Cada módulo toma unos 30 minutos"
   ```

2. **Especifica objetivos de engagement:**
   ```
   "Incluye elementos de gamificación que motiven la completación sin depender de recompensas extrínsecas"
   ```

3. **Solicita estructura de microaprendizaje:**
   ```
   "Divide este módulo de 2 horas en unidades de microaprendizaje de 5-15 minutos cada una"
   ```

**Consejo profesional:** Enfócate en motivación intrínseca. La habilidad gamification-designer prefiere insignias y sistemas de logro que reconocen dominio sobre puntos y tablas de clasificación.

### 3.6 Modo Auditor de Accesibilidad

**Ideal para:** Especialistas en accesibilidad, probadores QA, revisores de contenido

**Lo que hace:**
- Audita cumplimiento WCAG 2.1/2.2 en niveles A, AA, AAA
- Simula experiencia de lector de pantalla
- Analiza ratios de contraste de color
- Proporciona guía de remediación

**Cómo obtener los mejores resultados:**

1. **Proporciona el contenido a auditar:**
   ```
   "Audita esta página de lección para cumplimiento WCAG 2.1 AA"
   ```

2. **Especifica el nivel objetivo:**
   ```
   "Verifica este contenido contra los criterios de éxito WCAG 2.2 AA"
   ```

3. **Solicita guía de remediación:**
   ```
   "Para cada problema encontrado, proporciona pasos específicos de remediación con ejemplos de código"
   ```

**Consejo profesional:** Ejecuta el Auditor de Accesibilidad temprano y a menudo. Es más fácil corregir problemas de accesibilidad durante la creación que después de la publicación.

---

## 4. Optimizar Tu Flujo de Trabajo

### 4.1 Estrategias para Ahorrar Tiempo

| Estrategia | Descripción | Tiempo Ahorrado |
|------------|-------------|-----------------|
| **Agrupar tareas similares** | Agrupa toda la escritura de objetivos, luego toda la escritura de lecciones, luego toda la creación de evaluaciones | 20-30% |
| **Usar transferencias entre modos** | Deja que los modos se pasen trabajo automáticamente | 15-25% |
| **Invocar habilidades directamente** | Invoca habilidades específicas cuando solo necesitas una capacidad | 10-20% |
| **Plantillar tus entradas** | Crea plantillas de entrada reutilizables para tareas comunes | 25-35% |

### 4.2 Plantillas de Entrada

**Plantilla de Diseño Curricular:**
```
Rol: Diseñador Curricular
Tarea: Crear currículo para [materia] en [nivel]
Audiencia: [audiencia objetivo, edad, conocimientos previos]
Estándares: [estándares educativos a los que alinearse]
Duración: [duración del curso, duración de sesión]
Objetivos: [número de objetivos deseados]
Formato de salida: [documento de currículo, lista de objetivos, etc.]
```

**Plantilla de Escritura de Lecciones:**
```
Rol: Escritor Instruccional
Tarea: Escribir lección sobre [tema]
Audiencia: [audiencia objetivo, nivel de lectura]
Objetivos: [objetivos de aprendizaje que aborda esta lección]
Duración: [conteo de palabras estimado o duración]
Actividades: [tipos de actividades a incluir]
Tono: [formal, conversacional, etc.]
```

**Plantilla de Creación de Evaluaciones:**
```
Rol: Desarrollador de Evaluaciones
Tarea: Crear evaluación para [tema/objetivo]
Tipo: [opción múltiple, ensayo, desempeño, etc.]
Ítems: [número de ítems]
Dificultad: [distribución: fácil/medio/difícil]
Rúbrica: [sí/no, tipo de rúbrica]
Revisión de sesgo: [sí/no]
```

### 4.3 Colaboración entre Modos

**Escenario: Crear un Curso Completo**

1. **Comienza con el Diseñador Curricular:**
   ```
   "Diseña un currículo de 6 módulos sobre programación Python para principiantes.
   Alinea a estándares CSTA. Cada módulo debe tener 3-5 objetivos medibles."
   ```

2. **Transfiere al Escritor Instruccional:**
   ```
   "Pasa este currículo al Escritor Instruccional. Escribe contenido de lección
   para el Módulo 1: Variables y Tipos de Datos. Nivel de lectura objetivo: grado 10."
   ```

3. **Transfiere al Desarrollador de Evaluaciones:**
   ```
   "Pasa la lección del Módulo 1 al Desarrollador de Evaluaciones. Crea un cuestionario
   de 15 ítems con 5 fáciles, 7 medios, 3 difíciles. Incluye una rúbrica para
   el ejercicio de codificación."
   ```

4. **Transfiere al Productor de Contenido:**
   ```
   "Pasa la lección y evaluación al Productor de Contenido. Crea un storyboard
   de video explicativo de 5 minutos y 2 actividades interactivas H5P."
   ```

5. **Transfiere al Diseñador LX:**
   ```
   "Pasa el paquete completo del Módulo 1 al Diseñador LX. Diseña el journey
   de aprendiz con un punto de control de progreso y una insignia para completación."
   ```

6. **Transfiere al Auditor de Accesibilidad:**
   ```
   "Pasa todo el contenido del Módulo 1 al Auditor de Accesibilidad. Audita para
   cumplimiento WCAG 2.1 AA y proporciona guía de remediación para cualquier problema."
   ```

### 4.4 Errores Comunes y Cómo Evitarlos

| Error | Impacto | Prevención |
|-------|---------|------------|
| Objetivos vagos | Desalineación de contenido | Usa `learning-objective-validator` antes de proceder |
| Saltar accesibilidad | Aprendices excluidos | Ejecuta `wcag-compliance-checker` en cada etapa |
| Tono inconsistente | Contenido confuso | Usa `tone-consistency-checker` en todas las lecciones |
| Evaluaciones desalineadas | Medición inválida | Usa `assessment-validator` para verificar alineación |
| Videos demasiado largos | Desengagement del aprendiz | Mantén videos bajo 6 minutos; usa `microlearning-architect` |
| Gamificación extrínseca | Motivación a corto plazo | Usa `gamification-designer` con enfoque en motivación intrínseca |

---

## 5. Uso Avanzado

### 5.1 Personalizar Comportamiento de Modos

Cada modo puede personalizarse proporcionando contexto adicional en tus prompts:

```
"Como Diseñador Curricular, prioriza el aprendizaje basado en proyectos sobre instrucción directa.
Diseña objetivos que enfatizen los niveles de creación y evaluación de la Taxonomía de Bloom."
```

```
"Como Escritor Instruccional, usa un enfoque de cuestionamiento socrático. Incluye prompts
de reflexión después de cada concepto principal."
```

### 5.2 Combinar Habilidades

Puedes invocar múltiples habilidades en secuencia para análisis comprehensivo:

```
"Primero, usa readability-analyzer para verificar el nivel de lectura de esta lección.
Luego, usa tone-consistency-checker para asegurar que coincide con nuestra guía de estilo.
Finalmente, usa explanation-quality-checker para evaluar las explicaciones."
```

### 5.3 Refinamiento Iterativo

Los modos soportan refinamiento iterativo. Después de recibir salida, puedes pedir cambios:

```
"Los objetivos están bien, pero hazlos más específicos a las expectativas de desempeño NGSS.
Agrega dos objetivos más en el nivel 'Crear' de la Taxonomía de Bloom."
```

```
"La lección es demasiado técnica. Simplifica el lenguaje a nivel de lectura de grado 8
y agrega más ejemplos concretos."
```

### 5.4 Verificaciones de Calidad

Antes de finalizar cualquier contenido, ejecuta estas verificaciones de calidad:

| Verificación | Habilidad | Cuándo Usar |
|--------------|-----------|-------------|
| Calidad de objetivos | `learning-objective-validator` | Después del diseño curricular |
| Legibilidad | `readability-analyzer` | Después de escribir lección |
| Alineación de evaluación | `assessment-validator` | Después de crear evaluación |
| Revisión de sesgo | `bias-detector` | Antes de publicar evaluaciones |
| Cumplimiento WCAG | `wcag-compliance-checker` | Antes de publicar cualquier contenido |
| Alineación de storyboard | `storyboard-validator` | Antes de producción de video |

---

## 6. Preguntas Frecuentes

### P: ¿Puedo usar múltiples modos en una sesión?
**R:** Sí. Puedes cambiar entre modos según sea necesario. Los modos están diseñados para transferirse trabajo entre sí, así que puedes comenzar en un modo y continuar en otro.

### P: ¿Cómo sé qué modo usar?
**R:** Consulta la tabla de modos en la Sección 1.2. Si no estás seguro, comienza con Diseñador Curricular—es la base para todo el trabajo demás.

### P: ¿Puedo personalizar las habilidades?
**R:** Las habilidades están diseñadas para ser autocontenidas. Si necesitas modificar el comportamiento de una habilidad, consulta la Guía del Equipo de Soporte para instrucciones sobre extender habilidades.

### P: ¿Qué pasa si la salida no satisface mis necesidades?
**R:** Proporciona retroalimentación específica y pide revisiones. Los modos soportan refinamiento iterativo. Por ejemplo: "Los objetivos son demasiado generales. Hazlos más específicos y medibles."

### P: ¿Cómo aseguro consistencia en un proyecto grande?
**R:** Usa la habilidad `tone-consistency-checker` en todo el contenido escrito, y ejecuta `standards-compliance-checker` en el currículo completo. El Auditor de Accesibilidad también puede asegurar consistencia en todo el contenido publicado.

### P: ¿Puedo usar estos modos para contenido no educativo?
**R:** Aunque diseñados para contenido educativo, muchas habilidades (como `readability-analyzer`, `tone-consistency-checker` y `wcag-compliance-checker`) son aplicables a cualquier creación de contenido.

---

## 7. Referencia Rápida

### Guía de Selección de Modos

| Si necesitas... | Usa este modo | Habilidad clave |
|-----------------|---------------|-----------------|
| Definir qué deben aprender los estudiantes | Diseñador Curricular | `learning-objective-validator` |
| Escribir contenido de lección | Escritor Instruccional | `explanation-quality-checker` |
| Crear un cuestionario o prueba | Desarrollador de Evaluaciones | `assessment-validator` |
| Producir un video | Productor de Contenido | `storyboard-validator` |
| Diseñar un camino de aprendizaje | Diseñador LX | `journey-mapper` |
| Verificar accesibilidad | Auditor de Accesibilidad | `wcag-compliance-checker` |
| Verificar nivel de lectura | Escritor Instruccional | `readability-analyzer` |
| Crear una rúbrica | Desarrollador de Evaluaciones | `rubric-generator` |
| Empaquetar para LMS | Productor de Contenido | `scorm-packager` |
| Agregar gamificación | Diseñador LX | `gamification-designer` |

### Referencia Rápida de la Taxonomía de Bloom

| Nivel | Verbos Clave | Ejemplo |
|-------|--------------|---------|
| Recordar | listar, definir, identificar, recordar | "Lista las partes de una célula" |
| Comprender | explicar, describir, resumir | "Explica cómo funciona la fotosíntesis" |
| Aplicar | usar, resolver, demostrar | "Usa la fórmula para resolver el problema" |
| Analizar | comparar, contrastar, diferenciar | "Compara mitosis y meiosis" |
| Evaluar | juzgar, criticar, justificar | "Justifica tu respuesta con evidencia" |
| Crear | diseñar, construir, producir | "Diseña un experimento para probar..." |

### Referencia Rápida de WCAG 2.1

| Principio | Qué significa | Verificación clave |
|-----------|---------------|-------------------|
| Perceptible | Los usuarios pueden percibir contenido | Texto alt, subtítulos, contraste de color |
| Operable | Los usuarios pueden interactuar con contenido | Navegación por teclado, sin límites de tiempo |
| Comprensible | Los usuarios pueden entender contenido | Lenguaje claro, navegación consistente |
| Robusto | El contenido funciona con tecnología asistiva | HTML válido, etiquetas ARIA |

---

## 8. Recursos Adicionales

- **Guía del Equipo de Soporte:** Consulta `docs/support-team-guide.md` para instrucciones de instalación y extensión
- **Plan de Desarrollo:** Consulta `docs/plan.md` para la hoja de ruta del proyecto
- **Especificación de Requisitos:** Consulta `docs/srs.md` para requisitos detallados
- **Configuración de Agentes:** Consulta `AGENTS.md` para directrices de comportamiento de agentes
- **Versiones en Español:** Todos los documentos están disponibles en español con sufijo `-ES` (ej. `docs/plan-ES.md`)

---

## 9. Glosario

| Término | Definición |
|---------|------------|
| **Taxonomía de Bloom** | Un marco para clasificar objetivos de aprendizaje por nivel cognitivo (Recordar, Comprender, Aplicar, Analizar, Evaluar, Crear) |
| **Modo** | Una configuración especializada de Roo Code para un rol específico |
| **Habilidad** | Una capacidad reutilizable que los modos pueden invocar |
| **WCAG** | Pautas de Accesibilidad para el Contenido Web—estándares internacionales para accesibilidad web |
| **SCORM** | Modelo de Referencia de Objeto de Contenido Compartible—un estándar para empaquetar contenido e-learning |
| **xAPI** | API de Experiencia (Tin Can API)—una especificación para rastrear experiencias de aprendizaje |
| **NGSS** | Next Generation Science Standards—estándares de educación científica en EE.UU. |
| **CSTA** | Computer Science Teachers Association—estándares de educación en computación |
| **H5P** | HTML5 Package—un estándar para crear contenido web interactivo |
| **Microaprendizaje** | Dividir contenido en unidades pequeñas (5-15 minutos) para mejor retención |