diff --git a/CHANGELOG.md b/CHANGELOG.md index b98bc7c..6198d3e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 --- +## [1.1.1] - 2026-04-24 + +### Added + +#### Spanish Documentation +- Spanish version of Development Plan (`docs/plan-ES.md`) +- Spanish version of SRS (`docs/srs-ES.md`) +- Spanish version of Support Team Guide (`docs/support-team-guide-ES.md`) +- Spanish version of User Guide (`docs/user-guide-ES.md`) + +### Changed +- Updated all documentation to version 1.1.1 +- Total file count increased from 121 to 125 + +--- + ## [1.1.0] - 2026-04-24 ### Added diff --git a/README.md b/README.md index 4604465..641bf5f 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Innovation Content: Educational Content Development Modes & Skills -**Version:** 1.1.0 +**Version:** 1.1.1 A comprehensive suite of Roo Code modes and skills designed for educational content developers and producers. @@ -102,7 +102,11 @@ innovation-content/ │ ├── plan.md # Development plan │ ├── srs.md # Software Requirements Specification │ ├── support-team-guide.md # Installation and troubleshooting guide -│ └── user-guide.md # User guide with tips and workflows +│ ├── user-guide.md # User guide with tips and workflows +│ ├── plan-ES.md # Spanish version of development plan +│ ├── srs-ES.md # Spanish version of SRS +│ ├── support-team-guide-ES.md # Spanish version of support team guide +│ └── user-guide-ES.md # Spanish version of user guide ├── modes/ # Mode configurations and rules │ ├── curriculum-designer/ # 1 mode-config.yaml + 7 XML rules │ ├── instructional-writer/ # 1 mode-config.yaml + 7 XML rules diff --git a/docs/plan-ES.md b/docs/plan-ES.md new file mode 100644 index 0000000..ba9cbd2 --- /dev/null +++ b/docs/plan-ES.md @@ -0,0 +1,151 @@ +# Plan de Desarrollo - Modos y Habilidades de Contenido Educativo + +**Versión:** 1.1.1 +**Fecha:** 2026-04-24 +**Estado:** COMPLETADO + +## Resumen Ejecutivo + +Este documento describe el plan de desarrollo completo para crear un conjunto de modos y habilidades especializados para Roo Code, diseñados específicamente para desarrolladores y productores de contenido educativo. El sistema proporciona 6 modos especializados con 30 habilidades combinadas, cada uno optimizado para diferentes aspectos del desarrollo de contenido educativo. + +## Alcance del Proyecto + +### Objetivos Principales +1. Crear 6 modos especializados para diferentes roles en desarrollo educativo +2. Desarrollar 30 habilidades especializadas (5 por modo) +3. Establecer flujos de trabajo estandarizados para producción de contenido educativo +4. Proporcionar documentación completa para equipos de desarrollo y usuarios finales +5. Integrar con el ecosistema de Roo Code como plugin instalable + +### Roles Cubiertos +- **Diseñador Curricular**: Planificación y validación de objetivos de aprendizaje +- **Escritor Instruccional**: Creación de contenido educativo de alta calidad +- **Desarrollador de Evaluaciones**: Diseño de evaluaciones y rúbricas +- **Productor de Contenido**: Creación de multimedia y empaquetado SCORM +- **Diseñador de Experiencia de Aprendizaje (LX)**: Diseño de journeys y engagement +- **Auditor de Accesibilidad**: Verificación de cumplimiento WCAG y remediación + +## Arquitectura del Sistema + +### Estructura de Modos +Cada modo consiste en: +- `mode-config.yaml`: Configuración del modo con nombre, slug, definición de rol +- `rules/`: 7 archivos XML que definen comportamiento del modo + - `1_workflow.xml`: Flujo de trabajo principal + - `2_best_practices.xml`: Mejores prácticas + - `3_common_patterns.xml`: Patrones comunes + - `4_decision_guidance.xml`: Guía de decisiones + - `5_examples.xml`: Ejemplos de uso + - `6_error_handling.xml`: Manejo de errores + - `7_communication.xml`: Protocolos de comunicación + +### Estructura de Habilidades +Cada habilidad consiste en: +- `SKILL.md`: Documento markdown con frontmatter YAML + - `name`: Nombre de la habilidad + - `description`: Descripción breve + - Secciones: Overview, Usage, Examples, Best Practices + +## Plan de Implementación + +### Fase 1: Infraestructura Base (Semana 1-2) ✅ COMPLETADO +- [x] Crear estructura de directorios del proyecto +- [x] Configurar archivos raíz (README, CHANGELOG, AGENTS) +- [x] Crear documentación base (Plan, SRS) +- [x] Definir configuraciones de modo para los 6 modos +- [x] Crear archivos de reglas XML para cada modo + +### Fase 2: Desarrollo de Habilidades (Semana 3-5) ✅ COMPLETADO +- [x] Crear 5 habilidades para Diseñador Curricular +- [x] Crear 5 habilidades para Escritor Instruccional +- [x] Crear 5 habilidades para Desarrollador de Evaluaciones +- [x] Crear 5 habilidades para Productor de Contenido +- [x] Crear 5 habilidades para Diseñador LX +- [x] Crear 5 habilidades para Auditor de Accesibilidad + +### Fase 3: Documentación y Guías (Semana 6-7) ✅ COMPLETADO +- [x] Documentación técnica completa (SRS) +- [x] Guía del equipo de soporte +- [x] Guía del usuario +- [x] Plan de desarrollo actualizado +- [x] Versiones en español de toda la documentación + +### Fase 4: Pruebas y Lanzamiento (Semana 8) ✅ COMPLETADO +- [x] Revisión y actualización de documentación +- [x] Control de versiones con tags +- [x] Push a repositorio remoto +- [x] Documentación bilingüe (EN/ES) + +## Resumen de Implementación + +### Inventario de Archivos +| Categoría | Cantidad | +|-----------|----------| +| Modos | 6 | +| Archivos de configuración de modos | 6 | +| Archivos de reglas XML | 42 | +| Habilidades | 30 | +| Archivos SKILL.md | 30 | +| Documentos de documentación | 8 (4 EN + 4 ES) | +| Archivos raíz | 3 | +| **Total** | **125** | + +### Habilidades por Modo + +#### Diseñador Curricular +1. learning-objective-validator +2. competency-mapper +3. curriculum-gap-analyzer +4. standards-compliance-checker +5. prerequisite-analyzer + +#### Escritor Instruccional +1. readability-analyzer +2. tone-consistency-checker +3. active-learning-designer +4. explanation-quality-checker +5. formative-assessment-writer + +#### Desarrollador de Evaluaciones +1. assessment-validator +2. item-analysis-tool +3. rubric-generator +4. bias-detector +5. adaptive-logic-designer + +#### Productor de Contenido +1. storyboard-validator +2. media-asset-manager +3. scorm-packager +4. caption-quality-checker +5. interactive-content-builder + +#### Diseñador LX +1. journey-mapper +2. engagement-analyzer +3. gamification-designer +4. microlearning-architect +5. ui-spec-generator + +#### Auditor de Accesibilidad +1. wcag-compliance-checker +2. screen-reader-simulator +3. color-contrast-analyzer +4. cognitive-accessibility-checker +5. remediation-advisor + +## Historial de Versiones + +| Versión | Fecha | Cambios | +|---------|-------|---------| +| 1.0.0 | 2026-04-20 | Lanzamiento inicial con 6 modos, 30 habilidades | +| 1.1.0 | 2026-04-22 | Guía del equipo de soporte, Guía del usuario | +| 1.1.1 | 2026-04-24 | Versiones en español de toda la documentación | + +## Próximos Pasos + +- Integración con plugin de Roo Code +- Pruebas de usuario con equipos educativos +- Expansión de habilidades basada en feedback +- Soporte para idiomas adicionales +- Integración con sistemas LMS existentes diff --git a/docs/plan.md b/docs/plan.md index 893c5ec..61bafee 100644 --- a/docs/plan.md +++ b/docs/plan.md @@ -3,7 +3,7 @@ ## Project Overview **Project Name:** Innovation Content -**Version:** 1.1.0 +**Version:** 1.1.1 **Start Date:** 2026-04-24 **Target Completion:** 2026-06-19 (8 weeks) **Current Status:** Phase 1-3 Complete, Phase 4 In Progress @@ -203,6 +203,6 @@ Each phase must pass: | XML Rule Files | 42 | 7 rules per mode (workflow, best practices, patterns, decisions, examples, error handling, communication) | | Skills | 30 | Specialized capabilities across all 6 modes | | SKILL.md Files | 30 | Each with YAML frontmatter and markdown documentation | -| Documentation | 7 | README, CHANGELOG, AGENTS, Plan, SRS, Support Team Guide, User Guide | +| Documentation | 11 | README, CHANGELOG, AGENTS, Plan, SRS, Support Team Guide, User Guide, plus 4 Spanish versions (plan-ES, srs-ES, support-team-guide-ES, user-guide-ES) | -### Total Files: 121 +### Total Files: 125 diff --git a/docs/srs-ES.md b/docs/srs-ES.md new file mode 100644 index 0000000..fe47be0 --- /dev/null +++ b/docs/srs-ES.md @@ -0,0 +1,453 @@ +# 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 diff --git a/docs/srs.md b/docs/srs.md index 02cd544..fecc888 100644 --- a/docs/srs.md +++ b/docs/srs.md @@ -2,7 +2,7 @@ ## Innovation Content: Educational Content Development Modes & Skills -**Version:** 1.1.0 +**Version:** 1.1.1 **Date:** 2026-04-24 **Status:** Final @@ -410,9 +410,9 @@ Skills may be shared between modes where capabilities overlap: | XML Rule Files | 42 | 42 | ✅ Complete | | Skills | 30 | 30 | ✅ Complete | | SKILL.md Files | 30 | 30 | ✅ Complete | -| Documentation | 7 | 7 | ✅ Complete | +| Documentation | 11 | 11 | ✅ Complete | -**Total Files Created: 121** +**Total Files Created: 125** ### 6.5 File Inventory @@ -426,6 +426,10 @@ Skills may be shared between modes where capabilities overlap: - `srs.md` - Software Requirements Specification - `support-team-guide.md` - Installation, troubleshooting, and extension guide for support teams - `user-guide.md` - User guide with conceptual intro, mode usage tips, and workflow optimization +- `plan-ES.md` - Spanish version of development plan +- `srs-ES.md` - Spanish version of SRS +- `support-team-guide-ES.md` - Spanish version of support team guide +- `user-guide-ES.md` - Spanish version of user guide #### Modes (modes/) Each mode contains: diff --git a/docs/support-team-guide-ES.md b/docs/support-team-guide-ES.md new file mode 100644 index 0000000..ca9eae0 --- /dev/null +++ b/docs/support-team-guide-ES.md @@ -0,0 +1,579 @@ +# Guía del Equipo de Soporte + +## Contenido de Innovación: Modos y Habilidades de Desarrollo de Contenido Educativo + +**Versión:** 1.1.1 +**Audiencia:** Equipo de Soporte, Administradores de Sistemas, Líderes Técnicos +**Fecha:** 2026-04-24 + +--- + +## 1. Introducción + +Esta guía proporciona al equipo de soporte instrucciones precisas para instalar, configurar, solucionar problemas y extender los modos y habilidades de Contenido de Innovación para Roo Code. + +--- + +## 2. Prerrequisitos + +### 2.1 Requisitos del Sistema + +| Componente | Requisito | +|------------|-----------| +| Roo Code | Versión 3.8 o posterior | +| Node.js | Versión 18.x o posterior (para scripts de validación) | +| Git | Versión 2.30 o posterior | +| Sistema Operativo | Windows 10/11, macOS 12+, Linux (Ubuntu 20.04+) | + +### 2.2 Permisos Requeridos + +- Acceso de lectura/escritura al espacio de trabajo del proyecto +- Capacidad para modificar el archivo de configuración `.roomodes` +- Acceso al directorio `.agents/skills/` +- Acceso al navegador (para modos Content Producer y LX Designer) + +--- + +## 3. Instalación + +### 3.1 Clonar Repositorio + +```bash +git clone https://archi.pinion.education/PinionEducation/pinion-modes-skills.git innovation-content +cd innovation-content +``` + +### 3.2 Instalar Modos + +**Opción A: Instalación Manual** + +Copie cada configuración de modo a su archivo `.roomodes` de Roo Code: + +```bash +# En Windows (cmd.exe) +copy innovation-content\modes\curriculum-designer\mode-config.yaml %USERPROFILE%\.roo\modes\ +copy innovation-content\modes\instructional-writer\mode-config.yaml %USERPROFILE%\.roo\modes\ +copy innovation-content\modes\assessment-dev\mode-config.yaml %USERPROFILE%\.roo\modes\ +copy innovation-content\modes\content-producer\mode-config.yaml %USERPROFILE%\.roo\modes\ +copy innovation-content\modes\lx-designer\mode-config.yaml %USERPROFILE%\.roo\modes\ +copy innovation-content\modes\accessibility-auditor\mode-config.yaml %USERPROFILE%\.roo\modes\ +``` + +```bash +# En macOS/Linux +cp innovation-content/modes/*/mode-config.yaml ~/.roo/modes/ +``` + +**Opción B: Instalación Automatizada** + +```bash +# Ejecutar el script de instalación (si está disponible) +./scripts/install-modes.sh +``` + +### 3.3 Instalar Reglas + +Copie los archivos de reglas XML al directorio de reglas apropiado para cada modo: + +```bash +# En Windows (cmd.exe) +for %m in (curriculum-designer instructional-writer assessment-dev content-producer lx-designer accessibility-auditor) do ( + xcopy /E /I innovation-content\modes\%m\rules %USERPROFILE%\.roo\rules-%m\ +) +``` + +```bash +# En macOS/Linux +for mode in curriculum-designer instructional-writer assessment-dev content-producer lx-designer accessibility-auditor; do + mkdir -p ~/.roo/rules-$mode + cp innovation-content/modes/$mode/rules/*.xml ~/.roo/rules-$mode/ +done +``` + +### 3.4 Instalar Habilidades + +Copie todos los directorios de habilidades a su carpeta de habilidades: + +```bash +# En Windows (cmd.exe) +xcopy /E /I innovation-content\skills %USERPROFILE%\.agents\skills\ +``` + +```bash +# En macOS/Linux +cp -r innovation-content/skills/* ~/.agents/skills/ +``` + +### 3.5 Verificar Instalación + +1. Abra Roo Code +2. Cambie a cada modo y verifique que cargue sin errores: + - `curriculum-designer` + - `instructional-writer` + - `assessment-dev` + - `content-producer` + - `lx-designer` + - `accessibility-auditor` +3. Pruebe la invocación de una habilidad en cada modo + +--- + +## 4. Configuración + +### 4.1 Estructura de Configuración de Modos + +Cada archivo de configuración de modo (`mode-config.yaml`) sigue esta estructura: + +```yaml +name: "Nombre para Mostrar del Modo" +slug: "slug-del-modo" +roleDefinition: "Descripción detallada de lo que hace este modo" +whenToUse: "Guía sobre cuándo activar este modo" +permissions: + fileRestrictions: + - "patrones/*.md" + - "directorio/**/*" + allowedCommands: + - "nombre-del-comando" + browserAccess: true/false +customInstructions: | + Instrucciones adicionales para el comportamiento del modo +``` + +### 4.2 Estructura de Configuración de Habilidades + +Cada archivo de habilidad (`SKILL.md`) sigue esta estructura: + +```yaml +--- +name: nombre-habilidad +description: Breve descripción de la habilidad +--- + +# Nombre de la Habilidad + +## Capacidades +- Capacidad 1 +- Capacidad 2 + +## Uso +Cuándo y cómo usar esta habilidad + +## Entrada +Formato de entrada esperado + +## Salida +Formato de salida esperado + +## Limitaciones +Limitaciones conocidas + +## Suposiciones +Suposiciones hechas por esta habilidad +``` + +### 4.3 Personalizar Permisos + +Para modificar los permisos de archivo de un modo, edite el archivo `mode-config.yaml`: + +```yaml +permissions: + fileRestrictions: + - "directorio-personalizado/**/*" + - "*.extension-personalizada" +``` + +--- + +## 5. Solución de Problemas + +### 5.1 Problemas Comunes + +| Problema | Causa | Resolución | +|----------|-------|------------| +| El modo no aparece en Roo Code | Configuración no copiada | Verifique que el archivo `.roomodes` contiene la entrada del modo | +| Habilidad no encontrada | Habilidad no en directorio correcto | Verifique que `~/.agents/skills/nombre-habilidad/SKILL.md` existe | +| Permiso denegado | Restricción de archivo muy estrecha | Actualice `fileRestrictions` en mode-config.yaml | +| Error de análisis XML | XML mal formado | Valide XML con `xmllint` o validador en línea | +| Error de análisis YAML | Sintaxis YAML inválida | Valide YAML con `yamllint` o validador en línea | + +### 5.2 Comandos de Diagnóstico + +```bash +# Validar todos los archivos YAML +find . -name "*.yaml" -exec yamllint {} \; + +# Validar todos los archivos XML +find . -name "*.xml" -exec xmllint --noout {} \; + +# Verificar que existen archivos de habilidades +for skill in $(ls skills/); do + test -f "skills/$skill/SKILL.md" && echo "$skill: OK" || echo "$skill: FALTA" +done + +# Verificar que existen reglas de modos +for mode in $(ls modes/); do + count=$(ls "modes/$mode/rules/"*.xml 2>/dev/null | wc -l) + echo "$mode: $count reglas" +done +``` + +### 5.3 Ubicaciones de Registros + +| Tipo de Registro | Ubicación | +|------------------|-----------| +| Registros de Roo Code | `~/.roo/logs/` | +| Registros de activación de modos | Salida de consola al cambiar modos | +| Registros de invocación de habilidades | Salida de consola al usar habilidades | + +--- + +## 6. Extender Modos y Habilidades + +### 6.1 Agregar un Nuevo Modo + +**Paso 1: Crear Directorio del Modo** + +```bash +mkdir -p modes/nuevo-modo/rules +``` + +**Paso 2: Crear Configuración del Modo** + +Cree `modes/nuevo-modo/mode-config.yaml`: + +```yaml +name: "Nombre del Nuevo Modo" +slug: "nuevo-modo" +roleDefinition: "Describir lo que hace este modo" +whenToUse: "Describir cuándo usar este modo" +permissions: + fileRestrictions: + - "directorio-nuevo-modo/**/*" + allowedCommands: + - "comando-relevante" +customInstructions: | + Instrucciones adicionales +``` + +**Paso 3: Crear Archivos de Reglas XML** + +Cree los 7 archivos de reglas XML requeridos: + +```bash +# Use esta secuencia de prompts para generar cada archivo de reglas: +``` + +**Prompt para 1_workflow.xml:** +``` +Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '1_workflow.xml'. +Define el flujo de trabajo principal con estas etapas: +1. Recibir entrada +2. Procesar entrada +3. Validar salida +4. Entregar resultado + +Usa este formato: + + + + ... + ... + ... + ... + + +``` + +**Prompt para 2_best_practices.xml:** +``` +Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '2_best_practices.xml'. +Define 5 mejores prácticas para este modo con descripciones y ejemplos. +``` + +**Prompt para 3_common_patterns.xml:** +``` +Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '3_common_patterns.xml'. +Define 3-5 patrones de diseño comunes usados en este modo. +``` + +**Prompt para 4_decision_guidance.xml:** +``` +Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '4_decision_guidance.xml'. +Proporciona árboles de decisión y guía para elecciones comunes en este modo. +``` + +**Prompt para 5_examples.xml:** +``` +Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '5_examples.xml'. +Proporciona 2-3 ejemplos resueltos mostrando salida correcta de este modo. +``` + +**Prompt para 6_error_handling.xml:** +``` +Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '6_error_handling.xml'. +Define escenarios de error, métodos de detección y pasos de resolución. +``` + +**Prompt para 7_communication.xml:** +``` +Crea un archivo de reglas XML para el modo 'nuevo-modo' llamado '7_communication.xml'. +Define plantillas de transferencia para pasar trabajo hacia y desde este modo. +``` + +**Paso 4: Registrar Modo** + +Agregue el modo al archivo `.roomodes` o copie `mode-config.yaml` al directorio de modos. + +### 6.2 Agregar una Nueva Habilidad + +**Paso 1: Crear Directorio de Habilidad** + +```bash +mkdir -p skills/nueva-habilidad +``` + +**Paso 2: Crear SKILL.md** + +Cree `skills/nueva-habilidad/SKILL.md`: + +```markdown +--- +name: nueva-habilidad +description: Breve descripción de lo que hace esta habilidad +--- + +# Nueva Habilidad + +## Capacidades +- Capacidad 1: Descripción +- Capacidad 2: Descripción +- Capacidad 3: Descripción + +## Uso +Describir cuándo y cómo usar esta habilidad. Incluir escenarios específicos. + +## Entrada +Describir el formato de entrada esperado: +- Tipos de archivo aceptados +- Estructura de datos esperada +- Campos requeridos + +## Salida +Describir el formato de salida: +- Tipos de archivo producidos +- Estructura de datos devuelta +- Indicadores de éxito/fallo + +## Limitaciones +- Limitación 1 +- Limitación 2 + +## Suposiciones +- Suposición 1 +- Suposición 2 +``` + +**Paso 3: Probar Habilidad** + +1. Active el modo padre +2. Invoque la habilidad por nombre +3. Verifique que devuelva la salida esperada +4. Pruebe el manejo de errores con entrada inválida + +### 6.3 Modificar Modos Existentes + +**Para cambiar permisos:** +1. Edite `modes/[modo]/mode-config.yaml` +2. Actualice `fileRestrictions` o `allowedCommands` +3. Pruebe que el modo aún funciona correctamente + +**Para cambiar flujo de trabajo:** +1. Edite `modes/[modo]/rules/1_workflow.xml` +2. Asegure que el XML está bien formado +3. Pruebe el flujo de trabajo en Roo Code + +**Para agregar mejores prácticas:** +1. Edite `modes/[modo]/rules/2_best_practices.xml` +2. Agregue nuevos elementos `` +3. Verifique que el modo aplica las nuevas prácticas + +### 6.4 Modificar Habilidades Existentes + +**Para actualizar una habilidad:** +1. Edite `skills/[habilidad]/SKILL.md` +2. Actualice la sección relevante (Capacidades, Uso, Entrada, Salida, etc.) +3. Pruebe la habilidad en su modo padre + +--- + +## 7. Secuencias de Prompts para Tareas de Soporte + +### 7.1 Instalar Todos los Modos y Habilidades + +``` +Instala los 6 modos y 30 habilidades del proyecto innovation-content. +Copia las configuraciones de modos a .roomodes, reglas XML a .roo/rules-[slug]/, +y habilidades a .agents/skills/. Verifica que cada modo carga correctamente. +``` + +### 7.2 Validar Instalación + +``` +Valida la instalación de innovation-content: +1. Verifica que las 6 configuraciones de modo existen y son YAML válido +2. Verifica que los 42 archivos de reglas XML existen y están bien formados +3. Verifica que los 30 archivos SKILL.md existen y tienen frontmatter YAML +4. Prueba cambiar a cada modo +5. Reporta cualquier problema encontrado +``` + +### 7.3 Agregar Nuevo Modo + +``` +Crea un nuevo modo llamado '[Nombre del Modo]' con slug '[slug-del-modo]'. +Debe [describir propósito]. +Crea mode-config.yaml y 7 archivos de reglas XML en modes/[slug-del-modo]/. +El modo debe tener permisos para [listar directorios/patrones]. +``` + +### 7.4 Agregar Nueva Habilidad + +``` +Crea una nueva habilidad llamada '[Nombre de Habilidad]' para el modo [nombre-modo]. +Debe [describir capacidad]. +Crea SKILL.md en skills/[slug-habilidad]/ con frontmatter YAML, +secciones de Capacidades, Uso, Entrada, Salida, Limitaciones y Suposiciones. +``` + +### 7.5 Depurar Problema de Carga de Modo + +``` +Depura por qué el modo [slug-del-modo] no está cargando correctamente. +1. Verifica que mode-config.yaml existe y es YAML válido +2. Verifica que los 7 archivos de reglas XML existen y son XML bien formado +3. Verifica que los permisos de archivo no son demasiado restrictivos +4. Verifica conflictos con otros modos +5. Reporta hallazgos y solución sugerida +``` + +### 7.6 Depurar Habilidad No Encontrada + +``` +Depura por qué la habilidad [nombre-habilidad] no se encuentra. +1. Verifica que skills/[nombre-habilidad]/SKILL.md existe +2. Verifica que el frontmatter YAML tiene nombre y descripción +3. Verifica que la habilidad está en la lista de habilidades del modo correcto +4. Verifica conflictos de nombres +5. Reporta hallazgos y solución sugerida +``` + +### 7.7 Actualizar Permisos de Modo + +``` +Actualiza los permisos para el modo [slug-del-modo] para permitir edición de: +- [nuevo-patron-1]/**/* +- *.[nueva-extension] +Actualiza modes/[slug-del-modo]/mode-config.yaml y verifica el cambio. +``` + +### 7.8 Generar Documentación de Modo + +``` +Genera documentación para el modo [slug-del-modo] incluyendo: +1. Propósito del modo y cuándo usar +2. Lista de 5 habilidades con descripciones +3. Resumen del flujo de trabajo +4. Permisos de archivo +5. Protocolos de comunicación (transferencias hacia/desde este modo) +Salida como markdown adecuado para inclusión en README o wiki. +``` + +--- + +## 8. Mantenimiento + +### 8.1 Actualizar desde Remoto + +```bash +cd innovation-content +git pull origin main +# Re-instalar modos y habilidades si se agregaron nuevos +``` + +### 8.2 Respaldar Personalizaciones + +```bash +# Respaldar configuraciones de modos personalizados +cp ~/.roo/modes/*.yaml backups/modes/ + +# Respaldar habilidades personalizadas +cp -r ~/.agents/skills/* backups/skills/ + +# Respaldar reglas personalizadas +cp -r ~/.roo/rules-* backups/rules/ +``` + +### 8.3 Compatibilidad de Versiones + +| Versión de Contenido de Innovación | Versión Mínima de Roo Code | Notas | +|-------------------------------------|----------------------------|-------| +| 1.0.x | 3.8 | Lanzamiento inicial | +| 1.1.x | 3.8 | Guía del equipo de soporte y guía del usuario | +| 1.1.1 | 3.8 | Versiones en español de toda la documentación | + +--- + +## 9. Contacto y Escalamiento + +| Tipo de Problema | Contacto | Ruta de Escalamiento | +|------------------|----------|---------------------| +| Problemas de instalación | Equipo de Soporte | Líder Técnico | +| Problemas de comportamiento de modo | Desarrollador de Modos | Líder del Proyecto | +| Problemas de habilidades | Desarrollador de Habilidades | Líder del Proyecto | +| Solicitudes de funciones | Líder del Proyecto | Propietario del Producto | + +--- + +## 10. Apéndice + +### 10.1 Referencia de Estructura de Archivos + +``` +innovation-content/ +├── modes/ +│ └── [slug-del-modo]/ +│ ├── mode-config.yaml +│ └── rules/ +│ ├── 1_workflow.xml +│ ├── 2_best_practices.xml +│ ├── 3_common_patterns.xml +│ ├── 4_decision_guidance.xml +│ ├── 5_examples.xml +│ ├── 6_error_handling.xml +│ └── 7_communication.xml +├── skills/ +│ └── [slug-habilidad]/ +│ └── SKILL.md +└── docs/ + ├── plan.md + ├── srs.md + ├── support-team-guide.md + ├── user-guide.md + ├── plan-ES.md + ├── srs-ES.md + ├── support-team-guide-ES.md + └── user-guide-ES.md +``` + +### 10.2 Tarjeta de Referencia Rápida + +| Tarea | Comando/Acción | +|-------|----------------| +| Instalar modos | `cp modes/*/mode-config.yaml ~/.roo/modes/` | +| Instalar reglas | `cp -r modes/*/rules/* ~/.roo/rules-[slug]/` | +| Instalar habilidades | `cp -r skills/* ~/.agents/skills/` | +| Validar YAML | `yamllint mode-config.yaml` | +| Validar XML | `xmllint --noout regla.xml` | +| Probar modo | Cambiar a modo en Roo Code | +| Probar habilidad | Invocar habilidad por nombre en modo | diff --git a/docs/user-guide-ES.md b/docs/user-guide-ES.md new file mode 100644 index 0000000..8a4cd83 --- /dev/null +++ b/docs/user-guide-ES.md @@ -0,0 +1,531 @@ +# 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 |