Vol. I · MMXXVI · Publicación de AXXA
Bitácora del Gañán
Crónicas de supervivencia en el desarrollo de software.
Esta bitácora reúne observaciones de campo sobre una especie tan extendida como resistente: la decisión de ingeniería que parecía buena idea a las 18:47 de un viernes.
Cada entrada documenta un espécimen concreto —un antipatrón, una implementación inexplicable, un ritual de equipo— con la misma frialdad con la que un naturalista describe un escarabajo: dónde se encontró, qué daños produce y cómo evitar que se reproduzca.
- Volumen
- I · Primera edición digital · 19 de noviembre de 2026
- Entradas
- 10 documentadas
- Categorías
- 10 · 8 con especímenes
- Último hallazgo
- Nº 010
Nota preliminar
Advertencia al lector
Durante años, los hallazgos que aquí se recogen se transmitieron por tradición oral: en revisiones de código, en retrospectivas que se alargaban y en conversaciones de pasillo que empezaban con «no te vas a creer lo que he encontrado». Este volumen intenta darles una forma más duradera.
El método es sencillo. Cada espécimen recibe un número permanente, una categoría y un grado de gravedad. Se describe el hallazgo, el contexto en el que apareció y las consecuencias observadas, y se cierra con la recomendación de la academia: la práctica de ingeniería que habría evitado el desastre.
El tono es burlón; el contenido, no. Todo lo que aquí se describe compila, se despliega y falla exactamente como se cuenta. Si el lector se reconoce en alguna entrada, no debe preocuparse: los autores se reconocen en casi todas.
Los casos descritos son composiciones ficticias construidas a partir de antipatrones ampliamente conocidos en la industria. No describen a ninguna persona, empresa ni proyecto real. Cualquier parecido con su repositorio es pura estadística.
Índice
Índice por categorías
- I
Arquitectura criminal
2 entradasDecisiones estructurales que convierten un sistema en una escena del crimen: dependencias circulares, responsabilidades fusionadas y componentes que saben demasiado.
- II
Código arqueológico
2 entradasEstratos de código, comentarios y notas que sobreviven a sus autores, a sus razones y, con frecuencia, a la verdad.
- III
Ingeniería de Schrödinger
1 entradaSistemas que funcionan y fallan a la vez hasta que alguien abre la caja. Errores ocultos, estados indeterminados y éxitos no verificados.
- IV
DevOps del terror
1 entradaPipelines, despliegues y configuraciones de compilación diseñados para que el problema llegue a producción sin que nadie lo moleste por el camino.
- V
Testing ornamental
1 entradaPruebas que existen para decorar el informe de cobertura. Pasan siempre, verifican poco y no protegen nada.
- VI
Gestión de la incompetencia
0 entradasProcesos, estimaciones y rituales organizativos que garantizan que las malas decisiones técnicas se tomen a tiempo y con acta.
Sin especímenes documentados todavía.
- VII
Abstracciones innecesarias
1 entradaCapas, fábricas e interfaces que resuelven problemas que nadie tenía, a cambio de crear varios que ahora tiene todo el mundo.
- VIII
Seguridad creativa
1 entradaInterpretaciones originales de la confidencialidad, la integridad y el aislamiento entre usuarios.
- IX
Git y otras tragedias
1 entradaCommits, ramas y empujones forzados que reescriben la historia del repositorio y, ocasionalmente, la de la empresa.
- X
Optimización prematura
0 entradasMicrosegundos ganados en el sitio equivocado, pagados con semanas de mantenimiento en el sitio correcto.
Sin especímenes documentados todavía.
Selección de la redacción
Piezas de colección
Nº 001 · Código arqueológico
El comentario que lleva tres años mintiendo
Un comentario afirma con total serenidad que una función hace una cosa. La función lleva tres versiones haciendo exactamente la contraria, y todo el equipo lo sabe salvo quien acaba de llegar.
III — Grave
Nº 004 · Ingeniería de Schrödinger
El catch que se traga hasta las ganas de vivir
Un proceso nocturno de sincronización de pagos terminó con éxito cada noche durante siete meses. No sincronizó ni un solo pago. Un «except» desnudo se encargó de que nadie se enterara.
IV — Extremo
Nº 005 · Abstracciones innecesarias
El Singleton que terminó siendo una religión
Empezó como un modesto lector de configuración con una única instancia. Hoy tiene 212 métodos, un registro de singletons, una fábrica abstracta de singletons y un orden de arranque que se transmite de forma oral.
IV — Extremo
Nº 010 · Git y otras tragedias
El commit que nunca debió abandonar el ordenador de su creador
Un viernes a las 18:52, un único commit titulado «cambios» subió a la rama principal credenciales de producción, un volcado de 3,2 GB de la base de datos de clientes y 48 213 archivos de node_modules. Después llegó el push forzado.
V — Patrimonio histórico de la gañanería
Registro
Últimos hallazgos
Nº 010
El commit que nunca debió abandonar el ordenador de su creador
Un viernes a las 18:52, un único commit titulado «cambios» subió a la rama principal credenciales de producción, un volcado de 3,2 GB de la base de datos de clientes y 48 213 archivos de node_modules. Después llegó el push forzado.
Git y otras tragediasGravedad V — Patrimonio histórico de la gañaneríaNº 009
La variable global que conoce hasta tu vida privada
En local, con un solo usuario, funcionaba perfectamente. En producción, una variable de módulo llamada «usuarioActual» repartía las facturas de unos clientes entre otros, de forma intermitente y solo con carga.
Seguridad creativaGravedad IV — ExtremoNº 008
El parámetro booleano de los siete significados
Se llamaba «rapido» y empezó significando «sin gráficos». Siete años después significa siete cosas distintas según el formato, el día de la semana y quién llame, incluida una que se salta la comprobación de permisos.
Arquitectura criminalGravedad II — ModeradoNº 007
El desarrollador que soluciona los warnings desactivándolos
«Arreglados 347 warnings», anunciaba el mensaje del commit. El cambio consistía en una línea del Makefile que añadía «-w». Uno de los 347 avisaba de un comportamiento indefinido en la lectura de un sensor.
DevOps del terrorGravedad III — GraveNº 006
El test unitario que no prueba absolutamente nada
Una suite de 2 300 tests con un 94 % de cobertura de líneas aprobó sin pestañear un error de redondeo en todas las facturas. Varios de sus tests verificaban, con gran precisión, que Mockito funciona.
Testing ornamentalGravedad III — Grave