Skip to content
Back to search

flujo-diseno-cursos

Ecosistema abierto de Agent Skills y Orquestación Autónoma aplicable a cualquier grado académico para diseñar, producir y auditar cursos completos.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/czbm--flujo-diseno-cursos/badge.svg)](/listings/czbm--flujo-diseno-cursos)

HTML

<a href="/listings/czbm--flujo-diseno-cursos"><img src="/api/listings/czbm--flujo-diseno-cursos/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 195 lines
  1. <div align="center">
  2. <img src="assets/avatar.png" alt="Ing. Christian Ramón Chi" width="128" />
  3. # Flujo de Diseño de Cursos
  4. **Ecosistema abierto de Agent Skills y Orquestación Autónoma —aplicable a cualquier grado académico, disciplina y modalidad— para transformar un temario oficial en un sistema didáctico completo, trazable y auditable.**
  5. [![Versión](https://img.shields.io/badge/ecosistema-v4.2.0-blue.svg)](CHANGELOG.md)
  6. [![Alcance](https://img.shields.io/badge/grado%20acad%C3%A9mico-cualquier%20nivel-0ea5e9.svg)](#-qué-es)
  7. [![Skills](https://img.shields.io/badge/skills-16%20modulares-10b981.svg)](manifest.yaml)
  8. [![Orquestador](https://img.shields.io/badge/agente-orquestador%20aut%C3%B3nomo-6366f1.svg)](agents/orquestador-curso.md)
  9. [![Licencia](https://img.shields.io/badge/licencia-CC%20BY--SA%204.0%20%2B%20Apache%202.0-orange.svg)](LICENSE)
  10. [![Contribuciones](https://img.shields.io/badge/contribuciones-bienvenidas-brightgreen.svg)](CONTRIBUTING.md)
  11. [¿Qué es?](#-qué-es) • [¿Qué produce?](#-qué-hace-entregables) • [¿Cómo funciona?](#-cómo-lo-hace) • [Mapa de Skills](#-mapa-del-ecosistema) • [NUMA Deck](#-proyección-nativa-numa-deck-presentations) • [Inicio Rápido](#-cómo-empezar) • [Contribuir](#-contribuir)
  12. </div>
  13. ---
  14. ## ¿Qué es?
  15. **Flujo de Diseño de Cursos** es una arquitectura modular de **Agent Skills** (`SKILL.md`) y un **Agente Orquestador** diseñada para docentes, diseñadores instruccionales y equipos académicos que utilizan inteligencia artificial para planear, producir y auditar cursos completos.
  16. En lugar de depender de un solo prompt gigante o de chats aislados que pierden coherencia entre sesiones, este proyecto divide el diseño instruccional en **etapas especializadas conectadas por contratos explícitos**, igual que un pipeline de ingeniería de software: cada etapa tiene entradas definidas, reglas estrictas, salidas verificables y propiedad clara sobre lo que puede o no modificar.
  17. El sistema fue diseñado desde su origen para **aplicarse a cualquier grado académico** (educación básica, media superior, técnico superior, licenciatura, ingeniería, posgrado o formación continua), **cualquier disciplina** y **cualquier modalidad** (presencial, híbrida o en línea). Su etapa de auditoría (`04.A`) verifica específicamente que la profundidad real del contenido coincida con el nivel académico declarado, mientras que los perfiles en [`profiles/`](profiles/template-perfil-estilo.md) garantizan que los materiales se redacten **usando la semántica, terminología y voz propia del docente**, evitando textos genéricos de IA. Además, es compatible tanto con herramientas de agentes (Antigravity, Claude Code, Cursor, Gemini CLI, Codex) como con uso manual paso a paso en cualquier chat de IA.
  18. ---
  19. ## ¿Qué hace? (Entregables)
  20. A partir de un **temario oficial**, un **calendario académico** y el **encuadre docente**, el ecosistema es capaz de construir y mantener sincronizados todos los artefactos de una asignatura:
  21. | Etapa | Qué produce |
  22. |---|---|
  23. | **Perfil semántico docente** | **Perfil de estilo y semántica propia** (`00.P`) extraído desde corpus real, entrevista guiada o consolidación, que alimenta a `03.D`, `03.E` y `04.B`. |
  24. | **Planeación curricular** | **Documento Maestro del Curso** (ponderación temática, actividades oficiales con IDs estables, matriz de trazabilidad de competencias y calendario completo) + **Replaneación extraordinaria** ante cambios de calendario. |
  25. | **Diseño por sesión** | **Briefs contractuales por sesión** que fijan alcance, prerrequisitos, pesos por subtema y actividades vinculadas. |
  26. | **Desarrollo disciplinar** | **Ficha Teórica** (conceptos clasificados por nivel de desarrollo y bibliografía) y **Ficha Normativa** (marco regulatorio y contexto técnico aplicable). |
  27. | **Estrategia y producción visual** | **Orquestación visual por necesidad didáctica**, diferenciando recursos externos (resueltos y atribuidos) de recursos generativos (diseñados, auditados semánticamente con `PASS / RETURN` y ejecutados). |
  28. | **Materiales didácticos duales** | **Paquete sincrónico** (presentación proyectable en Markdown para alumno + guía docente, optimizada para [**NUMA Deck Presentations**](https://github.com/Czbm/numa-deck-presentations)) y **paquete asincrónico** (capítulo autocontenido del libro de la materia), generados en paralelo sin dependencia mutua y **redactados con la semántica propia del docente**. |
  29. | **Control de calidad y mejora** | **Auditoría académica en 4 capas** (trazabilidad, nivel, legibilidad editorial y fidelidad visual) + **implementación controlada de mejoras** con escalado formal cuando el ajuste corresponde a una etapa anterior. |
  30. | **Compilación editorial** | **Libro unificado de la asignatura** compilado a partir de los capítulos aprobados + reporte editorial de compilación. |
  31. ---
  32. ## ¿Cómo lo hace?
  33. El ecosistema opera bajo **cuatro principios arquitectónicos**:
  34. 1. **Contratos explícitos entre etapas:** cada skill declara exactamente qué consume y qué entrega. Los cambios en una etapa no rompen silenciosamente a las siguientes.
  35. 2. **Separación entre producción y auditoría:** el control de calidad (`04.A`) está desacoplado de la redacción (`03.D` / `03.E`) y de la corrección (`04.B`). Quien implementa mejoras downstream nunca altera por su cuenta contratos upstream.
  36. 3. **Orquestación idempotente y reanudable:** el agente coordinador (`00`) sigue el principio **`inspeccionar → clasificar → reutilizar → ejecutar → verificar → reanudar`**. Detecta qué artefactos ya son vigentes y regenera únicamente lo faltante o lo que quedó obsoleto por un cambio upstream.
  37. 4. **Semántica y voz propia del docente (desacoplada):** las skills garantizan el rigor metodológico y curricular, mientras que la **semántica propia del docente** —su vocabulario disciplinar, distinciones conceptuales, ritmo, estructura argumentativa y registro documental— se configura mediante perfiles intercambiables en [`profiles/`](profiles/template-perfil-estilo.md). Así, los guiones y capítulos suenan genuinamente al docente y no a prosa genérica de IA.
  38. ### Flujo general del ecosistema
  39. ```mermaid
  40. flowchart TD
  41. IN["Temario oficial + Calendario + Encuadre"] --> S01["01 · Documento Maestro"]
  42. S01 -. "Cambio extraordinario" .-> S01R["01.R · Replaneador"]
  43. S01 --> S02["02 · Briefs por Sesión"]
  44. S02 --> S03A["03.A · Ficha Teórica"]
  45. S02 --> S03B["03.B · Ficha Normativa"]
  46. S03A --> S03C1["03.C-1 · Orquestador Visual"]
  47. S03B --> S03C1
  48. S03C1 -- "Externo" --> S03C3["03.C-3 · External Resources"]
  49. S03C1 -- "Generativo" --> S03C2A["03.C-2A · Diseñador Generativo"]
  50. S03C2A --> S03C2B["03.C-2B · Auditor Semántico (PASS / RETURN)"]
  51. S03C2B -- "RETURN" --> S03C2A
  52. S03C2B -- "PASS" --> S03C2C["03.C-2C · Ejecutor Generativo"]
  53. S03C3 --> VIS["Paquete Visual Resuelto"]
  54. S03C2C --> VIS
  55. VIS --> S03D["03.D · Presentación + Guía Docente"]
  56. VIS --> S03E["03.E · Capítulo de Libro Autónomo"]
  57. S00P["00.P · Extractor de Perfil Docente"] -. "Semántica y voz propia" .-> S03D
  58. S00P -. "Semántica y voz propia" .-> S03E
  59. S03D --> S04A["04.A · Auditoría de Coherencia (4 capas)"]
  60. S03E --> S04A
  61. S04A --> S04B["04.B · Implementación de Mejoras"]
  62. S04B -. "Propiedad upstream" .-> S03C1
  63. S04B --> S05["05 · Compilador de Libro de Materia"]
  64. ```
  65. > Para el detalle completo de interfaces, brechas declaradas y modos de uso (operativo y retrospectivo), consulta [`docs/guia-uso-flujo.md`](docs/guia-uso-flujo.md).
  66. ---
  67. ## Mapa del ecosistema
  68. | ID | Componente | Versión | Estado | Archivo |
  69. |---|---|---:|---|---|
  70. | `00` | **Orquestador Autónomo** *(Agente)* | `1.1` | Estable | [`agents/orquestador-curso.md`](agents/orquestador-curso.md) |
  71. | `00.P` | **Extractor de Perfil Semántico y de Estilo** | `1.0` | Estable | [`skills/00p-extractor-perfil-estilo/SKILL.md`](skills/00p-extractor-perfil-estilo/SKILL.md) |
  72. | `01` | **Planeación General del Curso** | `1.6` | Estable | [`skills/01-planeacion-curso/SKILL.md`](skills/01-planeacion-curso/SKILL.md) |
  73. | `01.R` | **Replaneador por Cambio de Calendario** | `0.1` | Borrador | [`skills/01r-replaneador-calendario/SKILL.md`](skills/01r-replaneador-calendario/SKILL.md) |
  74. | `02` | **Briefs por Sesión** | `2.8` | Estable | [`skills/02-briefs-sesion/SKILL.md`](skills/02-briefs-sesion/SKILL.md) |
  75. | `03.A` | **Ficha Teórica** | `1.12` | Estable | [`skills/03a-ficha-teorica/SKILL.md`](skills/03a-ficha-teorica/SKILL.md) |
  76. | `03.B` | **Ficha Normativa** | `1.4` | Estable | [`skills/03b-ficha-normativa/SKILL.md`](skills/03b-ficha-normativa/SKILL.md) |
  77. | `03.C-1` | **Orquestador Visual** | `1.2` | Estable | [`skills/03c-1-orquestador-visual/SKILL.md`](skills/03c-1-orquestador-visual/SKILL.md) |
  78. | `03.C-2A` | **Diseñador Generativo** | `1.3` | Estable | [`skills/03c-2a-disenador-generativo/SKILL.md`](skills/03c-2a-disenador-generativo/SKILL.md) |
  79. | `03.C-2B` | **Auditor Semántico** | `1.1` | Estable | [`skills/03c-2b-auditor-semantico/SKILL.md`](skills/03c-2b-auditor-semantico/SKILL.md) |
  80. | `03.C-2C` | **Ejecutor Generativo** | `0.1` | Borrador · `help wanted` | [`skills/03c-2c-ejecutor-generativo/SKILL.md`](skills/03c-2c-ejecutor-generativo/SKILL.md) |
  81. | `03.C-3` | **External Resources** | `0.1` | Borrador · `help wanted` | [`skills/03c-3-external-resources/SKILL.md`](skills/03c-3-external-resources/SKILL.md) |
  82. | `03.D` | **Composición Dual (Presentación + Guía)** | `2.1` | Estable | [`skills/03d-composicion-dual/SKILL.md`](skills/03d-composicion-dual/SKILL.md) |
  83. | `03.E` | **Capítulo de Libro Autónomo** | `2.4` | Estable | [`skills/03e-capitulo-libro/SKILL.md`](skills/03e-capitulo-libro/SKILL.md) |
  84. | `04.A` | **Auditoría de Coherencia** | `2.5` | Estable | [`skills/04a-auditoria-coherencia/SKILL.md`](skills/04a-auditoria-coherencia/SKILL.md) |
  85. | `04.B` | **Implementación de Mejoras** | `1.2` | Estable | [`skills/04b-implementacion-mejoras/SKILL.md`](skills/04b-implementacion-mejoras/SKILL.md) |
  86. | `05` | **Compilador de Libro de Materia** | `1.1` | Estable | [`skills/05-compilador-libro/SKILL.md`](skills/05-compilador-libro/SKILL.md) |
  87. | `06` | **Exportador Profesional (PDF/DOCX/PPTX)** | — | Pendiente · `help wanted` | *Abierto a contribuciones* |
  88. ---
  89. ## Cómo empezar
  90. ### Opción 1 · Uso con Agentes / Plugin (Antigravity, Claude Code, Cursor, Gemini CLI, Codex)
  91. 1. Clona el repositorio o instálalo como plugin local (incluye [`plugin.json`](plugin.json) y [`AGENTS.md`](AGENTS.md)).
  92. 2. *(Opcional)* Genera tu perfil de semántica y voz docente ejecutando la skill [`00p-extractor-perfil-estilo`](skills/00p-extractor-perfil-estilo/SKILL.md) con tus propios textos o mediante entrevista guiada (también puedes copiar [`profiles/template-perfil-estilo.md`](profiles/template-perfil-estilo.md) o ver un ejemplo real en [`profiles/crc-referencia.md`](profiles/crc-referencia.md)).
  93. 3. Ejecuta el agente [`agents/orquestador-curso.md`](agents/orquestador-curso.md) sobre la carpeta de tu asignatura, o invoca cualquier skill de forma puntual (por ejemplo, `01-planeacion-curso` para empezar desde tu temario).
  94. ### Opción 2 · Uso manual en cualquier chat de IA (ChatGPT, Claude, Gemini)
  95. 1. Abre la skill de la etapa que necesitas en `skills/<etapa>/SKILL.md`.
  96. 2. Entrega el contenido de la skill junto con los insumos de entrada requeridos (temario, Documento Maestro o Brief).
  97. 3. Guarda el documento generado y pásalo a la siguiente etapa siguiendo el diagrama.
  98. ---
  99. ## Estructura del repositorio
  100. ```text
  101. flujo-diseno-cursos/
  102. ├── plugin.json # Manifiesto de plugin (Antigravity)
  103. ├── manifest.yaml # Registro central de versiones y dependencias
  104. ├── AGENTS.md # Instrucciones raíz para agentes de código
  105. ├── agents/ # Agente orquestador autónomo (00)
  106. ├── skills/ # 16 skills modulares en formato estándar SKILL.md
  107. ├── profiles/ # Plantilla de estilo docente y perfiles de referencia
  108. ├── rules/ # Reglas transversales del ecosistema
  109. ├── docs/ # Guía operativa completa del flujo
  110. ├── examples/ # Espacio para Golden Examples de sesiones completas
  111. ├── scripts/ # Validación automática de estructura y contratos
  112. └── .github/ # CI (GitHub Actions) y plantillas de Issues/PRs
  113. ```
  114. ---
  115. ## Contribuir
  116. Este proyecto está abierto a la comunidad docente y técnica. Las áreas donde más valor aporta tu contribución ahora mismo son:
  117. - **Cerrar borradores visuales:** pruebas reales y estabilización de `03.C-2C` (Ejecutor Generativo) y `03.C-3` (External Resources).
  118. - **Etapa `06` (Exportador profesional):** diseño de scripts/skill para exportar a PDF, DOCX y PPTX.
  119. - **Golden Examples:** aportar una sesión completa de ejemplo en [`examples/`](examples/README.md).
  120. - **Nuevos perfiles y adaptadores:** perfiles docentes en [`profiles/`](profiles/template-perfil-estilo.md) o mejoras de compatibilidad con otros entornos de agentes.
  121. Antes de abrir un Pull Request, revisa [`CONTRIBUTING.md`](CONTRIBUTING.md) y ejecuta:
  122. ```bash
  123. python scripts/validate_repo.py
  124. ```
  125. ---
  126. ## Proyección nativa: NUMA Deck Presentations
  127. Las presentaciones Markdown y guías docentes generadas por la etapa [`03.D`](skills/03d-composicion-dual/SKILL.md) están diseñadas para abrirse y proyectarse de forma nativa en [**NUMA Deck Presentations**](https://github.com/Czbm/numa-deck-presentations):
  128. - **Modo dual sincronizado:** proyecta las diapositivas limpias para el alumno mientras el docente consulta su guía en pantalla paralela.
  129. - **Soporte técnico completo:** renderizado de fórmulas **KaTeX**, gráficos **SVG e imágenes** con zoom interactivo y paginación inteligente de tablas.
  130. - **Control remoto móvil (*Android-Link*):** navegación de slides, puntero en pantalla y apertura de imágenes desde el celular (WebSocket / conexión directa).
  131. 👉 **Repositorio oficial:** [github.com/Czbm/numa-deck-presentations](https://github.com/Czbm/numa-deck-presentations)
  132. ---
  133. ## Autoría y Licencia
  134. Creado y mantenido por **Ing. Christian Ramón Chi** y contribuidores de la comunidad.
  135. Este repositorio utiliza **licencia dual** (consulta [`LICENSE`](LICENSE)):
  136. - **Skills, agentes, metodología y documentación** (`skills/`, `agents/`, `docs/`, `profiles/`, `rules/`): [**CC BY-SA 4.0**](LICENSE-CC-BY-SA-4.0) *(Reconocimiento-CompartirIgual — las mejoras a las skills deben seguir siendo abiertas)*.
  137. - **Código fuente y scripts** (`scripts/`, workflows y manifiestos): [**Apache 2.0**](LICENSE-APACHE).
  138. - **Cursos generados por docentes:** el material académico que produzcas *usando* estas skills te pertenece íntegramente y no hereda la cláusula *ShareAlike*.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.