pinion-innovation-content/docs/srs-ES.md

# Especificación de Requisitos de Software (SRS)

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

**Versión:** 1.1.1
**Fecha:** 2026-04-24
**Estado:** Final

---

## 1. Introducción

### 1.1 Propósito

Este documento especifica los requisitos de software para el proyecto Contenido de Innovación—un conjunto de modos y habilidades especializados para Roo Code que permiten a desarrolladores y productores de contenido educativo crear materiales educativos de alta calidad y accesibles.

### 1.2 Alcance

El proyecto proporciona:
- 6 modos especializados para diferentes roles de contenido educativo
- 30 habilidades que apoyan esos modos (5 por modo)
- 42 archivos de instrucción XML que definen patrones de comportamiento (7 por modo)
- Archivos de configuración para registro de modos
- Documentación completa

### 1.3 Definiciones y Acrónimos

| Término | Definición |
|---------|------------|
| Modo | Una configuración especializada de Roo Code para un rol específico |
| Habilidad | Una capacidad reutilizable que puede ser invocada por modos |
| LMS | Sistema de Gestión de Aprendizaje (Learning Management System) |
| SCORM | Modelo de Referencia de Objeto de Contenido Compartible |
| xAPI | API de Experiencia (Tin Can API) |
| WCAG | Pautas de Accesibilidad para el Contenido Web |
| Taxonomía de Bloom | Clasificación de objetivos de aprendizaje por nivel cognitivo |

### 1.4 Referencias

- Documentación de Roo Code Mode Writer
- Pautas WCAG 2.1/2.2
- Especificación SCORM 2004
- Marco de la Taxonomía de Bloom

---

## 2. Descripción General

### 2.1 Perspectiva del Producto

El proyecto Contenido de Innovación extiende las capacidades de Roo Code proporcionando modos y habilidades específicos del dominio adaptados al desarrollo de contenido educativo. Cada modo opera como un agente especializado con permisos, comportamientos y flujos de trabajo definidos.

### 2.2 Funciones del Producto

1. **Diseño Curricular:** Crear y validar currículos educativos
2. **Escritura Instruccional:** Producir contenido de lecciones atractivo
3. **Desarrollo de Evaluaciones:** Diseñar evaluaciones válidas y confiables
4. **Producción de Contenido:** Crear materiales educativos multimedia
5. **Diseño de Experiencia de Aprendizaje:** Diseñar journeys de aprendizaje atractentes
6. **Auditoría de Accesibilidad:** Asegurar que el contenido cumpla con estándares de accesibilidad

### 2.3 Características del Usuario

| Rol del Usuario | Experiencia | Modos Principales |
|-----------------|-------------|-------------------|
| Diseñador Curricular | Diseño educativo, alineación de estándares | curriculum-designer |
| Escritor Instruccional | Escritura, pedagogía | instructional-writer |
| Desarrollador de Evaluaciones | Psicometría, medición | assessment-dev |
| Productor de Contenido | Producción multimedia | content-producer |
| Diseñador LX | Diseño UX, engagement | lx-designer |
| Especialista en Accesibilidad | WCAG, tecnología asistiva | accessibility-auditor |

### 2.4 Restricciones

- Los modos deben operar dentro de los permisos de archivo definidos
- Las habilidades deben ser autocontenidas y documentadas
- Todo el contenido debe cumplir con los estándares educativos
- La accesibilidad es obligatoria, no opcional

### 2.5 Suposiciones

- Los usuarios tienen familiaridad básica con Roo Code
- El contenido educativo sigue los estándares organizacionales
- Las plataformas objetivo admiten contenido SCORM/xAPI
- Los requisitos de accesibilidad son conocidos y documentados

---

## 3. Requisitos Específicos

### 3.1 Requisitos de Modos

#### 3.1.1 Modo Diseñador Curricular

**ID:** MODE-001
**Prioridad:** Crítica

**Requisitos Funcionales:**
- FR-001: Debe validar objetivos de aprendizaje contra la Taxonomía de Bloom
- FR-002: Debe mapear objetivos a marcos de competencia
- FR-003: Debe identificar brechas en la cobertura del currículo
- FR-004: Debe verificar la alineación con estándares educativos
- FR-005: Debe analizar y validar cadenas de prerrequisitos

**Requisitos No Funcionales:**
- NFR-001: Debe procesar documentos curriculares en menos de 30 segundos
- NFR-002: Debe soportar Common Core, NGSS y estándares personalizados

**Permisos:**
- Lectura: Repositorio completo
- Edición: `curriculum/`, `docs/learning-objectives/`, `*.curriculum.md`

---

#### 3.1.2 Modo Escritor Instruccional

**ID:** MODE-002
**Prioridad:** Crítica

