← Volver al blog
Aiaprox. 7 min de lectura

ub-mode, o cómo Uncle Bob obliga a un agente de código a demostrar que terminó

Publicado 15 nov 2026
ub-mode, o cómo Uncle Bob obliga a un agente de código a demostrar que terminó

Un archivo de skill con cuatro programas detrás

Cada semana otro repositorio publica una personalidad para tu agente de código. Un archivo markdown con un nombre, una voz y una lista de cosas que al modelo le deberían importar. Lo metes en una carpeta de skills, escribes un comando de barra y el agente empieza a redactar mensajes de commit como un ingeniero senior que ha visto cosas.

ub-mode tiene 7,989 estrellas en GitHub a 15 de noviembre de 2026, en unclebob/ub-mode. La instalación sigue el patrón al pie de la letra: copiar SKILL.md en ~/.claude/skills/ub-mode/SKILL.md, o el equivalente en Cursor, o el equivalente en Grok, y escribir /ub-mode. Tres fases. «First Make it Work» contiene Laziness Protocol, Foundational Thinking, TDD, Redesign From First Principles, Attack the Premise, Subtract Before You Add, Outcome-Oriented Execution, Build the Lever, y una sección de arquitectura sobre modelar el dominio, límites, disciplina de tipos, operaciones idempotentes y separar antes de serializar estado compartido. «Then Make it Right» contiene Fix Root Causes, Sequence Work into Verifiable Units, Test Behavior Not Implementation, Refactoring. «Practice» es un registro, higiene de la ventana de contexto, limpieza de worktrees, commits pequeños y ordenados.

Esa lista es lo que la gente citará en capturas de pantalla. La parte que vale la pena leer está dentro de «Then Make it Right»: cuatro programas de línea de comandos que el autor escribió para comprobar el trabajo del agente.

El problema de la frase

Pregúntale a un agente de código si ha terminado y obtendrás una frase. «Implementé el endpoint, añadí pruebas y la suite pasa.» Esa frase la generó el mismo proceso que escribió el código, así que no aporta información independiente. De ahí viene el slop. Tiene poco que ver con el carácter del modelo y mucho con el bucle en el que está metido. La definición de terminado del agente es una afirmación, y las afirmaciones son baratas de producir.

El skill sustituye la afirmación por números que el agente tiene que mover. Crapper calcula complejidad ciclomática, cobertura de pruebas y una puntuación CRAP por función, y la regla es que cada función se mantenga por debajo de CRAP < 10. Dryer busca duplicación estructural y exige eliminar los bloques con 0.8 de similitud o más. Mutator ejecuta pruebas de mutación: rompe el código a propósito y comprueba si las pruebas lo notan. UML-viewer dibuja componentes, cobertura, puntuaciones CRAP, puntuaciones de mutación y la dirección de las dependencias.

Tres de esos cuatro pueden tumbar una compilación. Con un párrafo se puede discutir. Con un código de salida cuesta más, sobre todo porque la réplica tiene que ser otro código.

Attack the Premise

De los nueve principios de la primera fase, dos se comportan distinto cuando quien lee es un modelo.

Attack the Premise es el que publicaría por separado. Los agentes son obedientes de una forma concreta y cara: implementan la petición tal como está escrita, con competencia, y nunca preguntan si esa petición debería existir. Diles que añadan una capa de caché y tendrás una capa de caché. Con pruebas, con commits en pasos pequeños, con un límite limpio. Nadie comprobó si el endpoint iba lento por el plan de consulta. El agente tampoco notará que el ticket es un parche para una decisión que alguien tomó hace dos años y que ya se fue.

Un revisor humano replica porque replicar es gratis y lleva el contexto alrededor en la cabeza. Un agente replica solo cuando una regla se lo pide, y eso convierte Attack the Premise en estructural. Su posición en la primera fase también importa, antes de que exista código, cuando cambiar la respuesta todavía es barato.

