El kit de diseño guiado por hipótesis

Un formulario, una verificación y un registro para escribir lo que esperas antes de construir, y un previsor de lo que costará, sacados de cómo trabaja TerraQuotes desde su primer issue

Mi papel

Diseñador y desarrollador

Empresa
Good Citizens
Método usado en
TerraQuotes, desde su primer issue
Años
De marzo de 2025 a hoy
Equipo
Único desarrollador
  1. Convertí el método en una plantilla de repositorio de GitHub: formularios de Predicción, Observación y Decisión, una verificación que no deja fusionar un pull request sin una predicción, y una traza que se reconstruye a partir de los enlaces.
  2. Añadí una skill de agente que convierte briefs, PRD y presentaciones en predicciones que se pueden refutar.
  3. Apliqué el método en TerraQuotes desde su primer issue, el 9 de marzo de 2025, y en enero de 2026 añadí un archivo de historial de diseño, tomado de los controles de diseño de dispositivos médicos.
  4. Construí el previsor de esfuerzo del kit y lo sometí a sus propias predicciones, PRE-004 y PRE-005.
  • 340 previsiones de costo de desarrollo en el registro de TerraQuotes cuando se leyó el 29 de octubre de 2026; 146 tienen un costo real con el que contrastarlas
  • 82% de los costos reales dentro del rango del 80% del previsor del kit, en una prueba retrospectiva hacia adelante sobre 131 de esos issues
  • 167 registros del historial de diseño de TerraQuotes, al 17 de octubre de 2026
  • 9 de 40 predicciones del registro de TerraQuotes se pueden medir por completo desde su almacén de datos; 16 solo en parte, y 15 con CI y código

Resumen

Antes de construir algo, escribo lo que espero que haga, el número que lo va a resolver y el resultado que demostraría que me equivoqué. El kit de diseño guiado por hipótesis hace que ese hábito sea difícil de saltarse: tres formularios de issues de GitHub, una verificación que no deja fusionar un pull request sin una predicción, y un registro que vincula cada predicción con lo que se decidió.

El primer epic de TerraQuotes, en marzo de 2025, escribió lo que esperaba y la medida que lo resolvería, y la mayoría de sus epics desde entonces han hecho lo mismo. Desde septiembre de 2026, TerraQuotes también prevé cuánto costará desarrollar la mayoría de sus issues, y el previsor propio del kit se construyó y se puso a prueba con ese registro.

Quiénes participaron

  • Equipos de producto y diseño Para quién es la plantilla: equipos que quieren decidir qué contará como que funciona antes de lanzarlo.
  • TerraQuotes El primer producto que trabajó así, desde su primer epic hasta los issues que trabaja hoy.
Leer el expediente . 4 secciones, unos 2 min

Contexto

Primero vino el método: el primer epic de TerraQuotes, en marzo de 2025, escribió lo que esperaba, y la mayoría de sus epics desde entonces han hecho lo mismo. El kit empezó en febrero de 2026 como una plantilla de repositorio de GitHub: formularios de issues y una verificación que no deja fusionar un pull request sin una predicción. En marzo de 2026 incorporó una skill de agente que convierte briefs, PRD y presentaciones en predicciones. En octubre de 2026 sus formularios de issues se redujeron a tres, y su traza se reconstruyó a partir de los enlaces. El previsor llegó después, como un script.

TerraQuotes mantiene un archivo de historial de diseño desde enero de 2026: 167 registros al 17 de octubre de 2026. Los registros con fecha anterior al 11 de enero de 2026 se escribieron después a partir del historial de git; los registros de cambios así lo indican.

Por qué la mayoría de las predicciones siguen abiertas

Escribir una predicción es rápido. Resolverla requiere datos que llegan a su propio ritmo. El registro de TerraQuotes tiene 40 predicciones; al 31 de marzo de 2026, su tabla cuenta 9 que se pueden medir por completo desde el almacén de datos, 16 solo en parte, y 15 que necesitan pruebas de CI o del código. Las predicciones sobre precios y conversión solo se resuelven a medida que se cierran trabajos reales, ganados o perdidos. TerraQuotes está en marcha con un operador piloto, Quiet Village Landscaping, pero esos resultados llegan despacio, y una oferta perdida solo llega al registro cuando el software de ventas del contratista la envía. Esas predicciones siguen abiertas, y el registro lo dice.

Prever el trabajo

Desde septiembre de 2026, TerraQuotes ha previsto el costo de desarrollo de la mayoría de los issues que trabajó: 340 previsiones en su registro cuando se leyó el 29 de octubre, 146 de ellas sobre issues cuyo costo real ya se conoce. El previsor del kit obtiene un rango a partir de tus propios desvíos pasados, y una prueba retrospectiva dice si puedes confiar en él. Aplicado hacia adelante en el tiempo sobre esos issues, cada uno previsto solo con los issues terminados antes que él, su rango del 80% contuvo el 82% de los costos reales en 131.

PRE-004 esperaba rangos la mitad de anchos que los del estimador propio de TerraQuotes, y previsiones por lotes que se cumplieran. Su observación no encontró ninguna de las dos cosas: los desvíos llegan en rachas, así que no se ofrecen lotes. PRE-005 se registró después de que una simulación mostrara rangos que se quedaban cortos con solo 10 a 30 elementos terminados, y antes de que la corrección se aplicara al registro de TerraQuotes. Todavía no se ha registrado ninguna de las dos decisiones.

Una columna por cada issue de TerraQuotes, en el orden en que se estimaron, del 8 de septiembre al 26 de octubre de 2026: 131 issues que tenían al menos diez terminados el día anterior a su estimación. Cada columna es el rango del 80% que el previsor del kit habría dado a ese issue, usando solo issues terminados antes de estimarlo, dibujado como proporción de la estimación del propio issue en escala logarítmica, de una décima a diez veces. Un punto marca lo que el issue costó de verdad. 107 de los 131 caen dentro de su rango, el 82%. Los 24 que quedan fuera llegan en rachas. Dos caen por encima de su rango el 9 y el 10 de septiembre, nueve por debajo el 11 y el 12 de septiembre, doce por encima del 13 al 21 de septiembre, y uno por debajo el 30 de septiembre. Después de eso, ninguno cae fuera.
107 de 131 dentro. El rango de cada issue se obtuvo de los issues terminados antes que él, y luego se contrastó con lo que costó. Los desvíos llegan en rachas, y por eso no se ofrecen previsiones por lotes.

Lo que me enseñó

Escribir una predicción nunca fue lo difícil. Lo difícil es estar en condiciones de resolverla. Los costos de desarrollo se registran cada vez que se entrega un issue, así que el previsor pudo contrastarse con el registro de TerraQuotes el mismo día en que se escribió. Las predicciones de precios solo se resuelven cuando se cierran trabajos reales, así que no se han movido. Dejar por escrito las que siguen esperando evita que se olviden en silencio, o que se cierren en silencio.