**Requisitos Funcionales:**
- FR-006: Debe analizar la legibilidad del contenido
- FR-007: Debe asegurar la consistencia del tono en documentos
- FR-008: Debe diseñar ejercicios de aprendizaje activo
- FR-009: Debe evaluar la calidad de las explicaciones
- FR-010: Debe generar preguntas de evaluación formativa

**Requisitos No Funcionales:**
- NFR-003: Debe soportar múltiples métricas de legibilidad (Flesch-Kincaid, SMOG)
- NFR-004: Debe mantener el cumplimiento de la guía de estilo

**Permisos:**
- Lectura: Repositorio completo
- Edición: `lessons/`, `exercises/`, `docs/learner/`, `*.lesson.md`

---

#### 3.1.3 Modo Desarrollador de Evaluaciones

**ID:** MODE-003
**Prioridad:** Alta

**Requisitos Funcionales:**
- FR-011: Debe validar la alineación de evaluaciones a objetivos
- FR-012: Debe realizar análisis de ítems (dificultad, discriminación)
- FR-013: Debe generar rúbricas con descriptores de desempeño
- FR-014: Debe detectar sesgo en ítems de evaluación
- FR-015: Debe diseñar lógica de evaluación adaptativa

**Requisitos No Funcionales:**
- NFR-005: Debe soportar múltiples tipos de evaluación (opción múltiple, ensayo, desempeño)
- NFR-006: Debe calcular índices estadísticos con precisión

**Permisos:**
- Lectura: Repositorio completo
- Edición: `assessments/`, `quizzes/`, `rubrics/`, `*.assessment.md`

---

#### 3.1.4 Modo Productor de Contenido

**ID:** MODE-004
**Prioridad:** Alta

**Requisitos Funcionales:**
- FR-016: Debe validar storyboards contra objetivos
- FR-017: Debe gestionar activos de medios con metadatos
- FR-018: Debe empaquetar contenido para SCORM/xAPI
- FR-019: Debe validar la calidad de subtítulos y transcripciones
- FR-020: Debe crear contenido interactivo (H5P)

**Requisitos No Funcionales:**
- NFR-007: Debe producir paquetes compatibles con SCORM 1.2 y 2004
- NFR-008: Debe soportar formatos de medios comunes (MP4, WebM, PNG, SVG)

**Permisos:**
- Lectura: Repositorio completo
- Edición: `content/`, `media/`, `scripts/`, `*.storyboard.md`
- Navegador: Vista previa y prueba

---

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

**ID:** MODE-005
**Prioridad:** Media

**Requisitos Funcionales:**
- FR-021: Debe mapear journeys de aprendizaje
- FR-022: Debe analizar patrones de engagement
- FR-023: Debe diseñar elementos de gamificación
- FR-024: Debe arquitecturar estructuras de microaprendizaje
- FR-025: Debe generar especificaciones de UI

**Requisitos No Funcionales:**
- NFR-009: Debe soportar visualización de journeys
- NFR-010: Debe alinear la gamificación a objetivos de aprendizaje

**Permisos:**
- Lectura: Repositorio completo
- Edición: `design/`, `ux/`, `*.journey.md`, `*.spec.md`
- Navegador: Prototipo y prueba

---

#### 3.1.6 Modo Auditor de Accesibilidad

**ID:** MODE-006
**Prioridad:** Alta

**Requisitos Funcionales:**
- FR-026: Debe auditar el cumplimiento de WCAG 2.1/2.2
- FR-027: Debe simular la experiencia de lector de pantalla
- FR-028: Debe analizar ratios de contraste de color
- FR-029: Debe evaluar accesibilidad cognitiva
- FR-030: Debe proporcionar guía de remediación

**Requisitos No Funcionales:**
- NFR-011: Debe verificar todos los criterios de éxito WCAG en niveles A, AA, AAA
- NFR-012: Debe priorizar problemas por severidad

**Permisos:**
- Lectura: Repositorio completo
- Edición: `docs/accessibility/`, `*.audit.md`, `a11y-reports/`
- Navegador: Simulación de lector de pantalla

---

### 3.2 Requisitos de Habilidades

#### 3.2.1 Arquitectura de Habilidades

Cada habilidad debe:
- Tener un identificador único (slug)
- Incluir un archivo SKILL.md con descripción y capacidades
- Ser invocable por uno o más modos
- Devolver resultados estructurados
- Documentar limitaciones y suposiciones

#### 3.2.2 Inventario de Habilidades

