# Protocolo de generación de contenidos — Pizarrón Verde

Versión: 7  
Llamada: 7 de ChatGPT  
Estado: documento de planificación, sin generación de lecciones completas todavía.

## 1. Propósito

Este protocolo define cómo se producirán los contenidos de los cursos de Pizarrón Verde. El objetivo es que cada tema, dividido en lecciones, alcance un nivel universitario y sea útil tanto para estudiantes como para docentes.

Cada lección deberá integrar tres dimensiones:

1. **Teoría:** explicación conceptual, definiciones, propiedades, leyes, teoremas, fórmulas e interpretación.
2. **Ejercicios resueltos:** problemas modelo con resolución paso a paso y comentarios pedagógicos.
3. **Ejercicios propuestos:** práctica graduada, con respuestas cuando corresponda.

## 2. Principios editoriales

- No generar contenido de manera masiva sin mapa previo.
- No declarar un tema como terminado si no tiene teoría, práctica resuelta y práctica propuesta.
- Mantener un tono de libro universitario claro, riguroso y progresivo.
- Usar notación matemática cuidada y compatible con MathJax cuando el contenido vaya a HTML.
- Incluir figuras sugeridas con descripciones claras cuando una explicación lo requiera.
- Indicar relaciones con simulaciones, Calculas o Python cuando aporten valor real.
- Revisar enlaces, estructura y rutas antes de empaquetar cada nueva versión.


## 2.1. Referencias abiertas de orientación

Por indicación de Adrián en la Llamada 7, la generación futura de contenidos debe tomar como referencias de organización, enfoque pedagógico y claridad expositiva los sitios:

- OpenStax: `https://openstax.org/`
- LibreTexts: `https://one.libretexts.org/home`

Criterio de uso:

- usarlos como inspiración de estructura, progresión, recursos didácticos, ejemplos y nivel de detalle;
- mantener todo el contenido final de Pizarrón Verde en **español**;
- no hacer traducción literal ni copia textual;
- adaptar el desarrollo al programa propio del sitio y al público de Adrián;
- verificar licencias y atribuciones antes de reutilizar figuras, tablas o fragmentos externos.

## 3. Flujo de trabajo por tema

### Etapa A — Selección

Elegir un curso y un tema concreto. Registrar:

- área;
- curso;
- tema;
- público objetivo;
- prerequisitos;
- alcance de la primera tanda de lecciones.

### Etapa B — Mapa de lecciones

Antes de redactar teoría, crear un mapa con:

- nombres de lecciones;
- objetivos de aprendizaje;
- conceptos clave;
- ejercicios modelo esperados;
- figuras o simulaciones necesarias;
- posibles actividades con Calculas/Python.

### Etapa C — Esqueleto de archivos

Cada tema nuevo debería tener como mínimo:

```text
tema/
  index.html
  leccion-01.html
  ejercicios-resueltos.html
  ejercicios-propuestos.html
  fuentes.md
  applets.md
  checklist.md
  imagenes/
```

Para temas ya existentes con una estructura más simple, no se debe romper lo previo: se agregan archivos de manera gradual.

### Etapa D — Redacción

La teoría se redacta primero. Luego se agregan ejercicios resueltos y propuestos. Cada bloque debe tener coherencia interna y no depender de contenido todavía inexistente.

### Etapa E — Revisión

Antes de cerrar la llamada:

- verificar enlaces internos;
- revisar nombres de archivos y carpetas;
- evitar rutas largas para Windows;
- actualizar `VERSION.txt`, `CHANGELOG.md`, `README.md` y, si corresponde, `ROADMAP.md`;
- empaquetar con raíz interna corta `PV-vN/`.

## 4. Protocolo ChatGPT-Claude

- Las llamadas impares corresponden a ChatGPT.
- Las llamadas pares corresponden a Claude.
- Cada llamada debe producir una mejora concreta, incremental y verificable.
- Si Adrián interviene con `Soy Adrián... Fin de mi aporte.`, ese aporte se trata como instrucción prioritaria.
- Cuando se empiece a generar contenido real, una IA puede crear el borrador y la otra puede revisar coherencia, estructura, navegación y calidad pedagógica.

## 5. Criterio de “tema listo”

Un tema solo se considerará listo si contiene:

- portada o índice del tema;
- teoría completa de las lecciones previstas para esa etapa;
- ejercicios resueltos representativos;
- ejercicios propuestos graduados;
- respuestas o claves cuando sea útil;
- fuentes o bibliografía base;
- checklist de calidad completado;
- enlaces internos sin roturas.