Un ADR captura el porqué
Un ADR (Architecture Decision Record) documenta una decisión: no el código, el porqué.
Cada uno es un DEC-NNNN con secciones fijas: Contexto · Problema · Opciones · Evidencia · Decisión · Consecuencias · Riesgos · Validación.
En mod_exelearning (plugin de Moodle, GPLv3): 60 ADRs — 53 aceptadas, 4 propuestas, 3 superseded. En el código, cada función cita su decisión: // (DEC-0008).
El frontmatter deja rastro
id: DEC-0043
titulo: "Detección de GeoGebra calificable"
estado: Aceptada # Propuesta | Aceptada | Rechazada | Superseded
fecha: 2026-06-22
agentes: [erseco, codex]
herramienta_ia:
interfaz: codex
modelo: gpt-5
fuentes: [REPO-071, EXP-014]
- El ADR declara quién decidió (persona o agente) y con qué IA y modelo.
- "Sin fuente no hay afirmación": cada dato cita
repo + ruta + commit, doc oficial o experimento reproducible. - Ver el ADR completo en el repo: DEC-0043 ↗
Notas del ponente
Núcleo de la charla. Enseña, si puedes, un ADR real en github.com/exelearning/mod_exelearning. Elegí DEC-0043 a propósito para el ejemplo del frontmatter porque lo hizo codex + gpt-5 (no Claude): así ya planto la semilla del agnosticismo antes de llegar a esa sección.