| ID de Habilidad | Nombre | Modo Principal | Prioridad |
|-----------------|--------|----------------|-----------|
| SKILL-001 | learning-objective-validator | curriculum-designer | Crítica |
| SKILL-002 | competency-mapper | curriculum-designer | Alta |
| SKILL-003 | curriculum-gap-analyzer | curriculum-designer | Alta |
| SKILL-004 | standards-compliance-checker | curriculum-designer | Media |
| SKILL-005 | prerequisite-analyzer | curriculum-designer | Media |
| SKILL-006 | readability-analyzer | instructional-writer | Crítica |
| SKILL-007 | tone-consistency-checker | instructional-writer | Alta |
| SKILL-008 | active-learning-designer | instructional-writer | Alta |
| SKILL-009 | explanation-quality-checker | instructional-writer | Media |
| SKILL-010 | formative-assessment-writer | instructional-writer | Media |
| SKILL-011 | assessment-validator | assessment-dev | Crítica |
| SKILL-012 | item-analysis-tool | assessment-dev | Alta |
| SKILL-013 | rubric-generator | assessment-dev | Alta |
| SKILL-014 | bias-detector | assessment-dev | Media |
| SKILL-015 | adaptive-logic-designer | assessment-dev | Media |
| SKILL-016 | storyboard-validator | content-producer | Crítica |
| SKILL-017 | media-asset-manager | content-producer | Alta |
| SKILL-018 | scorm-packager | content-producer | Alta |
| SKILL-019 | caption-quality-checker | content-producer | Media |
| SKILL-020 | interactive-content-builder | content-producer | Media |
| SKILL-021 | journey-mapper | lx-designer | Crítica |
| SKILL-022 | engagement-analyzer | lx-designer | Alta |
| SKILL-023 | gamification-designer | lx-designer | Alta |
| SKILL-024 | microlearning-architect | lx-designer | Media |
| SKILL-025 | ui-spec-generator | lx-designer | Media |
| SKILL-026 | wcag-compliance-checker | accessibility-auditor | Crítica |
| SKILL-027 | screen-reader-simulator | accessibility-auditor | Alta |
| SKILL-028 | color-contrast-analyzer | accessibility-auditor | Alta |
| SKILL-029 | cognitive-accessibility-checker | accessibility-auditor | Media |
| SKILL-030 | remediation-advisor | accessibility-auditor | Media |

---

### 3.3 Requisitos de Interfaz

#### 3.3.1 Interfaz de Configuración de Modos

Cada configuración de modo debe incluir:
- `name`: Nombre para mostrar
- `slug`: Identificador único
- `roleDefinition`: Descripción detallada del rol
- `whenToUse`: Guía de uso
- `permissions`: Restricciones de archivos y comandos
- `customInstructions`: Reglas de comportamiento específicas del modo

#### 3.3.2 Interfaz de Habilidades

Cada habilidad debe incluir:
- `name`: Nombre para mostrar
- `description`: Descripción de capacidad
- `capabilities`: Lista de capacidades específicas
- `usage`: Cuándo y cómo usar la habilidad

---

### 3.4 Requisitos de Integración

#### 3.4.1 Transferencias entre Modos

| De Modo | A Modo | Contenido de Transferencia |
|---------|--------|---------------------------|
| curriculum-designer | instructional-writer | Objetivos de aprendizaje, estructura del curso |
| instructional-writer | content-producer | Guiones, esquemas de contenido |
| lx-designer | content-producer | Especificaciones de elementos interactivos |
| assessment-dev | todos los modos | Requisitos de evaluación |
| todos los modos | accessibility-auditor | Contenido listo para revisión |

#### 3.4.2 Compartición de Habilidades

Las habilidades pueden compartirse entre modos donde las capacidades se superponen:
- `readability-analyzer` puede ser usado por content-producer
- `assessment-validator` puede ser usado por instructional-writer
- `wcag-compliance-checker` puede ser usado por content-producer

---

## 4. Requisitos No Funcionales

### 4.1 Rendimiento

- NFR-013: El cambio de modo debe completarse en menos de 5 segundos
- NFR-014: La invocación de habilidades debe completarse en menos de 30 segundos
- NFR-015: Las operaciones de archivo deben respetar los límites de permisos

### 4.2 Confiabilidad

- NFR-016: Los modos no deben fallar con entrada inválida
- NFR-017: Las habilidades deben devolver mensajes de error estructurados
- NFR-018: Los errores de configuración deben reportarse claramente

### 4.3 Seguridad

- NFR-019: Los permisos de archivo deben ser aplicados
- NFR-020: Los modos no deben acceder a archivos fuera de su alcance
- NFR-021: Las habilidades no deben ejecutar comandos arbitrarios

### 4.4 Mantenibilidad

- NFR-022: Todas las configuraciones deben estar bajo control de versiones
- NFR-023: Todas las habilidades deben estar documentadas
- NFR-024: Los cambios deben rastrearse en CHANGELOG.md

---

## 5. Criterios de Aceptación

### 5.1 Aceptación de Modos

