Qué es tener dirección técnica
Un equipo sin dirección técnica no se nota por las decisiones que toma, sino por las que vuelve a discutir cada dos meses. Dar dirección no es elegir tecnologías: es fijar los criterios con los que el equipo va a elegir sin vos.
La señal más clara de que a un equipo le falta dirección técnica no es que haya tomado decisiones malas. Es que la misma discusión vuelve cada dos meses, con la misma gente y sin que nadie recuerde por qué se resolvió lo que se resolvió la vez anterior.
Dar dirección no significa elegir vos las tecnologías. Significa que dentro de seis meses, en una decisión donde no estés, el equipo pueda contestar sin adivinar: ¿qué estamos tratando de lograr acá y qué estamos dispuestos a resignar?
Tres cosas que se confunden
| Qué es | Cuánto dura | Quién lo escribe | |
|---|---|---|---|
| Dirección técnica | Hacia dónde va el sistema y qué criterios ordenan las decisiones | Uno o dos años; cambia con el negocio | Se propone desde el equipo y se acuerda con producto |
| Roadmap técnico | Qué se va a hacer en el período para avanzar hacia eso | Un trimestre | El tech lead, con el equipo |
| Decisiones de arquitectura | Cómo se resuelve un problema puntual dentro de esos criterios | Lo que dure el componente | Quien está más cerca del problema |
La dirección es lo que hace que el roadmap no sea una lista arbitraria y que las decisiones de arquitectura no se resuelvan por preferencia. Si tenés que justificar cada decisión desde cero, lo que falta está dos niveles más arriba.
De dónde sale la dirección
No sale de leer sobre arquitectura. Sale de tres fuentes, en este orden:
Las tres entradas
- Hacia dónde va el negocio en los próximos dos años. Más clientes del mismo tipo, o clientes más grandes, o otro mercado, o vender la empresa. Cada uno pide un sistema distinto, y no es lo mismo prepararse para diez veces el volumen que para diez veces la complejidad de cada cliente.
- Qué duele hoy, medido. Los tres problemas que más tiempo consumen, con números. Es lo que evita que la dirección sea una fantasía desconectada del presente.
- Qué sabe y qué puede sostener el equipo. Una arquitectura que el equipo no puede operar no es una arquitectura, es un plan para contratar gente que todavía no está.
Antes de seguir, predecí
Cómo se escribe
Una dirección técnica que ocupa diez páginas no la va a usar nadie. La versión que sirve entra en una página y se puede recitar.
Plantilla
Dirección técnica del equipo
A qué apunta el negocio
Una o dos frases sobre hacia dónde va la empresa en los próximos dos años, con las palabras de la empresa.
Si no se puede escribir, es la primera conversación que hay que tener, y no es una conversación técnica.
Qué tipo de sistema necesitamos para eso
La consecuencia técnica de lo anterior. Por ejemplo: un sistema donde agregar un cliente nuevo no requiera tocar código, y donde una configuración mala afecte a un cliente y no a todos.
Es el puente. Sin esta línea, los criterios de abajo parecen preferencias.
Tres criterios que ordenan nuestras decisiones
Formulados de modo que se pueda decidir con ellos. Por ejemplo: preferimos aburrido y conocido antes que nuevo y mejor; preferimos configuración a código; preferimos un componente que se pueda borrar entero a uno que se pueda extender.
Tres, y que se puedan aplicar sin vos. Un criterio con el que todos están de acuerdo y nadie puede usar para descartar algo, no es un criterio.
Qué estamos dispuestos a resignar
Lo que aceptamos que va a estar peor por sostener lo anterior. Por ejemplo: vamos a ser más lentos en funcionalidades a medida para un cliente puntual.
La sección que le da credibilidad al documento y la que vuelve discutible la dirección, que es lo que se busca.
Cómo sabemos que va bien
Dos o tres señales observables dentro de seis meses.
Señales, no metas numéricas: el objetivo es poder darse cuenta de que la dirección se equivocó.
Sostenerla es el trabajo real
Escribir la dirección es un día. Sostenerla es todos los demás, y se hace en lugares poco épicos:
- En las revisiones de código, cuando un comentario dice «esto va contra el criterio de preferir configuración a código» en vez de «yo lo haría distinto».
- En la planificación, cuando algo se descarta y se explica con cuál criterio.
- En las excepciones, que son inevitables: se hacen explícitas y con fecha, no en silencio.
- En la revisión periódica, cuando el negocio cambió y la dirección tiene que cambiar con él, en voz alta y no por deriva.
Más a fondo · nivel seniorCuándo la dirección tiene que cambiar, y cómo se anuncia
Una dirección técnica que nunca cambia en dos años no es firmeza: casi siempre significa que dejó de mirarse. Las tres señales de que hay que revisarla: el negocio cambió de apuesta, la escala cambió de orden de magnitud, o las excepciones empezaron a ser más que los casos que siguen la regla.
Ese último es el más interesante. Si el equipo pide excepción en la mitad de los casos, la dirección está describiendo un sistema que nadie está construyendo. Y cuando cambia, conviene anunciarlo con la misma claridad con la que se anunció: qué cambió afuera, qué criterio se reemplaza y qué pasa con lo que ya se construyó siguiendo el anterior. Una dirección que muta sin aviso le enseña al equipo que los criterios son decorativos y que conviene esperar a ver qué opina el líder en cada caso, que es exactamente lo contrario de lo que se buscaba.
Lo que preguntan sobre esto
Cierre
Autoevaluación
¿Lo entendiste?
Práctica