docs / Registro de decisiones

Registro de decisiones de arquitectura (ADR)#

Este directorio documenta las decisiones que dan forma a la especificación .mini (SPEC.md, SPEC.es.md) y a sus implementaciones. Cada registro sigue el formato MADR en versión breve: contexto y problema, alternativas consideradas, decisión, consecuencias y evidencia. La evidencia enlaza archivos del repositorio; toda cifra citada figura literalmente en el archivo enlazado o se obtiene contando sus filas, y así se indica.

Convenciones:

  • Numeración correlativa de cuatro dígitos; un registro aceptado no se reescribe. Si una decisión cambia, se crea un registro nuevo que declara a cuál reemplaza.
  • Estados: propuesta, aceptada, reemplazada por ADR NNNN.
  • Los registros 0001–0007 documentan de forma retrospectiva decisiones vigentes desde SPEC 1.0 (2026-09-01). Los registros 0008–0016 corresponden a SPEC 1.1 (2026-09-17) y a la versión 1.2.0 de las herramientas.
  • Una regla nueva de la especificación requiere su ADR, su caso de conformidad en conformance/generate.py y la implementación equivalente en Python y TypeScript (CONTRIBUTING.md).

Índice#

ADR Título Estado SPEC
0001 Formato posicional con contrato compartido aceptada 1.0, §1, §6, §7
0002 Protección del separador con barra invertida y comillas CSV aceptada 1.0, §3.3, §3.4
0003 Lista marcada con sufijo * aceptada 1.0, §6
0004 Clave de conteo n y count_key aceptada 1.0, §5
0005 Modo tolerante y recuperación parcial aceptada 1.0, §8
0006 Protocolo de bifurcación e invariantes I1–I5 aceptada 1.0, §10
0007 Compatibilidad hacia adelante mediante v aceptada 1.0, §6, §10
0008 Motor del playground generado desde la biblioteca TypeScript aceptada 1.1, §2
0009 \, es un escape válido con cualquier separador aceptada 1.1, §3.3
0010 Formas léxicas estrictas de booleanos y números aceptada 1.1, §4, §6
0011 Código de error de un valor de cabecera mal tipado aceptada 1.1, §5
0012 Claves de cabecera repetidas aceptada 1.1, §5
0013 Elementos de lista vacíos aceptada 1.1, §3.4, §6
0014 La lista opcional vacía es null aceptada 1.1, §6
0015 Códigos de error del serializador aceptada 1.1, §9
0016 Tipos date y decimal aceptada 1.1, §6