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

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

5.2 Aceptación de Habilidades

• Las 30 habilidades están documentadas
• Las habilidades devuelven resultados estructurados
• Las habilidades manejan errores elegantemente
• 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