Por qué publicamos los registros reales de lo que hacemos
Capítulo 2: Por qué publicamos los registros reales de lo que hacemos
En el capítulo anterior mencioné brevemente la postura de este proyecto: publicar los registros reales de lo que vamos haciendo. Aquí quiero explicar eso con un poco más de detalle.
¿Por qué publicar? Esa es la pregunta.
Antes pensaba que los registros de trabajo eran algo que se guarda para uno mismo
Para ser honesto, yo también pensaba eso al principio. Que lo que está en proceso — los intentos, los errores, las decisiones equivocadas — era algo que se mantiene guardado.
No veía muchas razones para hacerlo público.
«Mejor publicar cuando ya funcione bien.» «Mostrar el proceso mientras todo falla no le sirve a nadie.»
Eso pensaba.
En particular, publicar los registros de errores de mi propio proyecto me parecía algo impensable. Creo que en el fondo asociaba error con vergüenza, de forma casi automática. Creía que lo normal en un blog técnico o en documentación era mostrar solo el resultado limpio y terminado.
Cuando lo publiqué, sentí un alivio inesperado
El cambio llegó cuando un día decidí: «bueno, a ver qué pasa si lo publico».
No hubo ningún motivo especial. Nadie me lo aconsejó. Simplemente llegué a la conclusión, de forma bastante pasiva, de que ocultarlo parecía más complicado que mostrarlo.
Empecé a escribir los registros de implementación — incluyendo cómo llegué a los errores — y los publiqué tal cual.
Y pasó algo curioso: el tiempo de escritura aumentó, pero las decisiones se volvieron más rápidas.
La razón es sencilla: al escribir, te ves obligado a ordenar el pensamiento detrás de cada decisión. Cuando intentas poner en palabras «¿por qué elegí esto?», las partes borrosas de tu razonamiento salen a la superficie. A veces descubres que una decisión no tenía base sólida. Otras veces recuerdas que ya habías cometido ese mismo error antes.
Cuando escribes pensando que lo vas a publicar, el efecto se multiplica. Si el texto lo va a leer alguien más, intentas que tenga sentido de verdad. Y eso, al final, termina ordenando tu propio pensamiento.
Lo que ocurre cuando «hay otra mirada»
Hay algo más que noté: el simple hecho de estar publicado tiene un efecto en sí mismo.
No hablo de recibir comentarios ni de que algo se vuelva viral en redes sociales. Me refiero a algo distinto: el hecho de estar en un estado donde alguien podría ver el trabajo actúa como un filtro de calidad involuntario.
Por ejemplo: cuando estoy a punto de escribir una decisión tomada sin mucho rigor, en algún momento del proceso me detengo y pienso: «¿esto está bien para que alguien lo lea?». Ese freno hace que lo reconsidere. A veces eso mejora la decisión. Otras veces simplemente añado una aclaración.
En otras palabras: solo por haber decidido publicar, me vuelvo más cuidadoso sin darme cuenta.
Esto mismo ocurre en el desarrollo con IA. La estructura que en capítulos posteriores llamaré «separación de poderes» (aquí: distribuir ejecución, auditoría y aprobación entre agentes distintos) parte de una idea similar. «Incorporar la mirada del otro de forma estructural» funciona — ya sea con personas o con IAs.
Por eso incluyo también los registros de errores
Por todo eso, en este proyecto decidí publicar no solo lo que salió bien, sino también los registros de errores.
Las razones son tres:
- Para ordenar el pensamiento: escribir y publicar aclara cómo razoné cada decisión.
- Por el efecto de «otra mirada»: escribir con la intención de publicar me hace más cuidadoso de forma involuntaria.
- Para que sirva de referencia a quienes quieran intentar algo similar: los registros de errores son más reproducibles, y generalmente son la información que uno más busca cuando algo no funciona.
Sobre el tercer punto: los artículos técnicos suelen mostrar solo «cómo se hace cuando sale bien». Pero en la práctica, los errores que uno se encuentra son más frecuentes y más fáciles de repetir. Y cuando algo falla, lo que uno realmente necesita es información sobre cómo resolverlo.
Por eso quiero dejar el flujo de error → corrección → aprendizaje lo más intacto posible.
Seguramente voy a seguir cometiendo errores. Las decisiones equivocadas que tome a partir de ahora, las correcciones de rumbo, todo eso lo voy a registrar con calma, como parte del proceso.
Esa es la intención detrás de la postura de «publicar los registros reales de lo que hacemos».