Guardrails
Comprobaciones automáticas de que mi trabajo de diseño se construyó bien y hace lo que debía hacer
Mi papel
Diseñador e ingeniero
- Objeto
- El proceso de entrega de este sitio
- Desde
- 27 de septiembre de 2026, el primer pull request fusionado
- Evidencia
- El repositorio: registros, pull requests, etiquetas
- Al
- 23 de octubre de 2026
- Diseñé las salvaguardas: plantillas de issues con los issues en blanco desactivados, un prerregistro obligatorio antes de un EPIC y una verificación que reprueba un pull request de funcionalidad que no lo tenga.
- Fijé de antemano cuatro formas en que el estudio fracasaría, antes de cualquier parte del trabajo que mide.
- Escribí 15 registros en el historial de entregas, cada uno con una métrica, un umbral y un resultado nulo, antes del cambio que predice.
- Cerré registros midiéndolos con sus propias reglas, incluidos los que resultaron nulos.
- 15 registros en el historial de entregas, cada uno escrito antes de su cambio
- 3 de 4 registros cerrados que resultaron nulos según sus propias reglas, y 1 dividido
- 0 issues abiertos en total: nadie usó el camino de plantillas en torno al cual se construyó el estudio
- 78 de 111 pull requests fusionados que llevaron la etiqueta que los exime de registrarse
Resumen
Los estudios prerregistrados de este sitio descansan en un solo método: anotar la predicción antes del cambio y luego juzgar el cambio con ella. Este aplica el método al trabajo que produce el sitio. No hay participantes; el objeto de estudio es el proceso de entrega, y la evidencia es el propio repositorio. La premisa es que un método que solo confirma sus predicciones no mide nada, así que la prueba es si estas salvaguardas producen sorpresas.
Al 23 de octubre de 2026, el sitio tenía 15 registros en su historial de entregas y 111 pull requests fusionados. Se han cerrado 4 registros evaluándolos: 3 resultaron nulos según sus propias reglas y 1 se dividió, con respaldo en una página y nulo en otra. Sin embargo, la fricción pensada para proteger el método se desplazó. Nadie usó las plantillas de issues en torno a las cuales se construyó el estudio, y la etiqueta que exime a un pull request de registrarse se puso en 78 de los 111.
Quiénes participaron
- Yo El diseñador, el ingeniero y el objeto del estudio.
- Agentes Los agentes de IA que escribieron buena parte del código y corrieron las revisiones, sujetos a los mismos registros y verificaciones.
Leer el expediente .
Dónde empezó
La disciplina de proceso suele deteriorarse bajo la presión de las fechas límite. El prerregistro es el tipo de práctica que se salta cuando un lanzamiento está cerca, y saltárselo no deja rastro; nadie anota la hipótesis que decidió no escribir. Peor aún, una metodología que solo confirma sus predicciones no se distingue de una que no mide nada. El problema de diseño era hacer que el camino disciplinado fuera el más fácil, y definir de antemano cómo se vería el fracaso.
Las salvaguardas como diseño del comportamiento
La intervención fue diseño del comportamiento aplicado al proceso en lugar de al producto, construido en plantillas de issues de GitHub. Fricción: los issues en blanco estaban desactivados, así que la estructura no se podía saltar. Dispositivos de compromiso: un EPIC no se podía abrir sin un prerregistro vinculado, lo que fijaría la hipótesis antes de que existiera la intervención. Valores predeterminados: las casillas INVEST venían marcadas de antemano para empujar a completarlas. Funciones forzadas: los campos obligatorios bloquearían el envío sin una declaración JTBD y sin criterios de aceptación. Trazabilidad: cada artefacto se vincularía con su EPIC padre y con el prerregistro que pone a prueba. Límites de tiempo: los SPIKE recibirían un límite de tiempo explícito, y los SLICE tenían un tope de ocho horas para evitar que el alcance creciera sin control. Nunca se abrió ningún issue, así que ninguna de estas plantillas llegó a usarse.
Las cuatro formas en que fracasa, contrastadas con el historial
El estudio fijó cuatro condiciones de fracaso antes del trabajo que mide. Aquí está cada una frente al repositorio al 23 de octubre de 2026.
Que todos los registros se confirmaran, lo que significaría que las predicciones eran demasiado seguras. No ha pasado. De los 4 cerrados, tres resultaron nulos según sus propias reglas: prerrenderizar las páginas de los estudios no movió su mayor pintura sobre HTTP/2, incrustar la hoja de estilos de los estudios bajó la puntuación en cada página que tocó, y una pasada de rendimiento dejó la página de TerraQuotes por debajo del límite que nombraba. El cuarto se dividió: con respaldo en la página del estudio y nulo en la página de inicio.
Que más del 20% de los EPIC salieran sin registro. Esta no se puede probar tal como está escrita, porque nunca se abrió un EPIC: el repositorio no tiene ni un solo issue. El trabajo pasó por pull requests. De los 29 pull requests de funcionalidad fusionados, 15 citan un registro; 14 no, y 13 de esos son de un solo día de pasadas de diseño, el 30 de septiembre.
Que ninguna entrada del registro de decisiones citara un hallazgo inesperado. Los resultados nulos cambiaron lo que pasó después: se abandonó la incrustación de la hoja de estilos, y el resultado del prerrenderizado llevó el trabajo hacia los encabezados que le dicen al navegador qué descargar, que es donde quedaron registradas las decisiones.
Que aparecieran issues en blanco, lo que significaría que alguien encontró cómo esquivar la fricción. Nunca aparecieron issues en blanco, pero sí se encontró cómo esquivarla: la etiqueta que exime a un pull request de registrarse se puso en 78 de 111. La mayoría son ediciones de contenido que no afirman nada, que es para lo que existe la etiqueta; también es el camino más fácil, y nada verifica que un pull request etiquetado de verdad no afirme nada.
Resultados
El método está enseñando: tres de cuatro predicciones cerradas fallaron de maneras que cambiaron la siguiente decisión, que es la sorpresa que buscaba el estudio. Las salvaguardas no se sostienen donde se construyeron. Nadie usó las plantillas de issues, la etiqueta de exención se volvió el camino común, y 11 de 15 registros siguen esperando a cerrarse mediante evaluación. Un registro cerrado por medición es el estándar que fijan las notas de entrega; la mayoría de estos todavía no lo cumple.
La evidencia se sigue acumulando con cada pull request, y los registros que el sitio añadió el 23 de octubre nombran la comparación de profundidad de lectura que los cerrará cuatro semanas después del despliegue.
Qué cambiaría
Poner la fricción donde va el trabajo. Una verificación en el pull request que le pida a un cambio etiquetado decir en una línea por qué no afirma nada, y una lista semanal de los registros que siguen abiertos después de su fecha de evaluación, protegerían el camino que de verdad uso en lugar del que diseñé.