- [x] Los 6 modos están configurados correctamente
- [x] Todos los archivos de instrucción XML están bien formados
- [x] Los permisos de archivo se aplican
- [ ] Las transferencias entre modos funcionan como se especifica
- [x] La documentación está completa y es precisa

### 5.2 Aceptación de Habilidades

- [x] Las 30 habilidades están documentadas
- [x] Las habilidades devuelven resultados estructurados
- [x] Las habilidades manejan errores elegantemente
- [x] Las habilidades se integran con modos padre
- [ ] Las habilidades compartidas funcionan entre modos

### 5.3 Aceptación de Integración

- [ ] Los flujos de trabajo de extremo a extremo se completan exitosamente
- [ ] No ocurren conflictos de permisos
- [ ] Todos los escenarios de prueba pasan
- [ ] Se cumplen los requisitos de rendimiento
- [ ] Se cumplen los requisitos de seguridad

---

## 6. Apéndices

### 6.1 Referencia de la Taxonomía de Bloom

| Nivel | Verbos | Descripción |
|-------|--------|-------------|
| Recordar | listar, definir, identificar, recordar | Recordar hechos y conceptos básicos |
| Comprender | explicar, describir, resumir, interpretar | Explicar ideas o conceptos |
| Aplicar | usar, resolver, demostrar, implementar | Usar información en nuevas situaciones |
| Analizar | comparar, contrastar, diferenciar, examinar | Establecer conexiones entre ideas |
| Evaluar | juzgar, criticar, justificar, defender | Justificar una posición o decisión |
| Crear | diseñar, construir, producir, desarrollar | Producir trabajo nuevo u original |

### 6.2 Principios WCAG 2.1

1. **Perceptible:** La información debe presentarse de formas que los usuarios puedan percibir
2. **Operable:** Los componentes de la interfaz deben ser operables por todos los usuarios
3. **Comprensible:** La información y operación de la UI deben ser comprensibles
4. **Robusto:** El contenido debe ser lo suficientemente robusto para varias tecnologías asistivas

### 6.3 Versiones SCORM

| Versión | Año | Características Clave |
|---------|-----|----------------------|
| SCORM 1.2 | 2001 | Secuenciación básica, modelo de datos simple |
| SCORM 2004 | 2004 | Secuenciación avanzada, estado compartido |

### 6.4 Estado de Implementación

**Al 2026-04-24:**

| Componente | Requerido | Implementado | Estado |
|------------|-----------|--------------|--------|
| Modos | 6 | 6 | ✅ Completo |
| Archivos de Configuración de Modos | 6 | 6 | ✅ Completo |
| Archivos de Reglas XML | 42 | 42 | ✅ Completo |
| Habilidades | 30 | 30 | ✅ Completo |
| Archivos SKILL.md | 30 | 30 | ✅ Completo |
| Documentación | 8 | 8 | ✅ Completo |

**Total de Archivos Creados: 125**

### 6.5 Inventario de Archivos

#### Documentación Raíz
- `README.md` - Resumen del proyecto y guía de inicio rápido
- `CHANGELOG.md` - Historial de versiones con registro detallado de cambios
- `AGENTS.md` - Configuración de agentes y directrices de comportamiento

#### Documentación (docs/)
- `plan.md` - Plan de desarrollo con 4 fases e hitos
- `srs.md` - Especificación de Requisitos de Software
- `support-team-guide.md` - Guía de instalación, solución de problemas y extensión para equipos de soporte
- `user-guide.md` - Guía del usuario con introducción conceptual, consejos de uso de modos y optimización de flujo de trabajo
- `plan-ES.md` - Versión en español del plan de desarrollo
- `srs-ES.md` - Versión en español de la especificación de requisitos
- `support-team-guide-ES.md` - Versión en español de la guía del equipo de soporte
- `user-guide-ES.md` - Versión en español de la guía del usuario

#### Modos (modes/)
Cada modo contiene:
- `mode-config.yaml` - Configuración del modo con permisos
- `rules/1_workflow.xml` - Definición del flujo de trabajo principal
- `rules/2_best_practices.xml` - Mejores prácticas y directrices
- `rules/3_common_patterns.xml` - Patrones de diseño comunes
- `rules/4_decision_guidance.xml` - Directrices para la toma de decisiones
- `rules/5_examples.xml` - Ejemplos resueltos
- `rules/6_error_handling.xml` - Procedimientos de manejo de errores
- `rules/7_communication.xml` - Protocolos de comunicación y transferencia

#### Habilidades (skills/)
Cada habilidad contiene:
- `SKILL.md` - Documentación de habilidad con frontmatter YAML que incluye:
  - `name` - Identificador de habilidad
  - `description` - Descripción de capacidad
  - Sección de capacidades
  - Directrices de uso
  - Especificaciones de entrada/salida
  - Limitaciones y suposiciones