Atlasingeniería

Comunicación y liderazgo técnicoTech LeadTema 8Tech Lead

Puertas de ida y puertas de ida y vuelta

El costo de equivocarse no es el mismo en todas las decisiones, y tratarlas a todas igual sale caro de los dos lados: parálisis en las baratas, improvisación en las caras. Separarlas por si se pueden deshacer es la heurística que más tiempo ahorra.

Dos decisiones de la misma semana: qué biblioteca de fechas usar, y en qué proveedor de nube vivir. Muchos equipos les dedican, en la práctica, la misma cantidad de reunión.

Una se deshace en una tarde. La otra condiciona los próximos cinco años. Antes de decidir algo conviene decidir cuánto cuesta deshacerlo, porque de esa respuesta sale cuánto rigor merece la discusión y quién tiene que estar en ella.

Dos tipos de puerta

La formulación que popularizó Jeff Bezos en una carta a accionistas de 2015 distingue decisiones de tipo 1 —puertas de una sola dirección: cruzarlas y volver es carísimo o imposible— y de tipo 2 —puertas de ida y vuelta: si del otro lado no gusta, se vuelve.

Puerta de ida (tipo 1)Puerta de ida y vuelta (tipo 2)
Costo de deshacerlaAlto: meses de trabajo, migración de datos, contratosBajo: días o menos
Cuánto análisis mereceMucho: alternativas escritas, prueba de concepto, revisiónPoco: elegir con criterio y seguir
Quién decideSe consulta ampliamente y queda registradoQuien está más cerca del problema
Qué pasa si te equivocásSe convive con el error mucho tiempoSe corrige y se aprendió algo
EjemplosModelo de datos central, esquema de multi-tenencia, proveedor de identidad, formato público de una APIBiblioteca interna, estructura de carpetas, nombre de un módulo, herramienta de formateo
La mayoría de las decisiones del día a día son de tipo 2, y se las trata como si fueran de tipo 1.

Antes de seguir, predecí

Un equipo tiene que elegir el formato de los identificadores públicos de su API: números incrementales o identificadores opacos. ¿Qué tipo de decisión es?

Cómo reconocer cuál es cuál

No siempre es obvio. Cuatro preguntas alcanzan para casi todos los casos:

Para clasificar una decisión

  1. ¿Genera datos que después hay que migrar? Todo lo que escribe datos con una forma determinada endurece muy rápido. Los datos son lo que menos se deshace.
  2. ¿Se lo exponemos a alguien que no controlamos? Clientes, integraciones, otro equipo con su propio plan. Coordinar a terceros es lo que convierte un cambio chico en un proyecto.
  3. ¿Cuánta gente lo va a usar antes de que sepamos si estuvo bien? Una decisión que se propaga a cincuenta archivos en dos semanas se vuelve de tipo 1 por difusión, aunque haya nacido reversible.
  4. ¿Hay un contrato o una plata comprometida? Un compromiso de tres años con un proveedor es tipo 1 aunque técnicamente se pueda migrar.

Cuando el equipo trata una puerta de vuelta como una de ida

Escenario · 1 decisión como mínimo

Tercera reunión sobre qué biblioteca usar para un formulario

Dos personas del equipo llevan dos semanas discutiendo qué biblioteca de formularios adoptar. Hay un documento comparativo de seis páginas. Hoy te piden que desempatés en una reunión de una hora. ¿Qué hacés?

El punto no es qué biblioteca gana: es que la pregunta «¿cuánto cuesta deshacerlo?» venga antes que «¿cuál es mejor?».

Dejar registro de las de tipo 1

Las decisiones reversibles no necesitan documento. Las de tipo 1 sí, y no por burocracia: dentro de dos años alguien va a preguntar por qué esto es así, y sin registro la respuesta va a ser «no sé, ya estaba». Un registro de decisión de arquitectura (ADR) entra en una página.

Plantilla

Registro de una decisión de arquitectura

Título y fecha

Una frase que diga qué se decidió, no qué se discutió. «Identificadores opacos en la API pública», con la fecha.

Se numeran y no se borran: un ADR viejo se marca como reemplazado por otro, y el viejo queda.

Contexto

Qué situación obligó a decidir, qué restricciones había y qué se sabía en ese momento. Incluye lo que NO se sabía.

Esta sección es la que hace útil el documento dentro de dos años: explica por qué una decisión que hoy parece rara era razonable entonces.

Opciones consideradas

Dos o tres alternativas reales, con su ventaja principal y el motivo concreto por el que se descartó cada una.

Sin alternativas descartadas no hay decisión, hay un anuncio.

Decisión

Qué se eligió y cuál fue el criterio que desempató.

Una sola frase. Si necesita un párrafo, el criterio todavía no está claro.

Consecuencias

Qué se vuelve más fácil, qué se vuelve más difícil y qué costo asumimos a sabiendas.

Escribir lo que empeora es lo que le da credibilidad al resto del documento.

Qué nos haría cambiarla

La señal concreta que indicaría que esta decisión dejó de servir.

Convierte una decisión en una hipótesis con condición de revisión, en lugar de un dogma.

Una página por decisión de tipo 1. Las de tipo 2 no llevan ADR: escribirlas cuesta más que deshacerlas.

En la práctica

Cierre

Autoevaluación

¿Lo entendiste?

¿Qué caracteriza a una decisión de tipo 1?
¿Cuál es la pista más útil para reconocer una puerta de ida?
Una decisión reversible se propagó a cincuenta archivos en dos semanas. ¿Qué pasó?
¿Qué sección hace realmente útil a un ADR años después?
¿Conviene escribir un ADR para cada decisión del equipo?