CRITERIO

Criterio · ejemplo: ADR de un Repositorio

Diario de decisiones (ADR) y ciclo de Kolb

Escribe cada decisión con contexto, alternativas y consecuencias esperadas; revísala después.

Evidencia moderada65 min en total

Un Architecture Decision Record es la línea de tiempo escrita: contexto y fuerzas (t<0), decisión (t=0), consecuencias esperadas (t>0). Volver a leerlo semanas después y anotar lo que realmente pasó cierra el ciclo de Kolb: experiencia, reflexión, concepto, nueva prueba.

Para quién
Intermedio y avanzado. Ideal si ya trabajas en un equipo.
Fuente
Kolb (1984), Experiential Learning; Di Stefano et al. (2014), Making Experience Count; Nygard (2011), ADR
Estudios controlados con resultados favorables, con matices según contexto.
Probar el ejemplo

El plan en el tiempo

Qué haces antes, durante y después. Mueve t y mira qué ya ocurrió.

Antes de encontrar el concepto t<0

  1. t=-1

    Describes el contexto y las fuerzas

    Pregunta previa · 5 min · Preguntarse antes activa lo que ya sabes y orienta la atención (efecto de pretest).

El encuentro t=0

  1. t=0

    Registras la decisión y la alternativa descartada

    Explicación · 30 min · El primer encuentro: alguien (o un texto) explica el concepto.

Después: consolidar t>0

  1. t=+1

    Escribes qué consecuencias esperas

    Reflexión escrita · 10 min · Escribir qué esperabas y qué pasó convierte experiencia en criterio.

  2. t=+7

    Primera revisión: qué pasó realmente

    Reflexión escrita · 10 min · Escribir qué esperabas y qué pasó convierte experiencia en criterio.

  3. t=+21

    Segunda revisión: ¿la volverías a tomar?

    Reflexión escrita · 10 min · Escribir qué esperabas y qué pasó convierte experiencia en criterio.

Trayectoria frente al método de control

0255075100-30+3+7+14+21+30
Diario de decisiones (ADR) y ciclo de KolbReleer y subrayar (control)

Se aplica en la ruta

Úsala programando, no solo leyendo

Lección 14 · Objetos

Value Object: valores que no cambian

Escribe un ADR corto: por qué representar dinero con un Value Object y no con int.

Pruébalo ahora

ADR de un Repositorio

Escribe tu decisión en formato ADR y descárgala en Markdown para tu repositorio.

docs/decisiones/0001.md

1# Repositorio como puerto para Pedidos
2
3Fecha: 
4Estado: aceptada
5
6## Contexto (t<0)
7Las reglas del pedido (límite de crédito, no confirmar vacío) se prueban hoy con una base levantada; cada prueba tarda 2 s.
8
9## Fuerzas
10Probar reglas rápido; poder leer pedidos de una API externa el próximo trimestre; el equipo conoce bien el ORM.
11
12## Alternativas consideradas
13Usar el modelo del ORM como entidad de dominio.
14
15## Decisión (t=0)
16Declarar RepositorioDePedidos como Protocol en el dominio, con adaptador en memoria para pruebas y otro para PostgreSQL.
17
18## Consecuencias esperadas (t>0)
19Una interfaz y un adaptador más que mantener. Pruebas de dominio en milisegundos. La API externa será otro adaptador.
20
21## Revisiones
22- t=+7: ¿qué pasó realmente?
23- t=+21: ¿la volverías a tomar?
24

Aplícalo esta semana

Con tu propio código de Python

Cuándo no usarla

Si nunca vas a releerlo: sin la revisión en t>0, es solo burocracia.

Señal de que funciona

Tus ADR nuevos anticipan consecuencias que los viejos no veían.

Tu decisión

¿Diario de decisiones te hizo aprender?

Responde después de probar el ejemplo. Se guarda solo en este navegador.