Documentación del Framework

Knowledge Base

Conocimiento para el pipeline de creacion de cursos. Organizado en subdirectorios por ambito, alineados con los comandos /prime:* que cargan contexto.

  • Conocimiento de proceso: como funciona el pipeline, que archivos existen, que produce cada milestone, reglas de dependencia.
  • Conocimiento de dominio: principios de diseno instruccional que se necesitan para generar buenos outputs.
  • Conocimiento de desarrollo: como mantenemos el framework (releases, versionado).

Estructura

knowledge/
├── design-system.md             # Identidad visual: paleta de colores, significado semantico (cross-cutting)
├── framework/                   # Pipeline y reglas de estado
│   ├── system.md               # Pipeline completo: milestones, estructura, index.yaml, dependencias
│   └── state-propagation.md    # Reglas de propagacion de estado en index.yaml
├── foundation/                  # Metodologia de foundation (fases 1-4)
│   └── journey-design.md       # Arco de transformacion, fases experienciales, hilo narrativo
├── session/                     # Metodologia de sesion y produccion
│   ├── escaleta.md             # Escaleta: conceptos clave, flujo de bloques, timing aproximado
│   ├── session-design.md       # Diseno: Bloom+ABCD, MODELAR-PRACTICAR-APLICAR-REFLEXIONAR
│   └── (slides → skill `.claude/skills/slides/`)
└── development/                 # Mantenimiento del framework
    └── releases.md             # Convenciones de versionado, CHANGELOG, git tags

Los comandos /prime:* cargan automaticamente todos los archivos de su subdirectorio. Agregar un nuevo archivo a un subdirectorio se propaga sin modificar comandos.

El subdirectorio development/ no tiene /prime:* asociado — sus archivos se leen directamente desde los comandos que los necesitan (ej: /release lee releases.md).

Composicion de primes

/prime:framework  → lee knowledge/framework/*
/prime:foundation → ejecuta /prime:framework, luego lee knowledge/foundation/*
/prime:session    → ejecuta /prime:foundation, luego lee knowledge/session/* + knowledge/design-system.md
/prime:web        → ejecuta /prime:framework, luego lee web/ + knowledge/design-system.md

Documentos

DocumentoSubdirectorioTipoDescripcion
design-system.md(raiz)DominioIdentidad visual: paleta de colores con significado semantico (hoki=tecnologia, golden-tainoi=personas, copperfield=innovacion). Cross-cutting: lo cargan /prime:session y /prime:web
system.mdframeworkProcesoPipeline completo: 3 milestones, estructura de archivos, index.yaml, dependencias, comandos
state-propagation.mdframeworkProcesoReglas de propagacion de estado en index.yaml: que dependientes se marcan como needs-review y bajo que condiciones
journey-design.mdfoundationDominioComo disenar un journey: arco de transformacion, fases experienciales, hilo narrativo, anclajes motivacionales, lista de sesiones
escaleta.mdsessionDominioComo esbozar una escaleta de sesion: conceptos clave, flujo de bloques, tipo de actividad, timing aproximado
session-design.mdsessionDominioComo disenar una sesion: rituales, objetivos Bloom+ABCD, actividades MODELAR-PRACTICAR-APLICAR-REFLEXIONAR, presupuesto de tiempo
slides-production.mdsession—Migrado a skill slides (.claude/skills/slides/)
releases.mddevelopmentDesarrolloConvenciones de versionado semantico, formato del CHANGELOG, rutas del framework, git tags, proceso de release

Principios

  1. Declarativo: describe “que es” y “como funciona”, no instrucciones paso a paso
  2. Autocontenido: sin referencias a versiones anteriores
  3. Comprensible por humanos y IA: estructura clara, ejemplos concretos
  4. Fundacional: todo en el proyecto deriva de aqui