Estándar pedagógico clase-profunda-v2#

Especificación formal que toda clase del programa debe cumplir. Sirve para tres cosas: producir contenido nuevo, auditar contenido existente y detectar degradación con el tiempo.

1. Requisitos obligatorios#

Una clase cumple el estándar si y sólo si satisface todos estos requisitos:

2. Definición operacional de «definición operacional»#

Un concepto cumple R3 si su definición permite que dos personas independientes clasifiquen el mismo caso de la misma forma.

Ejemplos:

3. Definición operacional de «señal»#

Una señal cumple R4 si declara al menos:

• qué se cuenta (numerador),
• sobre qué base (denominador),
• en qué ventana temporal.

Recomendado adicionalmente: fuente, frecuencia, responsable, lectura permitida y lectura prohibida. La ficha completa está en FORMULAS-Y-METRICAS.md.

4. Definición operacional de «frontera de aplicación»#

Una frontera cumple R6 si describe una condición bajo la cual el método enseñado deja de funcionar o produce daño, no una advertencia genérica.

5. Progresión entre clases#

Dentro de una parte, las 14 clases siguen una progresión definida:

Cada parte cierra con una clase de síntesis que produce el artefacto de portafolio.

6. Progresión entre partes#

6 bis. Fundamentación bibliográfica#

Citar una obra no fundamenta nada. El estándar exige tres niveles y verifica el tercero:

aportes.py cataloga 395 ideas identificables repartidas entre las 96 obras. anclajes.py asigna, para cada una de las 336 clases, cuál de esas ideas sostiene cada una de sus cuatro citas: 1.344 anclajes.

El validador rechaza tres situaciones: una obra citada sin anclaje, un identificador que no existe en el catálogo de aportes, y un anclaje cuyo texto coincide con el lente general de la obra —porque si sirve para cualquier clase, no ancla ninguna—.

Nunca se citan números de página. Las páginas cambian entre ediciones y el programa no puede garantizarlas; el anclaje indica el capítulo o la sección por su nombre dentro de la obra.

7. Prohibiciones explícitas#

Una clase no puede:

• Presentar una táctica sin su condición de aplicación.
• Usar una métrica sin definirla operacionalmente.
• Afirmar un contenido normativo sin remitir a fuente oficial.
• Prometer resultados de mercado a partir de datos simulados.
• Reproducir texto protegido por derechos de autor.
• Presentar una única alternativa como respuesta correcta a un problema de decisión.
• Citar una obra sin declarar qué idea concreta de ella sostiene la clase.
• Atribuir a una obra un número de página o de capítulo que no se haya verificado.
• Reutilizar el mismo párrafo de desarrollo en dos clases distintas.

8. Auditoría del estándar#

python tools/validate_depth.py        # R1, extensión por clase
python tools/validate_repository.py   # R2 a R17, estructura y secciones
python tools/audit_fuentes.py         # R8, anclaje bibliográfico clase a clase
python -m pytest -q                   # pruebas completas

Cualquier clase que falle un requisito debe corregirse en curriculum/spec/ y regenerarse. El Markdown no se edita a mano: la fuente de verdad es la especificación.

9. Versión del estándar#

clase-profunda-v2 es la versión vigente y la que cumplen las 336 clases del programa. Sustituye a clase-profunda-v1 en cuatro puntos: el desarrollo se redacta clase a clase en lugar de generarse por plantilla (R14), cada cita se ancla a una idea concreta de la obra (R8), la clase abre con prerrequisitos y criterio de término (R15) y cierra las preguntas de comprobación con criterios de respuesta suficiente (R17). Cualquier cambio que altere los requisitos R1 a R17 exige una versión nueva, la regeneración completa del currículo y una entrada en el changelog: un estándar que cambia en silencio deja de ser auditable.

⬅ Documentación · Metodología · Guía docente