docs / Registro de decisionesDecision records
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.pyy 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 |
Decision records are written in Spanish.
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.pyy 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 |