Sequence Work into Verifiable Units es el segundo, y en realidad va de memoria. Las sesiones largas se pudren. Una restricción del turno tres sigue en la ventana en el turno noventa, pero ya no pesa lo mismo, y el modelo empieza a romper con confianza una regla que fijaste hace una hora. Partir el trabajo en unidades con una comprobación al final de cada una te da un sitio donde parar y mirar, y da a las puertas algo que morder. Una puerta al final de un cambio de cuatro mil líneas te dice que el cambio es malo. Una puerta al final de cuarenta líneas te dice cuáles cuarenta.

Donde los números dejan de ayudar

Aquí es donde dejo de confiar.

CRAP < 10 salió de la revisión de código humana. Estaba ajustado para revisores con poca paciencia leyendo código de colegas. Un agente que optimiza para el umbral puede coger una función honesta de cuarenta líneas y partirla en cuatro funciones de doce líneas con nombres peores y la misma lógica. La complejidad por función baja, la cobertura aguanta, la puntuación cae, la compilación se pone verde. El código no mejoró nada. El número sí.

La duplicación falla por el otro lado. Dryer marca los bloques con 0.8 de similitud o más. Extrae un helper compartido que recibe nueve parámetros y una bandera de modo, y la similitud cae por debajo del umbral. Acabas con una función más difícil de leer que las dos que sustituyó, más una comprobación que pasa. La herramienta mide forma, y la forma se falsea fácil con formas peores.

Las pruebas de mutación son la puerta honesta y la cara. Ejecutan tu suite una vez por mutante, así que el tiempo real es el tiempo de la suite multiplicado por el número de mutaciones. Es tolerable en un portátil y doloroso dentro de un bucle donde un agente itera sobre una corrección. Mi conjetura, y es solo una conjetura, es que aquí es donde los agentes recortarán primero: saltarse mutator, o escribir pruebas que maten mutantes sin afirmar comportamiento. Una prueba que solo afirma que la función devuelve algo no nulo mata una cantidad sorprendente de mutantes sin comprobar nada que un usuario reconocería.

El ensayista que ahora entrega puertas

Hay un chiste dentro de este proyecto que el README no cuenta. Robert C. Martin lleva dos décadas siendo discutido, sobre todo por los consejos de estilo de Clean Code, por si esas reglas eran experiencia ganada a pulso o folclore con buen marketing. Ese mismo autor ahora publica las reglas como programas con umbrales y códigos de salida, y te pide que las instales en vez de leerlas.

Se lee como una concesión, y una justa. Un ensayo no se puede ejecutar. Puedes estar en desacuerdo con un capítulo durante años y no zanjarlo nunca. Puedes estar en desacuerdo con CRAP < 10 en una tarde, ejecutando la herramienta sobre tu propio repositorio y mirando qué quiere cambiar. Las discusiones de estilo terminan cuando alguien presenta un número, o al menos se vuelven más calladas y más concretas. El hombre famoso por su prosa sobre código ha decidido que la prosa era la parte débil.

Lo que las puertas no ven

Una limitación, dicha sin rodeos. Esto es un archivo de skill y cuatro herramientas de línea de comandos. Nada del conjunto verifica que un humano haya leído el diff. Las puertas inspeccionan el código que produjo el agente. No dicen nada sobre si alguien aceptó que ese código debía existir, ni sobre si el ticket merecía la pena. Attack the Premise, la regla que conservaría si solo pudiera conservar una, sigue siendo una frase en un archivo markdown, sin más enforcement que la voluntad del modelo de seguir instrucciones. El elemento más fuerte de toda la colección es el único sin un programa detrás, lo que dice algo sobre qué problemas son de verdad difíciles.

Antes de instalar, ejecuta crapper contra el repositorio al que piensas apuntar el agente. Si ya hay doscientas funciones por encima del umbral, la primera sesión será refactorización, no funcionalidades, y el agente gastará su presupuesto en código que nunca le pediste tocar. Mejor ver ese número tú mismo que dejar que el agente lo descubra por ti a las dos de la mañana.

Artículos relacionados