# Redacción de registros de decisión

Convierte una decisión ya tomada en un registro que el próximo lector pueda juzgar sin haber estado en la sala.

## Entregable

Un documento Markdown, `decision-record.md`, con la estructura fijada en **Salida** más abajo. Toma la matriz de **Comparación de opciones y análisis de renuncias** y alimenta **Revisión posterior a la decisión**.

## Entradas obligatorias

- **La decisión que se tomó** — en una frase, con las palabras de quien la tomó.
- **El contexto que la forzó** — qué estaba ocurriendo que hizo necesaria una decisión.
- **Las alternativas descartadas** — al menos una, con quién la descartó.

Si falta cualquiera de las tres, detente y repórtalo. Un registro escrito sin las alternativas descartadas documenta un desenlace y no una decisión, y el próximo lector no puede saber si la opción que está a punto de plantear ya se consideró.

## Entradas opcionales

- La comparación que la precedió, si existe — `option-comparison.md` es la forma esperada
- Las personas consultadas y la posición que sostuvo cada una
- Restricciones que estrecharon el campo: presupuesto, plazo, regulación, contrato, sistemas existentes
- Las consecuencias que quien decidió aceptó a sabiendas
- La fecha, el suceso o la medición que debería disparar una revisión

Las entradas opcionales ausentes se registran como huecos del propio registro, cada uno con quién podría llenarlo. El registro se emite igualmente: una decisión con un registro incompleto está mejor documentada que una decisión sin registro.

## Ejecución

**1 — Fijar la decisión en una frase.** Qué se decidió, quién lo decidió y en qué fecha. Una frase que describe una dirección en lugar de una elección no es una decisión: pide la elección y registra la dirección como contexto.

**2 — Escribir el contexto que la forzó.** Qué estaba ocurriendo, qué costaba y por qué la decisión no podía aplazarse. El contexto es lo que un lector posterior necesita para juzgar si la decisión sigue aplicando. Limítate a lo que las entradas declaran.

**3 — Fijar el estado.** `propuesta`, `aceptada`, `sustituida` o `revertida`, con la fecha en que entró en ese estado y quién lo puso. Un registro cuyo estado nadie fijó es `propuesta`, diga lo que diga la conversación alrededor.

**4 — Trasladar las alternativas.** Cada alternativa descartada con lo que habría dado, por qué no se eligió y quién la descartó. Cuando existe una comparación, toma de ella los motivos en lugar de reescribirlos de memoria; un motivo que contradice la comparación es una discrepancia y se señala como tal.

**5 — Registrar las consecuencias aceptadas.** Qué vuelve la decisión más difícil, más lento, más caro o imposible, y quién carga con cada cosa. Separa las consecuencias aceptadas a sabiendas de las descubiertas después. Un registro que solo lista beneficios se escribió para defender la decisión.

**6 — Nombrar las condiciones de revisión.** El hecho, suceso o medición concreta cuyo cambio debería reabrir esta decisión, y quién lo vigila. Un registro sin condición de revisión se vuelve permanente por descuido.

**7 — Enlazar el registro con lo que obliga.** El trabajo, los documentos y los demás registros que esta decisión gobierna, y cualquier registro al que sustituye. Un registro sustituido se marca como sustituido, nunca se borra.

## Salida

`decision-record.md`, en este orden:

- **1. Título e identificador** — la decisión en una línea, con la fecha en que se tomó
- **2. Estado** — `propuesta`, `aceptada`, `sustituida` o `revertida`, con la fecha y quién lo fijó
- **3. Contexto** — qué forzó la decisión y qué habría costado aplazarla
- **4. Decisión** — qué se decidió, por quién y con qué autoridad
- **5. Alternativas descartadas** — una línea cada una: la alternativa, qué ofrecía, por qué perdió, quién la descartó
- **6. Consecuencias aceptadas** — qué se vuelve más difícil, más lento o imposible, y quién carga con ello
- **7. Condiciones de revisión** — el hecho, suceso o medición cuyo cambio reabre esto
- **8. Trabajo y registros obligados** — qué gobierna esta decisión y a qué registro sustituye
- **9. Huecos** — qué no pudo establecer el registro y quién puede aportarlo

## Validación

El registro está listo cuando se cumple todo esto:

- La sección 4 nombra a quien decidió y con qué autoridad, no a un grupo sin nombres dentro
- La sección 5 lista al menos una alternativa descartada con su motivo
- La sección 2 lleva un estado y la fecha en que se fijó
- La sección 6 nombra al menos una consecuencia que no es un beneficio
- La sección 7 nombra una condición que alguien podría observar, no un cambio de circunstancias en general
- Cada afirmación de las secciones 3 a 6 se traza hasta una entrada, con su fuente

Falla la ejecución si el registro no lista ninguna alternativa descartada, o si la sección 6 solo contiene beneficios.

## Gestión de fallos

- **No se aportaron alternativas** — detente. Informa de que un registro sin alternativas descartadas no se distingue de un anuncio, y nombra a quién puede listarlas.
- **No se identifica a quien decidió** — emite el registro con la sección 4 marcada como `DECISOR SIN REGISTRAR` y elévalo a la sección 9. Registra a quien reportó la decisión y declara con claridad que es quien la reporta y no quien la tomó.
- **Sin acceso a la comparación previa** — escribe el registro con lo aportado, marca la sección 5 como `motivos según lo reportado` y declara que no se contrastaron con una comparación.
- **Los motivos declarados contradicen la comparación** — registra los dos, nombra ambas fuentes y eleva la discrepancia a la sección 9. No prefieras en silencio el relato posterior.
- **Material parcial** — emite el registro con cada sección que las entradas sostengan y marca el resto como `INCOMPLETO — pendiente de <pregunta>`. Un registro incompleto escrito ahora vale más que uno completo escrito de memoria más tarde.