Dirigir una máquina unipersonal con agentes de IA, día a día
por Mat Siems
PARTES I–X · CAPÍTULOS 1–100 · MATSIEMS.COM
Parte I
La silla del operador
Qué es el oficio cuando los agentes teclean.
Capítulo 1 · Parte I
Una persona, muchas manos
Este es un manual para un tipo particular de trabajador: una sola persona, sin plantilla, y una flota de agentes de IA que harán alegremente casi cualquier cosa que les pidas, a cualquier hora y en paralelo. Puede que seas autónomo, fundador sin cofundador, consultor, escritor con un repositorio de código o, sencillamente, alguien que ha notado que la cantidad de cosas que puede hacer en un día ya no depende de lo rápido que teclea. Te guste o no la palabra, eres un operador.
La palabra importa porque nombra el oficio con honestidad. No eres un jefe, porque nadie a tu cargo puede responsabilizarse de nada. Tampoco eres ya del todo un artesano, porque casi todo lo que se fabrica lo fabrica otra cosa. Diriges una máquina pequeña. La máquina está hecha de agentes, herramientas, notas, una lista de proyectos y, sobre todo, tu propia jornada de trabajo. Cuando la máquina funciona bien, una sola persona entrega lo que produciría un equipo pequeño. Cuando funciona mal, una sola persona se pasa el día supervisando el caos y se acuesta sin haber terminado nada.
Lo que separa ambos casos rara vez son las herramientas. Hoy todo el mundo tiene más o menos los mismos agentes. La diferencia está en el sistema operativo: los hábitos que deciden qué se empieza, cómo se describe, cómo se comprueba, cuándo se entrega y qué se anota después. De esos hábitos trata este libro. No es un libro de negocios. No te dirá qué vender ni a qué precio. Trata del interior de la jornada de una persona, y de cómo conseguir que esa jornada produzca cosas terminadas en lugar de una sensación de ajetreo.
Los agentes ponen las manos. Tú pones el orden en que se mueven.
El libro tiene diez partes. Empieza por el oficio en sí y recorre después la jornada operativa, la redacción de encargos, la memoria y las notas, el registro de proyectos y la delegación de hilos, la revisión del trabajo, la disciplina de las entregas, los ciclos semanales y trimestrales, el mantenimiento de las herramientas y la gestión de los errores. Termina donde todo apunta: el verdadero trabajo del operador es decidir, no hacer. Cada capítulo enseña una cosa que puedes probar esta misma semana. Ninguno exige software nuevo. Casi todos exigen un archivo de texto y un poco de temple.
Una palabra sobre el tono. Esto está escrito para gente que ya está algo cansada de que le digan que todo ha cambiado. Mucho ha cambiado. Mucho no. Seguimos necesitando saber qué intentamos conseguir, seguimos necesitando comprobar si lo hemos conseguido y seguimos necesitando dejar de trabajar en algún momento para cenar. Los agentes hacen que las dos primeras cosas importen más, no menos, y hacen que la tercera sea más difícil de recordar.
Así que empieza aquí, con un pequeño ejercicio. Escribe, en una frase cada una, las tres cosas que tus agentes hicieron por ti la semana pasada y que tú no habrías hecho. Después escribe la única cosa que hiciste tú y que ningún agente habría podido hacer. La segunda lista es más corta. También es tu trabajo.
Fig. 1 · Una persona, muchas manos. Cinco hábitos rodean al operador, que fija su orden mientras agentes y herramientas trabajan.
Capítulo 2 · Parte I
La jornada es la máquina
Casi todos los que trabajan con agentes piensan en su sistema como un conjunto de herramientas: este asistente, aquella terminal, estos conectores, esos scripts. Las herramientas importan, pero no son la máquina. La máquina es tu jornada de trabajo. Es el orden en que ocurren las cosas entre que te despiertas y paras, y es lo que determina hacia dónde apuntan las herramientas. Dos operadores con herramientas idénticas y jornadas distintas tendrán semanas radicalmente distintas.
Piensa en la jornada como algo de tres partes. Por la mañana revisas: lees lo que pasó mientras no estabas, decides qué importa ahora y eliges un número pequeño de resultados para el día. En el centro llevas a cabo sesiones: tramos acotados de tiempo en los que haces encargos a los agentes, observas su trabajo, revisas lo que vuelve y o bien lo entregas o bien lo devuelves para otra vuelta. Al final cierras: anotas qué se terminó, qué no y por dónde debe empezar mañana, y luego paras. Revisión, sesiones, cierre. Todo lo demás en la jornada operativa es una variación de ese arco.
Parece obvio, y lo es, y por eso casi nadie lo hace. La jornada por defecto de un operador con agentes es reactiva. Abres el portátil, ves que ha terminado una tarea en segundo plano, la lees, arreglas algo pequeño, abres un hilo nuevo porque se te ha ocurrido una idea, contestas un mensaje, miras otro hilo y, cuando levantas la vista, son las cuatro de la tarde y has tocado once cosas sin terminar ninguna. Los agentes lo empeoran, porque cada uno genera más material que mirar. La máquina sin forma se convierte en una máquina de generar notificaciones.
Una jornada sin forma la moldea lo que grita más fuerte.
El remedio es tratar la forma del día como una decisión de diseño y no como un accidente. Decide cuándo se hace la revisión y cuánto dura. Decide cuántas sesiones caben en el día y, más o menos, de qué tamaño. Decide cuándo llega el cierre y qué produce. Anótalo donde lo vayas a ver. Al principio estará mal y lo irás ajustando, pero un plan equivocado que puedes ajustar es mejor que ningún plan, porque sin plan no hay nada que ajustar.
Ayuda darse cuenta de que los agentes no se cansan y tú sí. La máquina puede funcionar toda la noche; el operador, no. Así que la jornada es la parte del sistema que tiene límites duros, y los límites duros son justo donde el diseño rinde. Quien diseña una base de datos se preocupa por la consulta más lenta. Un operador debería preocuparse por la hora más escasa, que suele ser la primera hora buena de la mañana, y debería gastarla en decidir y no en trastear.
Pruébalo esta semana. Durante cinco días laborables, apunta tres horas en una tarjeta: cuándo terminó la revisión, cuándo terminó la última sesión y cuándo cerraste. No intentes mejorar nada. Solo mira. La mayoría descubre que el cierre no ocurre nunca y que la revisión se funde sin hacer ruido con la primera sesión. No es un fallo moral. Es una máquina a la que le falta una pieza. Ponle la pieza.
Fig. 2 · La jornada es la máquina. Un día diseñado de revisión, sesiones y cierre junto a un día reactivo que no termina nada.
Capítulo 3 · Parte I
Hacer frente a decidir
Durante casi toda la historia del trabajo, hacer y decidir venían en el mismo paquete. Si querías un informe, decidías qué debía decir y luego lo escribías, y escribir llevaba tanto tiempo que parecía el trabajo de verdad. La decisión se escondía dentro del hacer. Elegías la estructura mientras redactabas el primer párrafo, cambiabas de opinión sobre la conclusión a medio camino, y el informe terminado era el registro de todas esas pequeñas decisiones.
Los agentes desempaquetan las dos cosas. El hacer, que antes llevaba horas, ahora lleva minutos y puede ocurrir sin ti. El decidir no encoge en absoluto. Si acaso crece, porque el agente hará exactamente lo que decidiste, y si decidiste con vaguedad obtendrás un resultado vago a toda velocidad. La jornada del operador, por tanto, se inclina. Dedica menos tiempo a fabricar cosas. Dedica más a elegir qué fabricar, a describirlo con precisión, a juzgar lo que vuelve y a volver a elegir.
Esto incomoda a cualquiera cuya identidad se construyó sobre el hacer. Fabricar cosas satisface de un modo en que decidir rara vez lo hace. Puedes señalar una página que escribiste o una funcionalidad que construiste. Es más difícil señalar una buena decisión, porque las buenas decisiones casi siempre parecen que no ha pasado nada: un proyecto que no se empezó, una funcionalidad que no se añadió, una mala pull request que no se fusionó. La tentación, cuando los agentes se llevan el hacer, es recuperar un poco por puro consuelo: reescribir con tus palabras el borrador del agente cuando el borrador estaba bien, o arreglar el fallo tú mismo porque esperar parecía estar de brazos cruzados.
Resiste la tentación, pero sin dogmatismo. Hay una prueba sencilla para cualquier trabajo que tengas delante: ¿tengo que hacerlo yo, precisamente yo? Algunas cosas sí. Una conversación con alguien que confía en ti. Un juicio de calidad que solo tú puedes emitir. Un texto cuyo único valor es que es tuyo. Todo lo demás es candidato a delegarse, y la pregunta pasa a ser cómo encargarlo bien, no si hacerlo tú.
Hacer parece progreso. Decidir es progreso.
Fíjate también en que decidir no es lo mismo que darle vueltas a las cosas. Hay operadores que pierden mañanas enteras en deliberaciones que nunca aterrizan. Una decisión es una frase con un verbo dentro: entregaremos la versión pequeña el jueves; quitaremos la segunda funcionalidad; reescribiremos el encargo y lo volveremos a lanzar. Si tu reflexión no termina en una frase así, no estabas decidiendo. Estabas hablando del tiempo.
Así que esta semana lleva la cuenta. Cada vez que te sientes a hacer un trabajo tú mismo, hazte primero la pregunta de prueba y anota hacia dónde cayó. No cambies tu comportamiento; solo cuenta. El viernes sabrás qué parte de tu día es trabajo que solo tú puedes hacer y qué parte es trabajo que todavía no has aprendido a soltar. La segunda cifra es el tamaño de tu oportunidad. Suele ser mayor de lo que esperabas, y también mayor de lo que temías.
Fig. 3 · Hacer frente a decidir. Una pregunta de prueba envía cada trabajo a ti o a un agente, y acaba en una decisión.
Capítulo 4 · Parte I
Las tres preguntas del operador
Todo trabajo que empieza un operador debería sobrevivir a tres preguntas. ¿Qué queremos? ¿Por qué ahora? ¿Cómo lo sabré? Se responden en un minuto, y ese minuto es el mejor invertido del día, porque el trabajo que no las supera suele devorar horas antes de que nadie se dé cuenta de que nunca mereció la pena.
La primera pregunta, qué queremos, parece trivial y no lo es. La mayoría de las ejecuciones fallidas de un agente fallan aquí. El operador tenía una sensación, la tecleó en un prompt y recibió algo que encajaba con las palabras pero no con la sensación. El remedio es responder en términos de resultado, no de actividad. No echa un vistazo al flujo de registro, sino un usuario nuevo puede registrarse y llegar a su primer elemento guardado sin ayuda. Las actividades pueden prolongarse indefinidamente. Los resultados o existen o no existen.
La segunda pregunta, por qué ahora, es la defensa del operador contra lo infinito. Los agentes abaratan empezar cosas, lo que significa que la lista de ideas plausibles crece más deprisa de lo que nadie puede revisar. Preguntarse por qué ahora obliga a ordenar. Quizá algo está roto y te cuesta dinero cada día. Quizá una puerta se cierra la semana que viene. Quizá es sencillamente lo más útil de la lista. Todas son buenas respuestas. Porque se me ha ocurrido esta mañana no lo es, aunque sea la más frecuente.
La tercera pregunta, cómo lo sabré, es la que hace posible delegar. Si no sabes decir cómo reconocerías el éxito, no puedes pedirle a un agente que lo consiga, y desde luego no puedes revisar si lo ha conseguido. Una buena respuesta nombra una comprobación: los tests pasan y el nuevo falla sin el cambio; la página carga en un móvil; el resumen cabe en una pantalla y menciona a los cuatro proveedores. Una mala respuesta es lo sabré cuando lo vea, que quiere decir que verás algo y luego discutirás contigo mismo sobre ello.
Si no sabes decir cómo lo sabrás, todavía no estás listo para pedirlo.
Las preguntas se estrechan a medida que avanzan, y por eso conviene hacerlas en orden. La primera es amplia y generosa; deja pasar todo lo que podrías querer. La segunda filtra por momento y coste. La tercera deja solo el trabajo que de verdad puedes verificar. Lo que sale por abajo es pequeño, concreto y comprobable, que es justo la forma que mejor manejan los agentes y que más rápido revisa un operador.
No necesitas un formulario. Basta una línea al principio de cada encargo. Algunos operadores escriben las tres respuestas como las tres primeras frases de cada tarea, antes de cualquier instrucción. Al principio parece un poco ceremonioso. A las dos semanas dejas de notarlo y empiezas a notar, en cambio, cuánto menos trabajo tiras a la basura. Las preguntas no te hacen más listo. Simplemente impiden que estés ocupado en lo que no toca, que, en un día lleno de agentes entusiastas, es casi toda la batalla.
Fig. 4 · Las tres preguntas del operador. Tres preguntas reducen el trabajo a algo pequeño, concreto y comprobable.
Capítulo 5 · Parte I
El volumen no es lo importante
Lo primero que te dan los agentes es volumen. Pide diez variaciones y tendrás diez. Pide una funcionalidad y tendrás la funcionalidad, sus tests, una migración y un resumen pulcro. Abre cinco hilos antes de comer y a la hora de la merienda tendrás cinco tandas de resultados. Es embriagador y, como casi todo lo embriagador, es una mala guía para saber si estás llegando a alguna parte.
La producción es lo que fabrica la máquina. El resultado es lo que cambia en el mundo gracias a ella. Un operador puede generar una producción enorme sin ningún resultado: borradores que nunca se publican, ramas que nunca se fusionan, prototipos que nunca se enseñan a nadie. El panel parece ajetreado, el trabajo parece impresionante y nada se ha movido. Es la trampa del ajetreo, y los agentes la cavan más honda, porque el coste de producir una cosa más ha caído casi a cero mientras que el coste de terminar una cosa más no ha caído en absoluto.
Terminar es caro porque te implica a ti. Alguien tiene que revisar el trabajo, decidir que es suficientemente bueno, sacarlo al mundo y ocuparse de lo que pase después. Cada uno de esos pasos tira de tu atención, que es fija. Así que un operador que empieza más de lo que puede terminar no está aumentando su rendimiento. Está formando una cola, y las colas tienen la costumbre de convertirse en culpa.
Empezado es un coste. Terminado es un resultado.
Ayuda imaginar tu trabajo en dos ejes. Un eje es la producción: cuánto se fabricó. El otro es el resultado: cuánto llegó a alguien y marcó una diferencia. La mayoría de los operadores, cuando estrenan agentes, se deslizan por el eje de la producción y se quedan abajo en el del resultado. El cuadrante que quieres es aquel en que la producción es modesta y el resultado es alto: menos cosas, terminadas. Parece menos productivo. Es muchísimo más productivo, como te dirá cualquiera que haya entregado una cosa en lugar de empezar cuatro.
El hábito práctico es medir lo terminado, no lo empezado. Al final de cada día, cuenta solo lo que cruzó la meta: fusionado, publicado, enviado, entregado, decidido. No cuentes hilos abiertos ni borradores creados. Si la cuenta es cero, eso es información, no una regañina. Mira por qué. Casi siempre la respuesta es que se empezaron demasiadas cosas y ninguna recibió la atención de revisión que necesitaba para terminarse.
Hay un beneficio secundario. Cuando cuentas lo terminado, empiezas a hacer los encargos de otra manera. Dejas de pedir a los agentes exploraciones desparramadas y empiezas a pedir lo más pequeño que se pueda terminar hoy. Divides los trabajos grandes en piezas que puedan entregarse cada una por su cuenta. Te das cuenta de que una cosa grande a medias vale menos que una cosa pequeña terminada, porque la pequeña se puede usar y la grande solo se puede admirar.
Pruébalo durante una semana: un solo número en una tarjeta, cosas terminadas por día. Ignora todo lo demás que te cuente la máquina sobre lo ocupada que ha estado. La máquina siempre está ocupada. Es su naturaleza. La tuya es decidir qué parte de ese ajetreo se vuelve real.
Fig. 5 · El volumen no es lo importante. Producción frente a resultado: apunta a pocas cosas terminadas, no a la trampa del ajetreo de muchas empezadas.
Capítulo 6 · Parte I
Directo, sin preámbulos
A los agentes no hay que caldearlos. No necesitan que les digas que esperas que estén bien, que la petición es un poco rara o que llevas un tiempo dándole vueltas a algo. Necesitan saber qué quieres, qué deben saber para hacerlo y cómo vas a juzgar el resultado. Todo lo demás es preámbulo, y el preámbulo cuesta más de lo que parece.
Cuesta, en primer lugar, en claridad. Un encargo que empieza con tres frases de contexto hace que la instrucción de verdad sea más difícil de encontrar, para el agente y para ti cuando lo releas. Los agentes dan peso a todo lo que tienen delante, así que un comienzo que divaga puede inclinar el trabajo en direcciones que no pretendías. Si mencionas de pasada que te preocupa el rendimiento, no te extrañe que un simple cambio de texto llegue envuelto en una capa de caché.
Cuesta, en segundo lugar, en tu propio pensamiento. El preámbulo suele ser lo que escribimos mientras todavía estamos averiguando qué queremos. Es algo perfectamente razonable, pero hazlo en un cuaderno, no en el encargo. Escribe con libertad y luego borra todo lo que esté por encima de la primera frase que contenga un verbo y un resultado. Lo que queda suele ser el encargo que querías escribir.
Di la cosa. Luego di cómo sabrás que está hecha. Luego calla.
Lo mismo vale en sentido contrario. Pide a los agentes que sean directos contigo. Un buen resultado empieza por el desenlace y las pruebas, no por la crónica del viaje. Hecho: el importador ya gestiona filas vacías; el test nuevo falla con el código antiguo y pasa con el nuevo; la suite completa en verde vale más que tres párrafos describiendo la investigación. Siempre puedes pedir la historia. No deberías tener que excavar para encontrar el veredicto.
No se trata de ser seco. Se trata de respetar lo más escaso del sistema, que es tu atención. Cada frase innecesaria que escribe un agente es una frase que tienes que leer antes de decidir qué hacer a continuación. Multiplica eso por veinte hilos al día y el preámbulo se convierte en un impuesto sobre toda tu operación. Muchos operadores dejan una instrucción fija en la memoria del proyecto en este sentido: primero el resultado, luego las pruebas, luego las preguntas abiertas, y el resumen corto. Es una de las líneas más rentables que puedes escribir.
La franqueza también abarata el desacuerdo. Si un agente cree que tu enfoque es erróneo, quieres que lo diga en la primera línea, no que entierre la objeción en el cuarto párrafo después de hacer el trabajo de todos modos. Pídelo explícitamente. Hablar claro en las dos direcciones convierte la colaboración de un educado intercambio de documentos en algo más parecido a una conversación de trabajo.
Así que esta semana mira tus últimos diez encargos y tacha la primera frase de cada uno. Luego comprueba si el encargo sigue teniendo sentido. En la mayoría de los casos tendrá más sentido. El preámbulo era para ti. El agente nunca lo necesitó y, si eres sincero, tú tampoco.
Fig. 6 · Directo, sin preámbulos. Encargos e informes cargados de preámbulo frente a otros directos que empiezan por el resultado.
Capítulo 7 · Parte I
Ganas de actuar, atadas a pruebas
Los operadores a los que les va bien con agentes suelen compartir un temperamento: prefieren probar algo a discutirlo. Cuando surge una pregunta que un experimento podría responder, hacen el experimento. Cuando hace falta un borrador, lo encargan y luego discuten con el borrador en lugar de con una página en blanco. Los agentes recompensan generosamente este temperamento, porque los experimentos que antes llevaban un día ahora llevan diez minutos, y ya no hay mucha excusa para deliberar largamente sobre cosas que podrían simplemente probarse.
Pero las ganas de actuar tienen un modo de fallo, y los agentes también lo recompensan. El operador que actúa deprisa sin comprobar acaba con un montón de cosas que parecen hechas y no lo están. Una migración que se ejecutó pero se saltó registros en silencio. Una página que se ve preciosa en un portátil y se desmorona en un móvil. Un resumen seguro de sí mismo y equivocado. Cada una es barata de producir y cara de descubrir después, normalmente en el peor momento posible y a menudo por otra persona.
La respuesta no es ir más despacio. Es atar tu velocidad a las pruebas. Actúa tan rápido como quieras, siempre que cada acción produzca algo que puedas comprobar y que de verdad lo compruebes antes de construir encima. Esa es la intersección que importa: ni cautela ni prisa, sino movimientos rápidos que dejan cada uno una prueba detrás. El operador vive en esa intersección.
Muévete tan rápido como tus pruebas puedan seguirte.
En la práctica, esto significa meter la comprobación dentro de la acción. Cuando le hagas un encargo a un agente, incluye el paso de verificación: ejecuta los tests, carga la página, cuenta las filas antes y después, compara el resumen con la fuente. Cuando actúes tú, decide de antemano qué vas a mirar después. Si no hay nada que mirar, o lo encuentras o reconoces que estás adivinando y tratas el resultado como provisional.
También significa ser honesto sobre qué acciones son reversibles. Probar un diseño nuevo en una rama es fácil de deshacer; actúa con libertad. Enviar un correo a todas las personas de una lista no lo es; ve más despacio y mira dos veces. Un hábito útil es etiquetar cada acción, en silencio, como boceto o como compromiso. Los bocetos pueden ser rápidos y desaliñados. Los compromisos necesitan pruebas. Casi todos los líos en que se meten los operadores vienen de tratar un compromiso como si fuera un boceto porque el agente lo hizo parecer muy fácil.
Hay un placer en esta forma de trabajar que es fácil pasar por alto. Cuando cada movimiento deja pruebas, dejas de cargar con la angustia de si las cosas están realmente hechas. Lo sabes, porque lo miraste. Eso libera atención para la siguiente decisión, lo que a su vez te hace más rápido. Las pruebas no son un freno para las ganas de actuar. Son lo que te permite seguir pisando el acelerador.
Esta semana, elige una tarea sobre la que normalmente deliberarías y hazla como experimento. Antes de empezar, escribe la única comprobación que te diría que ha funcionado. Luego hazla, compruébala y mira cuánto tardó todo. Será menos de lo que habría durado la deliberación.
Fig. 7 · Ganas de actuar, atadas a pruebas. El operador trabaja donde la acción rápida se cruza con la comprobación de pruebas.
Capítulo 8 · Parte I
Primero el artefacto
Hay una regla sencilla que ahorra a los operadores una cantidad notable de tiempo: ante la duda, haz la cosa. No describas el panel; consigue que se construya un panel tosco. No debatas la estructura del informe; haz que se redacte un borrador con dos estructuras y lee ambos. No imagines cómo se sentirá el correo de bienvenida; prodúcelo y léelo como si lo hubieras recibido tú. Un artefacto sobre la mesa zanja más discusiones que cualquier cantidad de charla sobre él.
Antes este era un consejo caro. Hacer un prototipo llevaba días, así que lo sensato era hablarlo primero y construir solo cuando estabas bastante seguro. Los agentes han invertido la economía. Una versión tosca de casi cualquier cosa cuesta hoy menos que la reunión que habrías tenido sobre ella, aunque la reunión fuera solo contigo mismo. Así que cambia el orden de las operaciones. En lugar de pensar, decidir, construir, pasa a ser construir a lo bruto, mirar, decidir, construir bien.
Funciona porque la gente, tú incluido, es mucho mejor reaccionando que imaginando. Ante una página, sabes en segundos que el titular es demasiado largo y el botón está en el sitio equivocado. Si te piden que imagines la página, puedes pasarte una hora y no ver ninguna de las dos cosas. Un artefacto convierte preferencias vagas en objeciones concretas, y las objeciones concretas son algo sobre lo que un agente puede actuar.
No puedes revisar una intención. Puedes revisar un artefacto.
Hay dos disciplinas que evitan que «primero el artefacto» degenere en una plaga de artefactos. La primera es etiquetar el artefacto con honestidad. Un boceto es un boceto. Díselo al agente, para que no gaste esfuerzo en pulirlo, y díselo a ti mismo, para no enamorarte de él. Muchos operadores tienen una carpeta o una rama aparte para artefactos desechables precisamente para que nada de lo que hay ahí pueda confundirse con trabajo real.
La segunda disciplina es terminar cada artefacto con una decisión. El sentido de hacer la cosa era aprender algo. Una vez que la has mirado, escribe qué has aprendido y qué vas a hacer: seguir en esta dirección, abandonarla o cambiar una cosa concreta y volver a mirar. Un artefacto que no conduce a una decisión es solo producción, y los capítulos anteriores han dejado claro cuánto vale la producción por sí sola.
Primero el artefacto también mejora tus encargos. Cuando tienes delante una versión tosca, el siguiente encargo puede señalarla: mantén la maquetación, cambia el tono del texto, haz que la tabla se pueda ordenar. Señalar es mucho más preciso que describir. El primer artefacto suele valer menos por sí mismo que por el vocabulario que te da para pedir el segundo.
Esta semana, busca una decisión que llevas tiempo aplazando porque no conseguías imaginar las opciones. Pide a un agente dos versiones toscas, una al lado de la otra, en el formato que tendrá finalmente la cosa. Date diez minutos para mirarlas. Fíjate en lo rápido que la decisión se toma sola en cuanto hay algo que mirar. Normalmente solo le faltaba una cara.
Fig. 8 · Primero el artefacto. El viejo orden de pensar y luego construir frente a construir a lo bruto, mirar y decidir.
Capítulo 9 · Parte I
La regla de la máquina pequeña
Todo operador acaba construyendo demasiada máquina. Empieza de forma inocente. Escribes un script útil, luego una plantilla, luego unas instrucciones para una tarea recurrente, luego un panel para seguir las tareas recurrentes, luego un agente que actualiza el panel. Cada pieza tiene sentido por separado. Juntas se convierten en un sistema que exige su propio mantenimiento, su propia documentación y, al poco tiempo, su propio operador. Te propusiste llevar un pequeño negocio y descubriste que llevabas una pequeña empresa de software cuyo único cliente eres tú.
La regla de la máquina pequeña es una defensa contra esto. Dice: mantén todo el sistema lo bastante pequeño como para tenerlo en la cabeza en un mal día. No en un buen día, cuando estás descansado y curioso y disfrutas trasteando, sino una tarde cansada de jueves en que algo se ha roto y necesitas saber dónde mirar. Si no puedes dibujar tu sistema de memoria en el reverso de un sobre, es demasiado grande.
¿Qué contiene una máquina pequeña? Normalmente mucho menos de lo que la gente espera. Un registro de proyectos, para saber qué está en marcha. Un puñado de recetas reutilizables para el trabajo que haces una y otra vez. Un conjunto pequeño y estable de herramientas que conoces bien. Y, debajo de todo, un ritmo diario que te dice cuándo revisar, cuándo trabajar y cuándo parar. Ese ritmo es el cimiento; lo demás descansa encima. Un operador con un buen ritmo y tres herramientas rendirá más que uno con un mal ritmo y treinta.
Si necesitas un manual para manejar tu manual, deja de construir.
La regla va contra un instinto natural. Los agentes hacen tan fácil construir herramientas que puede parecer irresponsable no automatizar cada paso repetido. Pero la automatización tiene un coste de mantenimiento. Cada script hay que mantenerlo funcionando mientras el mundo a su alrededor cambia. Cada plantilla se queda desfasada. Cada servicio conectado necesita que se revisen sus permisos y que alguien note sus fallos. El coste es pequeño en cada caso y grande en conjunto, y se paga justo en la moneda que más te escasea, que es la atención.
Así que antes de añadir una pieza nueva a la máquina, hazte dos preguntas. ¿La usaré al menos una vez a la semana? ¿Me daré cuenta cuando se rompa? Si la respuesta a cualquiera de las dos es no, haz la tarea a mano o con un encargo puntual, y espera a que el patrón se demuestre. Una receta que has ejecutado a mano cinco veces está lista para ponerse por escrito. Una receta que has ejecutado una vez es una conjetura.
Igual de útil es restar. Una vez por trimestre, haz una lista de cada parte de tu sistema y pregúntate cuáles no has usado en un mes. Quítalas o, por lo menos, apártalas de la vista. Los operadores rara vez se arrepienten de quitar algo. Con frecuencia se arrepienten de la hora perdida depurando una automatización ingeniosa que les ahorraba cuatro minutos a la semana.
Esta semana, dibuja tu máquina. Una página, de memoria. Lo que se te olvide incluir es candidato a borrarse. Lo que no sepas explicar en una frase es candidato a simplificarse. La máquina que puedes dibujar es la máquina que puedes manejar.
Fig. 9 · La regla de la máquina pequeña. Una máquina pequeña se apoya en un ritmo diario, con dos pruebas antes de añadir cualquier pieza.
Capítulo 10 · Parte I
El nombre en la puerta
Hay un hecho del oficio de operador que no cambia por muy capaces que se vuelvan los agentes: tu nombre está en la puerta. Cuando algo se entrega, se entrega como tuyo. Cuando se rompe, se rompe como tuyo. Un cliente, un lector o un usuario nunca preguntará qué agente escribió el párrafo ni qué hilo produjo el fallo. Te preguntará a ti, y con razón.
No es una carga que haya que lamentar. Es lo que convierte el trabajo en un oficio. Si los agentes pudieran responder de los resultados, no necesitarían operador, y todo sería más sencillo y bastante menos interesante para ti. Responder de las cosas es lo que convierte un montón de herramientas capaces en una operación que funciona. Alguien tiene que decidir qué significa suficientemente bueno, y alguien tiene que dar la cara después.
Lo que se sigue de esa responsabilidad es, sobre todo, una cuestión de atención. Los agentes hacen el trabajo, a lo ancho y deprisa. Tú revisas el trabajo, a lo estrecho y con cuidado, porque la revisión es donde tu responsabilidad se vuelve real. Y tú respondes del resultado, lo que significa que la revisión tiene que ser lo bastante buena como para que te sientas cómodo defendiendo el resultado ante alguien que importa. Esa progresión se estrecha a medida que avanza: mucho trabajo, menos revisión, un solo responsable. El estrechamiento es la clave.
Puedes delegar el esfuerzo. No puedes delegar la disculpa.
La responsabilidad también moldea los encargos que escribes. Un operador que sabe que tendrá que responder del resultado escribe restricciones más claras, pide pruebas más sólidas y siente menos tentación de dar el visto bueno a todo un viernes por la tarde. Es un experimento mental útil, antes de aprobar nada, imaginar que se lo explicas a la persona más afectada. Si la explicación empezaría con bueno, lo decidió el agente, no has terminado de revisar.
Nada de esto significa hacerlo todo tú por ansiedad. Ese es el fallo contrario, e igual de frecuente entre la gente concienzuda. Responder de las cosas es compatible con delegar mucho, siempre que lo que delegas vuelva a través de un punto de control que tú manejas. Un buen editor responde de una revista sin escribir cada artículo. Un buen capitán responde del barco sin apretar cada tornillo. La habilidad está en colocar los puntos de control donde atrapen lo que importa, que es de lo que trata casi todo el resto de este libro.
Hay también un beneficio más discreto. Responder del resultado le da al trabajo un centro de gravedad. Cuando haces malabares con una docena de hilos y una flota de agentes, es fácil sentir que el trabajo te pasa a ti en lugar de pasar a través de ti. Recordar que vas a firmarlo te devuelve a la silla del operador. Dejas de mirar la máquina y empiezas a manejarla.
Así que esta semana, antes de aprobar cualquier cosa que vaya a ver otra persona, detente cinco segundos y pregúntate: ¿firmaría esto? No ¿probablemente está bien?, sino ¿pondría mi nombre aquí? Casi siempre la respuesta será sí. Las pocas veces que no lo sea serán los cinco segundos más valiosos de tu semana.
Fig. 10 · El nombre en la puerta. El trabajo se estrecha de muchos hilos de agentes a tu revisión y, al final, a tu firma.
Parte II
La jornada operativa
Revisión matinal, sesiones y cierre.
Capítulo 11 · Parte II
La forma de un buen día
Una buena jornada operativa tiene una forma que podrías dibujar con tres trazos. Un tramo corto de revisión al principio, un centro largo de sesiones y un cierre corto al final. Los detalles cambian según la persona, la época del año y cuánto café quede en casa, pero la forma se mantiene. Cuando los operadores describen un día que fue bien, casi siempre describen esta forma. Cuando describen uno que fue mal, suelen describir su ausencia.
La revisión va primero porque es donde se decide el día. Lees lo que ha pasado desde la última vez que miraste, separas lo que necesita tu juicio de lo que no y eliges un número pequeño de resultados para hoy. Es la parte del día con más palanca y menos dramatismo. Durante la revisión no se construye nada. Todo lo que se construye después depende de ella.
Las sesiones llenan el centro. Una sesión es un tramo acotado de trabajo dirigido a un solo resultado: haces el encargo, los agentes trabajan, revisas, y entregas o devuelves. El día puede albergar dos sesiones o seis, según su tamaño y según tú. Lo que importa es que cada una tenga un principio y un final, para que el centro del día sea una sucesión de intentos terminados y no un largo borrón de atención a medias.
El cierre va al final porque es lo que hace posible la revisión de mañana. Anotas qué se entregó, qué sigue abierto y cuál debe ser el primer movimiento de mañana. Luego paras, en el sentido pleno de la palabra: hilos en pausa o dejados en marcha a propósito, portátil cerrado, atención devuelta a lo que sea que contenga el resto de tu vida. El cierre es la parte que la mayoría de los operadores se salta, y su ausencia es la razón de que tantas mañanas empiecen con veinte minutos intentando recordar dónde estaban las cosas.
Empieza a propósito, termina a propósito, y el centro se las arregla casi solo.
¿Por qué funciona tan bien una forma tan sencilla? Porque separa dos modos de pensar que se estorban entre sí. La revisión y el cierre van de decidir: qué importa, qué está terminado, qué viene después. Las sesiones van de dirigir y juzgar un trabajo concreto. Cuando los modos se mezclan, las decisiones se toman mal en los huecos entre tareas, y las tareas se ven interrumpidas por decisiones a medio hacer. Dar a cada modo su propio tiempo protege a los dos.
La forma también te da un sitio donde poner lo que no encaja. Una idea nueva en mitad de una sesión va a una lista para la revisión de mañana, en lugar de convertirse en un hilo nuevo. Una preocupación al final del día va a las notas del cierre en lugar de a tu noche. La forma es un conjunto de recipientes, y los recipientes son lo que impide que un sistema ajetreado se desborde.
Esta semana no intentes perfeccionar el día. Limítate a poner los tres trazos en tu calendario: un bloque de revisión, un bloque de cierre y todo lo que hay entre ambos etiquetado como sesiones. Que la revisión y el cierre sean cortos; para empezar, veinte minutos cada uno es más que suficiente. Mira qué le pasa al centro cuando sus bordes son firmes. La mayoría descubre que se porta mejor. Los centros suelen hacerlo, en cuanto alguien les dibuja los bordes.
Fig. 11 · La forma de un buen día. Una revisión y un cierre firmes enmarcan un centro de sesiones acotadas, con contenedores para lo suelto.
Capítulo 12 · Parte II
La revisión de la mañana
La revisión de la mañana son los veinte minutos que deciden si el resto del día llega a alguna parte. No es ponerse al día. No es mirar mensajes. Es un pequeño acto estructurado de triaje que toma todo lo que se ha acumulado desde el cierre de ayer y lo reduce al puñado de resultados que perseguirás hoy.
Empieza a lo ancho. Mira todo lo que se ejecutó o llegó desde la última vez: hilos en segundo plano que terminaron, pull requests en espera, notas del cierre de ayer, mensajes que necesitan respuesta, cualquier cosa que haya señalado una tarea automática. No actúes todavía sobre nada. La tentación es arreglar la primera cosita que ves, porque es satisfactorio y rápido. No lo hagas. La primera cosita rara vez es la más importante, y en cuanto empiezas a arreglar, la revisión ha terminado y el día lo ha elegido el azar.
Luego estrecha. Para cada elemento, pregúntate si necesita una decisión tuya. Muchos no. Un hilo que terminó y pasó sus comprobaciones quizá solo necesite fusionarse, que es una acción de dos segundos que puedes agrupar con otras. Un aviso de que algo se ejecutó con éxito no necesita nada en absoluto. Lo que queda, los elementos que de verdad necesitan tu juicio, es tu lista de decisiones. Suele ser más corta de lo que sugería la bandeja de entrada.
Por último, elige. De la lista de decisiones y de tu registro de proyectos, escoge los resultados de hoy. El capítulo siguiente sugiere tres, pero el número importa menos que el acto de elegir. Escríbelos donde los vayas a ver todo el día. Son el contrato del día consigo mismo.
La revisión es donde se gana el día, en silencio, antes de que haya pasado nada.
Algunas notas prácticas. Haz la revisión antes de abrir cualquier cosa que pueda arrastrarte a una conversación, porque las conversaciones están diseñadas para continuar y la revisión está diseñada para terminar. Ponle un límite de tiempo; si cada mañana te lleva cuarenta minutos, algo río arriba está produciendo demasiado ruido, y eso merece arreglarse por sí mismo. Y hazla en el mismo sitio cada día, con la misma secuencia, para que se convierta en un hábito y no en una decisión. A primera hora, las decisiones son caras. Los hábitos son gratis.
Algunos operadores piden a un agente que les prepare la revisión: un resumen breve de lo que se ejecutó, lo que pasó, lo que falló y lo que está en espera. Es un buen uso de un agente, siempre que el resumen sea un punto de partida y no un sustituto. Lee el resumen y luego echa un vistazo a los elementos de fondo por si algo huele raro. El agente puede resumir. Lo que todavía no puede es decirte cuál de las cosas resumidas te va a importar más a las once.
Pruébalo mañana. Antes de abrir nada, escribe la fecha de hoy y las palabras resultados de hoy en una página en blanco. Luego haz la revisión, a lo ancho, estrechando, eligiendo, y rellena la página. Cierra la revisión deliberadamente, quizá cerrando la pestaña en la que la hiciste. Después empieza la primera sesión. Fíjate en lo distinta que se siente la primera hora cuando empieza con una decisión y no con un scroll.
Fig. 12 · La revisión de la mañana. La revisión matinal mira en amplio, se estrecha a las decisiones y elige los resultados de hoy.
Capítulo 13 · Parte II
Leer lo que corrió de noche
Uno de los grandes placeres de trabajar con agentes es despertarse con trabajo terminado. Le hiciste un encargo a un hilo antes de acostarte, se ejecutó mientras dormías y ahora te esperan una pull request, un borrador, un informe o un conjunto de datos. Da la sensación de tener plantilla. También es uno de los sitios más fáciles para cometer un error silencioso y caro, porque el trabajo hecho mientras no mirabas es el trabajo del que menos sabes.
La primera regla para leer el trabajo nocturno es leer el resultado antes que el resumen. Los agentes escriben buenos resúmenes, y los buenos resúmenes son persuasivos. Te dicen qué se hizo, por qué, y que todo pasó. No mienten, pero los escribe la parte que hizo el trabajo, y es natural que subrayen lo que salió bien. Abre primero el producto real: el diff, el documento, los datos. Fórmate tu propia impresión. Luego lee el resumen y mira si coincide contigo.
La segunda regla es comprobar las pruebas, no solo que existan. Un hilo que dice todos los tests pasan te ha dicho algo, pero quieres saber qué tests, y si alguno de ellos ejercita de verdad el trabajo nuevo. Un informe que cita fuentes debería tener fuentes que puedas abrir. Un conjunto de datos que dice tener cien filas debería tener cien filas. Cada comprobación lleva un minuto. Es el minuto que separa confiar en la máquina de esperar que la máquina haya acertado.
El trabajo que nadie vigiló merece una primera lectura más lenta que el vigilado, no más rápida.
La tercera regla es decidir, limpiamente, una de tres cosas: entregarlo, devolverlo con notas concretas o aparcarlo con un motivo. No dejes el trabajo nocturno en un estado ambiguo, abierto y medio leído, porque así se convierte también en el cuarto elemento de la revisión de mañana. Si está bien, fusiónalo o publícalo ya. Si necesita cambios, escribe los cambios como un encargo breve y manda el hilo a dar otra vuelta. Si te ha planteado una pregunta que aún no puedes responder, apúntala en el registro junto al proyecto y cierra la pestaña.
Con el tiempo aparece un patrón que merece atención. Algunos tipos de trabajo nocturno vuelven bien de forma fiable, y otros vuelven enmarañados de forma igual de fiable. Los primeros suelen ser estrechos, bien especificados y fáciles de verificar. Los segundos suelen ser amplios, exploratorios o dependientes de juicios que el agente tuvo que hacer sin ti. No es motivo para dejar de lanzar trabajo amplio por la noche. Es motivo para encargarlo de otra manera: pide opciones en lugar de una decisión y cuenta con dedicarle más tiempo de revisión por la mañana.
Esta semana, lleva una nota breve de cada resultado nocturno que leas: qué era, si lo entregaste, lo devolviste o lo aparcaste, y cuánto tardaste en leerlo. El viernes sabrás qué tipos de trabajo pueden ejecutarse sin peligro mientras duermes y cuáles necesitan de verdad que estés despierto. Ese conocimiento vale más que cualquier capacidad del agente, porque te dice hacia dónde apuntar la capacidad que ya tienes.
Fig. 13 · Leer lo que corrió de noche. Lee el resultado nocturno, luego el resumen, luego las pruebas, y decide de una de tres maneras.
Capítulo 14 · Parte II
Elegir los tres de hoy
Elige tres resultados para el día. No tres tareas, ni treinta, ni uno. Tres resultados, cada uno algo que estará visiblemente terminado al cierre: entregado, enviado, decidido o publicado. Es la restricción más útil que puede adoptar un operador, y es útil precisamente porque parece demasiado pequeña.
¿Por qué tres? En parte porque es más o menos lo que una persona puede revisar como es debido en un día en que los agentes hacen casi todo el trabajo. Cada resultado necesitará al menos una revisión cuidadosa, a menudo dos o tres, y cada revisión necesita atención auténtica. En parte porque tres basta para absorber una decepción: si un resultado se atasca, el día aún produce dos. Y en parte porque tres es un número que puedes tener en la cabeza sin apuntarlo, aunque deberías apuntarlo igualmente.
La habilidad está en elegir. Una forma útil de pensarlo es colocar los resultados candidatos en dos ejes, impacto y esfuerzo. El impacto es cuánto cambiaría terminarlo: para un cliente, para los usuarios, para la salud de tus proyectos. El esfuerzo no es el del agente, que es barato, sino el tuyo: cuánto encargar, revisar y decidir exigirá. Los resultados que quieres tienen mucho impacto y un esfuerzo tuyo moderado. Esos son los tres de hoy.
Una lista de treinta es un deseo. Una lista de tres es un plan.
Desconfía de dos distorsiones habituales. La primera es elegir solo resultados fáciles, porque terminar sienta bien y lo fácil se termina. Un día de tres victorias triviales es agradable y no mueve nada que importe. Asegúrate de que al menos uno de los tres sea algo que te habría dado un poco de pereza empezar. La segunda es elegir solo resultados enormes, porque parecen importantes. Un resultado enorme rara vez se termina en un día. Si algo importa pero es grande, el resultado de hoy debería ser una porción que pueda terminarse: la primera sección entregada, el diseño decidido, los datos limpios.
Los tres no son una cárcel. Surgirán cosas. Si llega algo urgente, puedes meterlo, pero hazlo explícitamente: tacha uno, escribe el nuevo y date cuenta de que has hecho un trueque. Lo que no debes hacer es añadir un cuarto y un quinto en silencio. Así es como tres se convierten en ocho, y ocho en un día en que nada termina del todo.
Al cierre, mira los tres. Marca cada uno como hecho, hecho a medias o no hecho, y escribe una frase sobre el porqué de los que se escaparon. En unas semanas aparecerá un patrón. Quizá subestimas sistemáticamente el tiempo de revisión. Quizá las tardes son donde los resultados van a morir. Quizá eliges bien los lunes y mal los jueves. Cada patrón es una palanca.
Empieza mañana. En la revisión de la mañana, escribe tres resultados en lo alto de la página. Que cada uno sea terminable, concreto y digno de hacerse. Luego dedica el día a ellos, y solo a ellos, salvo que hagas un trueque consciente. Es una disciplina modesta. Su efecto sobre una semana no tiene nada de modesto.
Fig. 14 · Elegir los tres de hoy. Los tres de hoy están en alto impacto y esfuerzo moderado, lejos de lo trivial o lo enorme.
Capítulo 15 · Parte II
Sesiones en bloques de tiempo
Una sesión es un bloque de tiempo con un único propósito. Empieza con un encargo, termina con una decisión y no contiene nada más. Los operadores que trabajan por sesiones sacan adelante más que los que trabajan en flujo continuo, por la misma razón por la que una cocina con temporizadores produce más platos que una en la que todo se deja hirviendo a fuego lento hasta que alguien se acuerda.
La estructura dentro de una sesión es sencilla. Escribes o cargas el encargo, idealmente en los diez primeros minutos. Dejas que los agentes trabajen, vigilando lo suficiente para pillar pronto un giro equivocado, pero no tan de cerca que en la práctica estés haciendo el trabajo a través de ellos. Revisas lo que vuelve, con cuidado. Y decides: entregarlo, mandarlo a dar otra vuelta dentro de la sesión o aparcarlo con una nota. La revisión y la decisión son el corazón de la sesión, y son lo que más probablemente se recorta si la sesión no tiene un final fijo.
¿Cuánto debe durar una sesión? Lo bastante para terminar algo, lo bastante poco para que llegues despierto a la revisión. Para mucha gente, eso está entre cuarenta minutos y dos horas. La duración exacta importa menos que el hecho de haberla decidido de antemano. Una sesión con final fijo cambia tu comportamiento al principio: afinas más el encargo, porque sabes que habrá poco tiempo para corregir después un encargo vago.
Dale al trabajo un recipiente y casi siempre se quedará dentro.
Las sesiones también hacen manejable el trabajo en paralelo. Con agentes, es tentador abrir muchos hilos e ir de uno a otro. Puede funcionar, pero funciona mucho mejor cuando cada hilo pertenece a una sesión con dueño y con final. Dentro de una sesión podrías tener tres agentes trabajando en tres porciones del mismo resultado. Lo que debes evitar es tener cinco hilos con cinco resultados sin relación, todos vigilados a medias, ninguno revisado como es debido. Eso no es trabajo en paralelo. Es abandono en paralelo.
Pon las sesiones en el calendario, aunque el calendario sea solo tuyo. Etiqueta cada una con su resultado, no con su actividad: entregar arreglo del importador, no trabajar en el importador. Cuando la sesión termine, para, aunque el trabajo no esté del todo hecho. Escribe una nota breve de cómo está y o bien programa otra sesión o bien devuelve el resultado al registro. La disciplina de parar incomoda al principio. También es lo que te enseña, en unas semanas, de qué tamaño es de verdad un trabajo que cabe en una sesión.
Entre sesiones, haz un descanso de verdad. No un descanso dedicado a mirar otros hilos, que no es más que otra sesión disfrazada, sino uno en el que no se revisa nada. Los agentes pueden seguir trabajando. Tú no tienes por qué. La calidad de tu próxima revisión depende mucho más de ese descanso que de cualquier cosa que pudieras haber leído durante él.
Esta semana, prueba a pasar todo el trabajo por sesiones: un bloque en el calendario, un resultado en su título, una decisión al final. Cuenta cuántas sesiones completas cada día. Ese número, más que las horas trabajadas, es una buena medida de la capacidad real de un operador. La mayoría descubre que es menor de lo que suponía, y que trabajar a su favor y no en su contra es un gran alivio.
Fig. 15 · Sesiones en bloques de tiempo. Una sesión va del encargo a la decisión; trozos paralelos de un resultado ganan al abandono en paralelo.
Capítulo 16 · Parte II
Empezar bien una sesión
Los cinco primeros minutos de una sesión deciden casi todo lo que pasa en la hora siguiente. Una sesión que empieza limpia, con el contexto adecuado cargado y un encargo claro, suele ir como la seda. Una sesión que empieza con un a ver, ¿por dónde iba? suele pasarse la primera mitad averiguándolo, y la segunda recuperándose de las suposiciones que hizo mientras lo averiguaba.
El comienzo limpio tiene tres movimientos. Primero, lee el relevo. Si este resultado ya se tocó antes, debería haber una nota de la última sesión o del cierre de ayer que diga cómo está: qué se hizo, qué queda abierto, cuál iba a ser el siguiente movimiento. Léela, y lee las entradas relevantes de la memoria del proyecto. Lleva dos minutos y ahorra veinte. Si no hay relevo, eso te dice algo sobre cómo terminó la última sesión, y puedes arreglarlo más tarde.
Segundo, escribe el encargo. Aunque la sesión sea una continuación, escribe en unas pocas frases para qué es esta sesión, cómo se ve el «hecho» y qué debe saber el agente. Es en parte para el agente y en parte para ti. Escribir el encargo te obliga a decidir qué quieres realmente de la hora siguiente, y el acto de decidir es la mitad del valor de la sesión.
Tercero, confirma el plan antes de que empiece el trabajo. Para cualquier cosa mayor que un cambio trivial, pide al agente que diga cómo piensa proceder antes de hacerlo. Muchas herramientas de agentes tienen un modo de planificación precisamente por eso. Lee el plan. Si está mal, corregirlo ahora cuesta una frase. Corregirlo tras cuarenta minutos de trabajo cuesta los cuarenta minutos y tu paciencia.
Un plan equivocado es barato. Un plan equivocado ejecutado, no.
Estos movimientos suenan quisquillosos, y para tareas pequeñas pueden comprimirse en una sola línea de encargo. Pero el hábito importa más que la ceremonia. Los operadores que se saltan el comienzo limpio suelen culpar al agente cuando una sesión se tuerce: no lo entendió, se fue por una dirección rara, no sabía lo de la restricción. En la mayoría de esos casos, el agente trabajaba exactamente con lo que se le había dado, que no era mucho.
Un comienzo limpio incluye también un entorno limpio. Cierra los hilos que no forman parte de esta sesión. Quita de en medio las pestañas de la anterior. Si el agente trabaja en un repositorio, asegúrate de estar en la rama correcta y de que no queda nada a medias de antes. Son pequeños actos de orden, y evitan toda una familia de errores desconcertantes en los que el agente trabaja en una cosa mientras algún resto de otra interfiere en silencio.
Prueba a cronometrarlo. Durante las próximas cinco sesiones, apunta cuánto tarda el comienzo limpio y luego puntúa la sesión con una escala sencilla: fluida, con baches o perdida. La mayoría de los operadores descubre que las sesiones con un buen comienzo salen fluidas con mucha más frecuencia, y que el comienzo rara vez llevó más de cinco minutos. Cinco minutos es poco precio por una hora fluida. Además, casualmente, es más o menos lo que se tarda en hacer un té, y las dos cosas combinan bien.
Fig. 16 · Empezar bien una sesión. Cinco minutos de buen arranque: despejar la mesa, leer el relevo, encargar, confirmar el plan.
Capítulo 17 · Parte II
El centro del día
Una vez que los agentes están en marcha, el operador se enfrenta a un problema curioso: qué hacer consigo mismo. El trabajo está ocurriendo. No necesita tus manos. Sí necesita, de vez en cuando, tu juicio, y no sabes exactamente cuándo. Así que revoloteas. Miras cómo se desplaza la salida, lees cada paso intermedio, abres los archivos a medida que cambian. Parece responsable. Casi siempre es una forma de gastar atención sin comprar nada con ella.
La alternativa es un ritmo de asomarse, desbloquear y apartarse. Asómate a intervalos razonables, no de continuo. Mira por dónde va cada hilo en marcha, si te está esperando y si se dirige a algún sitio plausible. Si algo está bloqueado por una pregunta, respóndela. Si algo va a la deriva, reoriéntalo con una frase. Luego apártate y haz algo que no sea mirar: revisar un trabajo terminado, escribir el encargo de mañana, pensar una decisión o, sencillamente, dar un paseo.
Desbloquear es la parte valiosa, y merece la pena pensar por qué. Los agentes se atascan en cosas que necesitan una decisión que ellos no pueden tomar: cuál de dos enfoques prefieres, si una restricción se aplica de verdad, qué hacer con algo inesperado. Una hora perdida esperando esa decisión es una hora de agente desperdiciada. Un minuto dedicado a tomarla es el minuto con más palanca del centro del día. Así que, cuando te asomes, busca primero lo que te esté esperando y despéjalo antes que nada.
Revolotear gasta atención. Desbloquear la invierte.
¿Cada cuánto deberías asomarte? Depende del trabajo y de lo bien que se encargó. Una tarea bien especificada con comprobaciones claras puede funcionar mucho tiempo sin ti. Una tarea exploratoria de bordes difusos necesita miradas más frecuentes, porque la probabilidad de un giro equivocado es mayor. Una regla útil es asomarse más o menos con la frecuencia a partir de la cual un giro equivocado empezaría a ser fastidioso de deshacer. Para muchas tareas, eso es cada quince o veinte minutos. Para algunas, una vez por hora.
Muchas herramientas de agentes te avisan ya cuando un hilo necesita algo de ti o termina. Usa esos avisos, pero ajústalos. Si todo te avisa, nada te avisa. Lo ideal es que las únicas interrupciones que recibas en el centro del día sean las que necesitan una decisión, y que todo lo demás espere a tu próxima visita o al cierre.
El centro del día es también donde se ponen a prueba las elecciones de la mañana. Si los tres de hoy están bien elegidos y los encargos son claros, el centro es tranquilo: te asomas, desbloqueas, te apartas y revisas el trabajo terminado según llega. Si el centro se vuelve frenético, suele ser síntoma de algo río arriba. Se empezaron demasiados hilos. Un encargo era vago. Un resultado era demasiado grande. Apunta el síntoma para la revisión de mañana en lugar de intentar arreglar la causa en plena tormenta.
Esta semana, pon un temporizador para asomarte en lugar de mirar de continuo. Cuando suene, mira, desbloquea y vuelve a apartarte. Fíjate en cuánto día te devuelve. Los agentes no notarán la diferencia. Tú sí.
Fig. 17 · El centro del día. El bucle de mediodía de revisar, desbloquear y apartarse, en vez de rondar.
Capítulo 18 · Parte II
Interrupciones y la cola
Las ideas llegan en momentos poco oportunos. Estás a mitad de revisar una pull request y se te ocurre una funcionalidad. Estás escribiendo un encargo y recuerdas un correo que querías enviar. Llega un mensaje pidiendo algo pequeño. Un agente, en plena ejecución, sugiere una mejora de algo completamente distinto. Cada una de estas cosas es una pequeña interrupción, y cada una, si actúas sobre ella de inmediato, cuesta no solo el tiempo que lleva sino el tiempo que tardas después en volver a encontrar el hilo.
Los agentes hacen las interrupciones más peligrosas, porque abaratan muchísimo actuar sobre ellas. En el mundo de antes, una idea nueva a media tarde tenía que esperar porque estabas ocupado. Ahora puedes abrir un hilo nuevo y lanzarlo en treinta segundos, y los treinta segundos parecen gratis. No lo son. El hilo nuevo necesitará encargo, vigilancia, revisión y decisión, y acaba de llevarse en silencio una porción de la atención de hoy que ya estaba prometida a los tres de hoy.
La respuesta es una cola. Un sitio sencillo, un archivo de texto o una lista en tu registro, donde las interrupciones esperan su turno. Cuando llegue algo, hazte una sola pregunta: ¿esto tiene que pasar hoy, a costa de los resultados de hoy? Si la respuesta es sí, hazlo ya y cámbialo conscientemente por uno de los tres. Si es no, y casi siempre es no, escríbelo en la cola en una línea y vuelve a lo que estabas haciendo. Ahí estará en la revisión de mañana, donde podrá competir limpiamente con todo lo demás.
Una idea apuntada no se pierde. Una idea ejecutada al instante, a menudo sí.
La cola funciona porque elimina la angustia de olvidar. Buena parte del impulso de actuar ante una interrupción viene del miedo a que la idea se esfume si no se agarra al vuelo. En cuanto confías en que la cola la guardará y en que la revisión la mirará, el impulso se desvanece. Puedes dejar que una buena idea entre en la cola con la misma calma con que echas una carta al buzón.
Conviene ser honesto con la categoría de lo urgente. Muy pocas cosas necesitan de verdad pasar hoy. Una caída en producción, sí. Una promesa a un cliente con plazo hoy, sí. Un mensaje de alguien que espera tu respuesta para seguir, quizá. Casi nada más, por urgente que parezca, y la sensación de urgencia suele ser la sensación de novedad disfrazada.
Los agentes también pueden ayudar con la cola. Un buen hábito es pedirles que, cuando vean algo fuera de la tarea actual, lo anoten en lugar de arreglarlo. Si encuentras otros problemas, enuméralos al final; no los cambies es una línea que evita muchísimo crecimiento descontrolado del alcance. Esas notas van luego a la cola, y la tarea actual sigue siendo la tarea actual.
Esta semana, ten una cola y úsala para cada interrupción que no sea verdaderamente urgente. Al final de la semana, mira lo que se ha acumulado. Una parte será valiosa y se programará. Una cantidad sorprendente parecerá, el viernes, que nunca fue tan importante. Esa cantidad sorprendente es la atención que te has ahorrado.
Fig. 18 · Interrupciones y la cola. Cada interrupción recibe una pregunta; casi todas van a la cola para la revisión de mañana.
Capítulo 19 · Parte II
La orden de terminar
Toda sesión debería terminar con el mismo pequeño ritual. Piensa en él como una orden de terminar: una secuencia fija que convierte un tramo de trabajo en algo zanjado. Verificar, entregar, anotar, parar. Lleva cinco minutos. Es la diferencia entre una sesión que terminó y una sesión que simplemente acabó porque se te agotó el tiempo.
Primero, verifica. Antes que nada, comprueba que lo que crees que está hecho está realmente hecho. Vuelve a ejecutar las comprobaciones si la última vez fue antes de los cambios finales. Abre la página, lee el documento, mira los datos. Los agentes informan bien de que han terminado; no son infalibles en ello, y el final de una sesión, cuando estás deseando pasar a otra cosa, es justo cuando más probable es que te creas el informe a pies juntillas.
Luego, entrega. Si el trabajo está listo, ponlo donde va: fusiona la pull request, publica la entrada, envía el correo, actualiza el registro. No dejes trabajo terminado durmiendo en una rama o en una carpeta de borradores. No va a mejorar ahí, y se convertirá en un elemento de la revisión de mañana que te obligará a reconstruir desde cero tu confianza en él. Si no está listo, decide explícitamente que no lo está, y por qué.
Luego, anota. Escribe un relevo breve: qué se hizo, qué queda abierto, cuál es el siguiente movimiento. Ponlo donde vaya a mirar la próxima sesión, ya sea el archivo de memoria del proyecto, el registro o una nota al principio del hilo. Escríbelo para alguien que lo ha olvidado todo, porque mañana ese alguien serás tú. Muchos operadores piden a un agente que redacte esta nota y luego la corrigen, lo cual es un buen reparto del trabajo siempre que la corrección ocurra de verdad.
Una sesión que termina sin nota termina dos veces: ahora, y mañana cuando averigües qué pasó.
Luego, para. Cierra el hilo, o déjalo en marcha a propósito con una tarea clara si es un trabajo largo en segundo plano. Cierra las pestañas. Levántate. Parar forma parte de la orden, no es un añadido, porque una sesión que no para se filtra en la siguiente y la emborrona.
Algunos operadores formalizan esto como una orden real: una instrucción breve guardada que pegan o invocan al final de la sesión y que pide al agente que ejecute las comprobaciones finales, resuma el estado, enumere las preguntas abiertas y redacte la nota de relevo. Es buena idea, y hace el ritual lo bastante fácil como para cumplirlo siempre. Eso sí, la orden vale lo que valga tu disposición a leer lo que produce. No se trata de automatizar el final. Se trata de asegurarse de que el final ocurra.
Esta semana, termina cada sesión con los cuatro pasos, en orden, aunque estés cansado, aunque la sesión haya ido mal. Sobre todo si ha ido mal. Una mala sesión con una buena nota se recupera mañana en cinco minutos. Una mala sesión sin nota suele seguir siendo mala durante días. La orden de terminar es lo que convierte una hora de esfuerzo en una hora de progreso, y cuesta menos que el esfuerzo que protege.
Fig. 19 · La orden de terminar. La orden de terminar en cuatro pasos: verificar, entregar, anotar y parar.
Capítulo 20 · Parte II
Cerrar el día
El cierre son los últimos veinte minutos de la jornada operativa, y es la parte que la mayoría de los operadores se salta. Parece opcional. El trabajo está hecho, o no lo está, y nada cambiará si lo dejas para mañana. Pero el cierre no va de hoy. Va de la revisión de mañana por la mañana, y de la tarde y la noche que hay entre ambas.
Empieza anotando lo que se entregó. Mira los tres de hoy y marca cada uno. Apunta cualquier otra cosa que haya terminado. Lleva un minuto y tiene un efecto desproporcionado para su tamaño: convierte una vaga sensación de haber estado ocupado en un registro concreto de lo que cambió. Los días buenos, el registro satisface. Los días malos, informa. En ambos casos es mejor que la sensación que te habrías llevado a la cama.
Luego anota lo que sigue abierto. Cada hilo a medio vuelo, cada revisión a medio hacer, cada pregunta cuya respuesta esperas de alguien. Para cada una, una línea: cómo está y cuál es el siguiente movimiento. Si has ido escribiendo notas de relevo al final de cada sesión, este paso consiste sobre todo en reunirlas. Si no, aquí es donde descubres por qué deberías.
Luego escribe el mañana. No un plan completo, que es tarea de la revisión de la mañana, sino un empujoncito: lo primero que piensas mirar y quizá un candidato para uno de los tres de mañana. Empezar la mañana con una sugerencia de tu yo del pasado hace la revisión mucho más rápida. También te permite soltar cualquier preocupación que siga rondando. Si algo te inquieta, escríbelo en esta sección, para que tenga un sitio donde vivir que no sea tu cabeza.
Escribe el mañana para que esta noche pueda ser esta noche.
Luego para. Decide qué agentes, si alguno, seguirán trabajando de noche, y asegúrate de que cada uno tiene una tarea clara y acotada y una comprobación que pueda ejecutar. Pausa todo lo que no necesite correr. Cierra el portátil. Parar no es un premio por haber terminado; es una pieza estructural de la máquina. Un operador que nunca para no saca más trabajo. Saca el mismo, peor, con menos juicio, y descubre el coste solo cuando una revisión cansada deja pasar algo que debería haberse cazado.
Hay una tentación, sobre todo cuando hay agentes en marcha, de asomarse una vez más después del cierre. Quizá el hilo haya terminado. Quizá haya algo interesante. Resiste. Lo que haya pasado seguirá ahí por la mañana, y la revisión de la mañana está diseñada para tratarlo con calma. Mirar a altas horas sustituye una revisión matinal tranquila por una nocturna ansiosa, que es un mal negocio se mire como se mire.
Esta noche, haz un cierre como es debido. Veinte minutos: entregado, pendiente, mañana, parar. Luego fíjate en cómo va la revisión de mañana. La mayoría descubre que es más rápida, más tranquila y más resolutiva. El cierre no solo termina el día. Empieza el siguiente, en silencio, mientras no miras.
Fig. 20 · Cerrar el día. Una nota de cierre recoge lo entregado, lo abierto, el mañana y el parar, cada uno con su fin.
Parte III
Encargos que los agentes puedan seguir
Objetivo, contexto, restricciones y final.
Capítulo 21 · Parte III
Un encargo es un contrato
Un encargo es el documento que convierte tu intención en el trabajo de un agente. Puede ser una sola frase o una página, tecleado en una caja de chat o guardado como archivo, pero en todos los casos hace lo mismo: dice qué quieres, qué necesita saber el agente, qué no debe hacer y cómo vas a juzgar el resultado. Cuando el encargo es bueno, el trabajo suele ser bueno. Cuando el encargo es pobre, el trabajo suele ser pobre de una forma impresionante y segura de sí misma.
Ayuda pensar en el encargo como un contrato y no como una petición. Una petición es algo que esperas que se cumpla. Un contrato es algo que ambas partes pueden contrastar después. La diferencia aparece a la hora de revisar. Si tu encargo decía mejora la página de inicio, no tienes forma de saber si el resultado lo cumple, porque casi cualquier cambio puede defenderse como mejora. Si tu encargo decía el titular de la página de inicio cabe en una línea en un móvil y el botón de registro se ve sin hacer scroll, puedes comprobarlo en diez segundos.
Un contrato útil tiene cuatro partes, apiladas de arriba abajo. El objetivo: una frase, formulada como resultado. El contexto: lo que el agente necesita saber y no puede descubrir con facilidad, como quién es el público, qué archivos importan o qué se probó antes. Las restricciones: qué no debe cambiar, qué herramientas o enfoques están vetados, hasta dónde puede llegar el trabajo. Y la definición de terminado: las comprobaciones que os dirán a los dos que el trabajo está acabado. La última capa es el cimiento, y por eso está abajo. Todo lo que hay encima depende de ella.
Si no puedes comprobarlo, no lo pediste. Lo esperaste.
No todos los encargos necesitan las cuatro partes por escrito. Una tarea pequeña en un proyecto conocido quizá solo necesite un objetivo y una comprobación, porque el contexto y las restricciones ya viven en la memoria del proyecto. Pero merece la pena repasar mentalmente las cuatro partes cada vez, porque la que te saltas suele ser la que da problemas. La falta de contexto produce un trabajo plausible apuntado al blanco equivocado. La falta de restricciones produce un trabajo que se desparrama hacia sitios que no querías que se tocaran. La falta de definición de terminado produce discusiones contigo mismo a la hora de revisar.
Escribir encargos así también cambia cómo piensas el trabajo antes de que empiece. A menudo, cuando te sientas a escribir la definición de terminado, descubres que no sabes qué es terminado. No es un fallo del encargo. Es el encargo haciendo su trabajo pronto, antes de que un agente se pase una hora construyendo hacia un blanco que no habías elegido.
Esta semana, toma las tres próximas tareas que normalmente despacharías en una frase y escríbelas como contratos de cuatro partes. Que cada parte sea breve, una o dos líneas. Luego compara los resultados con los que sueles obtener. Los agentes no se han vuelto más listos. Simplemente les has dicho, por primera vez, qué aspecto tendría lo listo.
Fig. 21 · Un encargo es un contrato. Un encargo apila objetivo, contexto, restricciones y final, y cada capa que falta tiene un coste.
Capítulo 22 · Parte III
Empieza por el final
Si solo cambias un hábito en tu forma de hacer encargos a los agentes, cambia este: escribe la definición de terminado antes de escribir la tarea. No después, como ocurrencia tardía, ni de forma implícita, dando por hecho que el agente lo sabrá. Primero. Es la forma más fiable de mejorar la calidad de lo que vuelve.
La razón es que «terminado» es donde vive tu juicio. La descripción de la tarea dice en qué trabajar; la definición de terminado dice qué vas a aceptar. Un agente puede trabajar con competencia en casi cualquier cosa, pero no puede leer tus estándares en el aire. Cuando no sabe qué vas a aceptar, hace una suposición razonable, y las suposiciones razonables se equivocan justo con la frecuencia suficiente para salir caras.
Escribir primero el final te protege además de una trampa concreta. Si escribes primero la tarea, la definición de terminado tiende a tomar la forma de la tarea: añade un filtro a la tabla se convierte en la tabla tiene un filtro. Eso es circular. Si escribes primero el final, partes del resultado que de verdad te importa: un usuario encuentra los pedidos del mes pasado en menos de diez segundos. La tarea se deriva de ahí, y puede resultar ser un filtro, o una caja de búsqueda, o un orden por defecto. Empezar por el final deja sitio a una tarea mejor que la primera que se te ocurrió.
La tarea es el cómo. El final es el porqué. Escribe primero el porqué.
Las buenas definiciones de terminado comparten algunos rasgos. Son observables: alguien podría comprobarlas sin leerte la mente. Son concretas: nombran un número, un comportamiento o un estado en lugar de una cualidad. E incluyen al menos una comprobación que fallaría si faltara el trabajo. Todos los tests pasan es débil, porque puede que todos los tests pasaran antes de empezar. Un test nuevo cubre el caso del archivo vacío, falla con el código actual y pasa tras el cambio es sólido, porque demuestra que el cambio hizo algo.
Para el trabajo que no es código, el principio es idéntico. Un informe está terminado cuando responde a las tres preguntas para las que se encargó, cita una fuente para cada afirmación y cabe en dos páginas. Un diseño está terminado cuando funciona a ancho de móvil, no tiene texto por debajo de un tamaño fijado y usa solo los colores acordados. Un correo está terminado cuando se lee en menos de un minuto y pide exactamente una cosa. Ninguno es difícil de escribir. Todos se omiten habitualmente.
Una vez que tienes la definición de terminado, dásela al agente y pídele que se contraste con ella antes de informar. Muchos agentes ya lo hacen con naturalidad si se lo pides: ejecutan las comprobaciones, citan los resultados y señalan lo que no llega al listón. Eso convierte tu revisión de una inspección abierta en una confirmación, que es más rápida y muchísimo menos agotadora.
Esta semana, escribe Terminado cuando: como primera línea de cada encargo, y rellénala antes que nada. Si ves que no puedes, detente y piensa, porque el trabajo aún no está listo para delegarse. Está listo para decidirse.
Fig. 22 · Empieza por el final. Empezar por el final abre varias tareas posibles y exige una comprobación que pueda fallar.
Capítulo 23 · Parte III
Contexto, no biografía
Los agentes necesitan contexto. Necesitan saber cosas de tu proyecto, de tu público y de tu situación que no pueden descubrir mirando. La dificultad es que tú sabes muchísimo, y casi todo es irrelevante para cualquier tarea concreta. El arte del encargo consiste en dar el contexto que la tarea necesita y nada más: contexto, no biografía.
Imagina dos círculos que se solapan. Uno contiene todo lo que sabes: la historia del proyecto, tus preferencias, las manías del cliente, los tres enfoques que descartaste la primavera pasada, tu opinión sobre los puntos y coma. El otro contiene todo lo que la tarea necesita para hacerse bien. El encargo debería contener la intersección y muy poco más. Demasiado poco, y el agente trabaja a ciegas. Demasiado, y el agente da peso a cosas que no importan o pierde el detalle importante entre el ruido.
Compartir de más es el problema más común entre los operadores concienzudos. Les preocupa que al agente se le escape algo, así que lo incluyen todo. El encargo crece hasta una página de historia, salvedades y apartes. El agente, que se toma en serio todo lo que tiene delante, intenta ahora honrarlo todo. Una mención de pasada a que al cliente una vez no le gustó el azul se convierte en una restricción de diseño. Un enfoque antiguo y abandonado, descrito como trasfondo, resucita en parte. El trabajo vuelve moldeado por la biografía y no por la tarea.
Cada frase de un encargo es una instrucción, la quisieras como tal o no.
Una buena prueba para cualquier dato de contexto es preguntarse: si quitara esta frase, ¿sería plausiblemente peor el resultado? Si la respuesta es sí, déjala. Si no estás seguro, déjala pero aclara su estatus: solo como trasfondo, no actúes sobre esto. Si es no, quítala. Siempre puedes añadir contexto en un mensaje posterior si el agente lo pide o si el resultado demuestra que hacía falta.
La otra mitad de la habilidad es darse cuenta de lo que el agente no puede encontrar por sí mismo. Los agentes que trabajan en un repositorio pueden leer el código; no necesitan que se lo describan. Lo que no pueden leer son tus conversaciones con el cliente, la decisión que tomaste en la ducha o el hecho de que el servidor de pruebas está caído esta semana. Eso es exactamente lo que hay que incluir. Señala lo que pueden encontrar, cuéntales lo que no.
También conviene separar el contexto estable del contexto de la tarea. El contexto estable, lo que es cierto en muchas tareas, pertenece a la memoria del proyecto, donde lo verá cada sesión. El contexto de la tarea, lo que importa solo aquí, pertenece al encargo. Mezclar ambos significa repetirte en cada encargo o, peor, olvidarte de hacerlo y obtener resultados incoherentes. Una parte posterior de este libro trata la memoria en detalle.
Esta semana, toma un encargo que ya hayas escrito y recórrelo frase a frase con la prueba de quitar. Elimina todo lo que no la supere. Luego envía el encargo más corto y compara. A la mayoría de los operadores les sorprende que menos contexto produzca un trabajo más afilado. A los agentes, como a las personas, les va mejor cuando se les dice lo que importa y no todo lo que ha pasado alguna vez.
Fig. 23 · Contexto, no biografía. El encargo solo contiene lo que la tarea necesita y el agente no puede descubrir por sí mismo.
Capítulo 24 · Parte III
Las restricciones son un favor
Puede parecer poco generoso llenar un encargo de restricciones. No cambies la interfaz pública. No añadas dependencias. No toques el código de facturación. Que no pase de trescientas palabras. Usa solo los colores existentes. Se lee como una lista de prohibiciones, y mucha gente instintivamente la suaviza o la omite, esperando que el agente use el sentido común. Pero las restricciones no son falta de confianza. Son un favor, al agente y a tu yo futuro.
Un agente sin restricciones tiene que adivinar dónde están los bordes de la tarea. ¿Debería refactorizar la función desordenada de al lado ya que está? ¿Debería actualizar la dependencia que lanza un aviso? ¿Debería reescribir la introducción, ya que la introducción también flojea? Cada una de estas cosas es razonable, y cada una amplía el cambio, la revisión y el riesgo. Los agentes tienden a ser serviciales, y la amabilidad sin bordes se desparrama.
Con restricciones, el agente puede concentrarse. Sabe qué puede tocar y qué no, así que gasta su esfuerzo dentro del perímetro. El trabajo vuelve más pequeño, más coherente y mucho más fácil de revisar. No tienes que pasarte veinte minutos averiguando qué partes de un cambio grande eran la tarea y cuáles eran entusiasmo.
Una valla no es una jaula. Es la descripción del jardín.
Las restricciones más útiles caen en unas pocas familias. Las de alcance dicen qué puede cambiar: estos archivos, esta sección, solo esta funcionalidad. Las de interfaz dicen qué no debe cambiar: la API, la estructura de URL, el tono de voz, el formato de datos. Las de herramientas dicen cómo puede hacerse el trabajo: sin librerías nuevas, sin llamadas de red, sin cambios en la configuración. Y las de tamaño dicen cuán grande puede ser el resultado: un número de palabras, de líneas, de opciones. Elige las que importan para la tarea. Normalmente bastan dos o tres.
Hay un hábito complementario que hace que las restricciones funcionen aún mejor: pide al agente que te avise cuando una restricción le estorbe. A veces el arreglo correcto exige de verdad cambiar la interfaz o añadir una librería. Quieres saberlo, pero quieres decidirlo tú, no descubrirlo en el diff. Una línea como si crees que conviene saltarse una restricción, detente y explica por qué antes de hacerlo convierte las restricciones de muros en puntos de control.
Las restricciones son también un registro. Cuando vuelvas a mirar un encargo dentro de un mes, las restricciones te dirán qué estabas protegiendo y por qué. Eso suele ser más útil que la descripción de la tarea, porque captura las partes del proyecto que en aquel momento considerabas frágiles o importantes.
Esta semana, añade una línea No hagas a cada encargo, con dos o tres restricciones concretas. Fíjate en cómo encoge el tamaño de los cambios resultantes y en cuánto se aceleran las revisiones. No has limitado al agente. Le has dado una dirección, que es algo distinto y mucho más útil.
Fig. 24 · Las restricciones son un favor. Cuatro familias de restricciones vallan la tarea y dejan fuera los extras tentadores.
Capítulo 25 · Parte III
Nombra los archivos y las pruebas
La forma más rápida de mejorar un encargo es sustituir descripciones por punteros. En lugar de la parte del código que gestiona las subidas, escribe la ruta del archivo. En lugar de el comando de tests de siempre, escribe el comando. En lugar de un estilo como el de nuestras otras páginas, nombra una página. Un puntero es más corto que una descripción, más preciso e imposible de malinterpretar.
Los agentes siguen punteros de maravilla. Dale una ruta y abrirá el archivo, lo leerá y se orientará. Dale una descripción y buscará, encontrará varios candidatos, elegirá el más plausible y seguirá adelante. Casi siempre elige bien. Cuando elige mal, lo hace con aplomo, y descubres el error a la hora de revisar, después de que el trabajo se haya construido sobre los cimientos equivocados. Copiar una ruta te cuesta cinco segundos. Ahorra la búsqueda del agente y tus dudas.
Lo mismo vale para los ejemplos. Si quieres que un componente nuevo se parezca a uno existente, señala el existente. Si quieres un informe con la misma estructura que el del mes pasado, señala el del mes pasado. Si quieres el tono de un correo concreto, pégalo o enlázalo. Los ejemplos llevan una cantidad enorme de instrucciones implícitas que exigirían párrafos para describirse y que, aun así, se describirían de forma imperfecta.
Y vale, sobre todo, para las comprobaciones. Nombra el comando, la página, la consulta o el test exactos que confirmarán el trabajo. No asegúrate de que funciona, sino ejecuta npm test y el test nuevo de upload.test.ts debe pasar. No comprueba que se ve bien, sino carga /pricing a ancho de móvil y confirma que nada se desborda. Una comprobación con nombre es algo que el agente puede ejecutar de verdad, y algo que tú puedes confirmar de verdad. Una comprobación sin nombre es una aspiración.
Un puntero es una frase que el agente no puede malinterpretar.
Este hábito rinde dos veces. Una en la calidad del primer intento, porque el agente empieza en el sitio correcto con el modelo correcto. Y otra en la revisión, porque sabes exactamente dónde mirar. Si el encargo nombraba tres archivos y una comprobación, tu revisión empieza por esos tres archivos y esa comprobación. No andas rebuscando en un cambio grande intentando reconstruir qué pretendía hacer.
También deja al descubierto las lagunas de tu propia comprensión. Si te sientas a nombrar los archivos y te das cuenta de que no sabes cuáles intervienen, es valioso saberlo antes de que empiece el agente. Puedes pedirle que lo averigüe primero, como una tarea pequeña aparte: enumera los archivos que intervienen en las subidas y describe cada uno en una línea. Luego encarga el trabajo de verdad con los punteros en la mano. Dos tareas pequeñas con buenos punteros suelen ganar a una grande con punteros vagos.
Esta semana, lee cada encargo antes de enviarlo y subraya cada descripción que podría ser un puntero. Sustituye cada una: una ruta, un ejemplo, un comando. Durante unos dos días parece pedante. Después parece la forma obvia de escribir, y los encargos vagos que solías enviar empiezan a parecer acertijos que planteabas sin ningún buen motivo.
Fig. 25 · Nombra los archivos y las pruebas. Descripciones cambiadas por punteros a archivos, ejemplos y pruebas que el agente puede ejecutar.
Capítulo 26 · Parte III
El encargo de un párrafo
Casi todos los encargos caben en un párrafo. No todos, y las excepciones existen, pero casi todos. Una frase de objetivo, una o dos de contexto, una de restricciones y una de terminado. Cinco o seis frases, unas cien palabras, y el agente tiene todo lo que necesita. Si tus encargos ocupan habitualmente una página, merece la pena preguntarse por qué.
La razón habitual es que el pensamiento no estaba terminado cuando empezó la escritura. Un encargo largo suele ser el registro del operador averiguando qué quiere: opciones consideradas, preocupaciones expresadas, medias decisiones sin cerrar. Todo ese pensamiento era necesario. Nada de él tiene que estar en el encargo. El encargo es la conclusión, no las cuentas en sucio.
Así que trata el encargo de un párrafo como una disciplina. Escribe primero con libertad si lo necesitas, en un cuaderno o en un archivo de borrador. Luego destila: toma todo lo que sabes, quédate solo con lo que la tarea necesita y comprímelo en un párrafo. Si no puedes comprimirlo, hay dos explicaciones probables. O la tarea son en realidad varias tareas y debería dividirse, o aún no has decidido algo que el agente necesitará tener decidido. Las dos cosas merecen descubrirse antes de empezar.
Un encargo largo suele ser un encargo corto que no ha terminado de escribirse.
Esta es la forma, en prosa y no como plantilla. Objetivo: los usuarios pueden exportar sus elementos guardados como hoja de cálculo desde la página de cuenta. Contexto: la página de cuenta está en app/account, los elementos guardados salen de la consulta items existente y ya usamos una librería de exportación a hoja de cálculo en reports/. No hagas: añadir dependencias nuevas ni cambiar la consulta de elementos. Terminado cuando: aparece un botón de exportación nuevo, el archivo exportado se abre en un programa de hojas de cálculo con una fila por elemento y un test cubre el caso vacío. Ese es todo el encargo. Un agente puede hacer un trabajo excelente a partir de él, y tú puedes revisar ese trabajo en diez minutos.
Hay excepciones honestas. Un encargo para un trabajo grande de varios pasos puede necesitar más estructura: una lista breve de fases, cada una con su propio terminado. Un encargo creativo puede necesitar ejemplos que ocupan espacio. Un encargo para un trabajo delicado en un terreno poco familiar puede necesitar más contexto de lo habitual. Pero incluso entonces, la versión de un párrafo es un primer paso útil. Escríbela y añade después solo lo que el párrafo de verdad no puede cargar.
Los encargos cortos tienen otra virtud fácil de pasar por alto: son reutilizables. Un párrafo puede guardarse, adaptarse y volver a enviarse el mes que viene cambiando unas palabras. Una página de pensamiento enredado, no. Con el tiempo, un operador que escribe encargos de un párrafo acumula una biblioteca de ellos, y una biblioteca de buenos encargos es uno de los activos más valiosos que puede tener una operación unipersonal.
Esta semana, ponte un límite de un párrafo por encargo. Cuando lo superes, detente y pregúntate cuál de las dos explicaciones se aplica: demasiadas tareas o pocas decisiones. Arregla eso en lugar de escribir más. El párrafo te lo agradecerá, y el agente también.
Fig. 26 · El encargo de un párrafo. Las notas sueltas se destilan en un párrafo de cuatro partes, o revelan una división o una decisión.
Capítulo 27 · Parte III
Señala el desvío
Ningún encargo sobrevive del todo intacto al contacto con el trabajo. El agente abre el archivo y descubre que la función que nombraste ya no existe. La librería que le pediste usar no admite el formato que necesitas. La restricción que pusiste, con toda la razón, hace imposible la tarea tal como está especificada. En ese momento el agente tiene una elección: hacer otra cosa en silencio o decírtelo. Quieres que te lo diga, siempre, y tienes que pedírselo explícitamente.
Si se les deja a su aire, los agentes tienden a adaptarse. En general es una virtud; no quieres un agente que se pare ante cada pequeña sorpresa. Pero la adaptación se vuelve un problema cuando cruza una línea que te importaba. Si el agente decide por su cuenta añadir una dependencia, cambiar una interfaz, saltarse una comprobación que fallaba o reinterpretar el objetivo, lo descubrirás solo a la hora de revisar, si es que lo descubres. El trabajo parecerá completo. Simplemente será un trabajo distinto del que pediste.
El remedio es una única instrucción fija, que va en cada encargo o, mejor, en la memoria del proyecto: si necesitas apartarte del encargo, señálalo claramente al principio de tu informe, explica por qué y, si el desvío es significativo, detente y pregunta antes de seguir. Es una línea pequeña que cambia la forma de la colaboración. El agente sigue adaptándose a las sorpresas pequeñas, pero los desvíos significativos llegan como preguntas y no como hechos consumados.
Un desvío silencioso es una decisión que otro tomó por ti.
¿Qué cuenta como significativo? Depende del proyecto, pero algunos desvíos deberían señalarse siempre: cambiar cualquier cosa que figure como restricción, añadir o quitar dependencias, alterar una interfaz pública, saltarse o debilitar un test, cambiar la interpretación del objetivo o tocar archivos fuera del alcance indicado. Puedes enumerarlos una vez en tu archivo de memoria y remitirte a ellos para siempre.
Cuando se señale un desvío, trátalo como un punto de decisión, no como una molestia. A veces el agente tiene razón y el encargo estaba mal: la función cambió de nombre, la librería no puede hacerlo, la restricción se basaba en una suposición antigua. Aprueba el desvío y, si importa, actualiza el encargo o la memoria para que no se repita la misma sorpresa. A veces el agente se equivoca: ha malinterpretado la restricción o ha tomado un atajo. Reoriéntalo. En cualquier caso, la decisión la tomaste tú, y el trabajo que vuelve es el que elegiste.
Con el tiempo, los desvíos señalados se convierten en una de tus mejores fuentes de información sobre un proyecto. Te dicen dónde divergieron el encargo y la realidad, lo que suele significar que tu modelo mental del proyecto está desfasado en algún punto. Un operador que lee con atención los desvíos aprende más sobre su propio sistema que uno que se limita a revisar diffs.
Esta semana, añade la instrucción del desvío a cada encargo, o ponla una vez en la memoria del proyecto. Luego mira lo que vuelve. Verás el juicio del agente de una forma nueva: no escondido dentro del trabajo, sino expuesto delante de ti, donde puedes darle la razón, desautorizarlo o aprender de él.
Fig. 27 · Señala el desvío. Un desvío se avisa al principio del informe para que el operador decida.
Capítulo 28 · Parte III
Los ejemplos ganan a los adjetivos
Los adjetivos son las palabras más débiles de un encargo. Que quede limpio. Que sea profesional. Que sea cercano pero no demasiado informal. Que sea moderno. Cada una de estas palabras significa algo para ti y algo ligeramente distinto para el agente, y la distancia entre ambos significados es de donde sale el trabajo decepcionante. El remedio es sustituir los adjetivos por ejemplos siempre que puedas.
Un ejemplo lleva muchísima más información que un adjetivo. Cercano pero no demasiado informal podría describir mil tonos. Pegar dos correos que has escrito y que dan con la nota justa describe exactamente uno. Maquetación limpia es una aspiración vaga. Señalar una página cuya maquetación admiras es una especificación. El agente puede ver el ejemplo, notar sus rasgos y reproducirlos, incluidos rasgos que nunca se te habría ocurrido describir porque no eras consciente de ellos.
Piensa en las formas posibles de pedir algo como repartidas en dos ejes. Uno es la precisión: lo concreta que es la petición. El otro es mostrar frente a contar: si describes lo que quieres o señalas un caso de ello. Contar con vaguedad es donde viven los adjetivos, y produce los resultados más variables. Mostrar con precisión, un ejemplo real con una nota sobre qué conservar, produce los más fiables. Ese rincón es donde quieres que vivan tus encargos.
No se puede describir un gusto. Se puede compartir una muestra.
Hay varias formas de usar bien los ejemplos. Señala el ejemplo y di qué tomar de él: iguala la estructura y el tono de este informe, pero no su extensión. Da más de un ejemplo cuando quieras que el agente infiera un patrón en lugar de copiar un caso único. Da un contraejemplo cuando haya un fallo frecuente que quieras evitar: no como este, que es demasiado formal. Y cuando no tengas ejemplo, pide al agente que produzca primero dos o tres opciones breves, luego elige una y úsala como ejemplo para el trabajo de verdad.
Los ejemplos funcionan más allá de la escritura y el diseño. Para datos, muestra una muestra del formato de salida que quieres. Para código, señala una función existente escrita en el estilo que prefieres. Para investigación, muestra un resumen que te resultó útil y pide más como ese. En cada caso, el ejemplo hace el trabajo que un párrafo de adjetivos intentaría hacer sin conseguirlo.
Merece la pena reunir una pequeña colección de ejemplos a los que vuelvas a menudo: unos cuantos textos con tu voz, unos cuantos diseños con tu estilo, unos cuantos informes con la forma que prefieres. Guárdalos en un sitio a mano. Cuando escribas un encargo, recurre primero a ellos. Con el tiempo se convierten en una especie de gusto portátil, una forma de transmitir tus estándares a un agente en segundos en lugar de describirlos de nuevo cada vez.
Esta semana, busca cada adjetivo en tus tres próximos encargos y pregúntate si un ejemplo podría sustituirlo. Donde pueda, cámbialo. El trabajo que vuelva se sentirá más tuyo porque, de una forma pequeña pero real, estará construido con piezas tuyas.
Fig. 28 · Los ejemplos ganan a los adjetivos. Precisión frente a mostrar: un ejemplo real con notas gana a un montón de adjetivos.
Capítulo 29 · Parte III
Encargos que sobreviven a la sesión
Algunos encargos son de usar y tirar. Muchos no. Si te descubres escribiendo más o menos el mismo encargo por tercera vez, preparar un resumen semanal, revisar una pull request, redactar una actualización para un cliente, limpiar un conjunto de datos, entonces el encargo ya no es un encargo. Es una receta, y las recetas merecen escribirse como es debido y guardarse.
Casi todas las herramientas de agentes ofrecen ya alguna forma de guardar y reutilizar instrucciones: prompts guardados, comandos personalizados, skills, plantillas o archivos de proyecto que un agente puede cargar cuando se le pide. Los nombres y la mecánica varían y seguirán cambiando. El principio no. Una tarea recurrente debería tener un encargo recurrente, guardado en algún sitio donde tú y los agentes podáis encontrarlo, y refinado cada vez que se usa.
El truco está en no escribir la receta demasiado pronto. Una receta escrita tras una sola ejecución es una conjetura sobre lo que importará. Una receta escrita tras tres o cuatro ejecuciones a mano captura lo que de verdad aprendiste: el contexto que hacía falta una y otra vez, la restricción que tenías que añadir siempre, la comprobación que cazó el problema dos veces. Así que el ciclo va en un orden concreto. Haz la tarea a mano unas cuantas veces con encargos normales. Luego destila lo que funcionó en una receta. Luego reutilízala, fijándote en dónde se queda corta, y lleva esas notas a la versión siguiente.
Hazlo tres veces antes de escribirlo. Luego no vuelvas a escribirlo nunca.
Una buena receta parece un buen encargo con las partes variables marcadas. El objetivo es fijo, o casi. El contexto es casi todo estable, con un hueco para los detalles de esta ejecución. Las restricciones son fijas. La definición de terminado es fija. Cuando la usas, rellenas los huecos y todo lo demás viene gratis. Muchos operadores guardan las recetas como archivos de texto plano con una cabecera breve que dice cuándo usarlas, un formato que sobrevivirá a cualquier herramienta concreta.
Las recetas también llevan tus estándares hacia delante. En cuanto una receta incluye la comprobación que caza un error frecuente, todas las ejecuciones futuras la incluyen, te acuerdes o no de pedirla. Es una de las formas más discretas en que una operación mejora con el tiempo. Cada error cazado se convierte en una línea de una receta, y cada receta hace la siguiente ejecución un poco más segura que la anterior.
Cuidado con la receta que se pudre. Una receta escrita hace seis meses puede referirse a archivos que se han movido, herramientas que han cambiado o estándares que ya no sostienes. Cuando una receta produzca un mal resultado, revisa la receta antes de culpar al agente. A menudo el arreglo es una línea o dos, y hacerlo mejora todas las ejecuciones futuras. Un repaso breve de todas tus recetas una vez por trimestre, borrando las que no se usan y actualizando las rancias, mantiene honesta la colección.
Esta semana, repasa tus encargos recientes y busca uno que hayas escrito tres o más veces. Conviértelo en receta: objetivo, contexto con huecos, restricciones, terminado. Guárdala donde la vayas a encontrar. La próxima vez que surja la tarea, usa la receta en lugar de escribir desde cero, y mira cuánta atención te devuelve.
Fig. 29 · Encargos que sobreviven a la sesión. Haz una tarea a mano unas veces, escríbela como receta con huecos, y luego reutilízala y mejórala.
Capítulo 30 · Parte III
La biblioteca de recetas
Con los meses, un operador en activo acumula un conjunto de recetas: encargos reutilizables para las tareas que surgen una y otra vez. Al principio viven donde se escribieron, desperdigadas por carpetas e hilos. En algún momento merece la pena reunirlas en un solo sitio, una biblioteca, y tratar esa biblioteca como uno de los activos centrales de la operación. Bien puede ser lo más valioso que tienes que no sea una relación con un cliente.
¿Por qué importa más una biblioteca que las recetas sueltas? Porque cambia cómo piensas el trabajo nuevo. Cuando llega una tarea, tu primer movimiento ya no es escribir un encargo. Es consultar la biblioteca. A menudo hay una receta que encaja exactamente, o una que encaja con un pequeño cambio. Rellenas los huecos y la envías. La tarea se beneficia de cada lección que se metió en la receta, y tú gastas tu atención en las partes que de verdad son nuevas.
Una biblioteca tiene una forma natural. Las recetas se agrupan en torno a las actividades principales de la operación: revisar trabajo, entregarlo, investigar preguntas, redactar documentos, mantener herramientas. Puede que tengas una docena de recetas en total o varias docenas, pero suelen caer en cuatro o cinco familias. Organizarlas por familia las hace más fáciles de encontrar y te muestra dónde están los huecos. Si tienes seis recetas de redacción y ninguna de revisión, eso te dice algo sobre dónde están escritos tus estándares y dónde solo están en tu cabeza.
Una biblioteca de buenas recetas es la operación, puesta por escrito.
Guarda la biblioteca en un formato sencillo y portátil. Archivos de texto en una carpeta, con control de versiones si es posible, y un índice breve que enumere cada receta y cuándo usarla. Las herramientas van y vienen; el texto plano sobrevive. Si tus herramientas permiten cargar recetas como comandos o skills, conéctales la biblioteca sin dudarlo, pero conserva la fuente en una forma que podrías llevarte mañana a otra herramienta sin perder nada.
Cuida la biblioteca como cuidarías cualquier activo importante. Cuando se use una receta, anota si funcionó. Cuando se quede corta, arréglala enseguida, mientras el problema está fresco. Cuando dos recetas se solapen, fusiónalas. Cuando una receta lleve meses sin usarse, retírala a un archivo. Una biblioteca cuidada sigue siendo útil. Una biblioteca que solo crece se convierte en un cajón de sastre, y nadie consulta un cajón de sastre cuando tiene prisa.
Hay un beneficio más que merece nombrarse. Una biblioteca de recetas es la forma en que otra persona puede entender una operación unipersonal. Si alguna vez incorporas ayuda, un colaborador o un contratista, la biblioteca es la forma más rápida de enseñarle cómo se hace el trabajo. También es como entenderás tu propia operación al volver de vacaciones, cuando hayas olvidado casi todos los detalles y necesites recuperarlos deprisa. La biblioteca recuerda por ti.
Esta semana, crea la biblioteca si no la tienes: una carpeta, un archivo de índice y las recetas que ya tengas, trasladadas a ella. Ordénalas por familias. Anota los huecos. Luego, la próxima vez que llegue una tarea, abre primero la biblioteca. Ese pequeño reflejo es el principio de una operación que se mejora a sí misma.
Fig. 30 · La biblioteca de recetas. Una biblioteca de recetas por familias muestra dónde tus estándares aún no están escritos.
Parte IV
Memoria y notas
Lo que la máquina ya debería saber.
Capítulo 31 · Parte IV
La memoria es infraestructura
Los agentes empiezan casi todas las sesiones sin saber nada de ti. No recuerdan la conversación de ayer, la decisión que tomaste la semana pasada ni el motivo de que el script de compilación tenga esa línea tan rara. La continuidad que tenga tu operación la tienes que poner tú. Eso convierte la memoria, el registro escrito de lo que la máquina debería saber ya, no en un extra agradable sino en infraestructura, en el mismo sentido en que la fontanería es infraestructura. Nadie la admira. Sin ella, todo deja de funcionar.
Casi todas las herramientas de agentes ofrecen ya alguna forma de memoria persistente: un archivo de proyecto que el agente lee al principio de cada sesión, un almacén de hechos que puede actualizar, instrucciones que se aplican a todas las conversaciones de un espacio de trabajo. Los detalles varían según la herramienta y seguirán cambiando. Lo que comparten es la idea de que cierto conocimiento debería cargarse automáticamente, para que no tengas que repetirlo en cada encargo. Bien usada, es la mayor mejora de calidad de los agentes al alcance de un operador. Mal usada, es una fuente silenciosa de confusión.
Piensa en la memoria como una pila de capas. Abajo, archivos de texto plano: la forma más duradera y portátil, legible por cualquier herramienta y por ti. Encima, notas y registros: tu crónica continua de lo que pasó y por qué. Encima de estos, la memoria del proyecto: el conjunto seleccionado de hechos y reglas que los agentes de cada proyecto cargan cada vez. Y arriba del todo, tu criterio, que decide qué entra en cada capa y qué sale. La capa de memoria del proyecto es donde está casi toda la palanca, porque es lo que los agentes ven de verdad.
Lo que no escribes, lo volverás a explicar. Una y otra vez.
Tratar la memoria como infraestructura cambia algunos hábitos. Le dedicas tiempo de mantenimiento, en lugar de actualizarla solo cuando algo sale mal. Revisas sus cambios con el mismo cuidado que darías a un cambio en el código, porque una mala línea en la memoria afecta a todas las sesiones futuras. La guardas en texto plano siempre que puedes, porque la infraestructura debería sobrevivir a las herramientas que se construyen encima. Y la diseñas para sus lectores: primero los agentes y, en segundo lugar, tú, cuando vuelvas a un proyecto tras meses fuera.
Hay también un cambio mental útil. Cada vez que te descubres explicando lo mismo dos veces a un agente, eso es un fallo de memoria. El remedio no es explicarlo una tercera vez, sino escribirlo en la capa adecuada para que se sepa a partir de ahora. Cada vez que un agente comete un error porque no sabía algo, eso también es un fallo de memoria. Colecciónalos. Son las órdenes de trabajo de tu infraestructura de memoria.
Esta semana, elige tu proyecto más activo y mira qué cargan sus agentes al principio de una sesión. Si la respuesta es nada, empieza un archivo de memoria. Si ya hay uno, léelo como si fueras un agente nuevo y marca todo lo que esté mal, desfasado o ausente. Luego arréglalo. Parecerá limpieza doméstica. Se parece más a tender tuberías, y el agua correrá mejor durante meses.
Fig. 31 · La memoria es infraestructura. La memoria en capas: la del proyecto es la que leen los agentes, y sus fallos son órdenes de trabajo.
Capítulo 32 · Parte IV
Lo que el agente ya debería saber
Un archivo de memoria del proyecto es un documento breve que un agente lee al principio de cada sesión en ese proyecto. Su función es responder de antemano a las preguntas que haría cualquier recién llegado competente en su primera mañana. ¿Para qué es este proyecto? ¿Cómo lo compilo, lo pruebo y lo ejecuto? ¿Cuáles son las normas aquí? ¿Dónde están las trampas? Si esas cuatro preguntas tienen buena respuesta, casi todas las sesiones empiezan en el sitio correcto sin que tengas que decir nada.
Empieza por el propósito. Una o dos frases sobre qué es el proyecto y a quién sirve. Parece innecesario, porque el agente puede leer el código, pero el código te dice qué hace algo, no para qué es. Saber que una herramienta sirve a un puñado de usuarios internos y no al público cambia muchísimas decisiones pequeñas, desde los mensajes de error hasta cuánto mimo se pone en el rendimiento.
Luego, los comandos. Los comandos exactos para instalar, compilar, probar, pasar el linter y ejecutar el proyecto, y cualquier cosa inusual sobre ellos. Es la parte más útil en la práctica, porque sin ella los agentes adivinan, y los comandos adivinados son una fuente frecuente de tiempo perdido. Si la suite de tests necesita una variable de entorno concreta o una base de datos en marcha, dilo aquí.
Luego, las reglas. Las convenciones que no son evidentes a partir del código: cómo se nombran las cosas, dónde van los archivos nuevos, cuál es el estilo de la casa al escribir, qué patrones se prefieren y cuáles se están retirando. Limítalas a las que de verdad importan y que un agente plausiblemente haría mal. Un archivo de memoria con cincuenta reglas no se sigue mejor que uno con diez. Suele seguirse peor, porque las reglas importantes quedan diluidas entre las triviales.
El archivo de memoria es la acogida que das a cada nueva incorporación, cada mañana, gratis.
Por último, las trampas. Los sitios donde las cosas se tuercen: el módulo frágil, el nombre de función engañoso, el test que falla a ratos los martes, la carpeta que parece abandonada y no lo está. Las trampas son donde la memoria se paga sola de forma más clara, porque cada una evita un error concreto y recurrente. Muchas de las mejores líneas de un archivo de memoria maduro empezaron como una nota en el informe de un incidente.
Que el archivo sea corto. Una página o dos bastan para casi cualquier proyecto. Los agentes lo leen entero en cada sesión, así que todo lo que contiene cuesta un poco de atención cada vez, y el material irrelevante puede empujar el trabajo en direcciones extrañas. Si el archivo crece, divídelo: un archivo central que se carga siempre y archivos temáticos a los que se remite cuando vienen al caso. Muchas herramientas admiten directamente este tipo de capas.
Escríbelo con frases llanas y directas, en el mismo registro que un buen encargo. Evita las declaraciones de intenciones que nadie puede comprobar, como escribe código de alta calidad. Prefiere las concretas, como cada función nueva tiene un test en el archivo correspondiente de tests/. El agente puede seguir la segunda. Ante la primera, solo puede asentir.
Esta semana, escribe o reescribe el archivo de memoria de un proyecto con los cuatro apartados: propósito, comandos, reglas, trampas. Que no pase de dos páginas. Luego empieza una sesión nueva y observa cuánto menos tienes que explicar. Ese silencio es el archivo haciendo su trabajo.
Fig. 32 · Lo que el agente ya debería saber. Un archivo de memoria del proyecto responde propósito, órdenes, reglas y trampas antes de que nadie pregunte.
Capítulo 33 · Parte IV
El cuaderno del operador
Los archivos de memoria del proyecto son para los agentes. Tú también necesitas algo para ti: un cuaderno continuo en el que anotes lo que hiciste, lo que notaste y lo que estás pensando. Es la herramienta menos glamurosa del equipo del operador y una de las más potentes, porque es el único sitio donde toda la operación, a través de todos los proyectos, es visible en un solo caudal.
El formato importa menos que el hábito. Un único archivo de texto con un encabezado fechado para cada día funciona perfectamente. También un cuaderno de papel, si lo prefieres. Lo que importa es que sea un solo sitio, que escribas en él cada día laborable y que puedas buscar u hojear después. Muchos operadores lo tienen abierto todo el día y apuntan una línea cada vez que pasa algo: una decisión tomada, una sorpresa encontrada, una idea aparcada, un hilo empezado o terminado.
¿Qué se escribe? Sobre todo líneas cortas. Entregado el arreglo del importador; las filas vacías ya se gestionan.El agente se empeñaba en usar la configuración antigua; añadida una nota a la memoria.El cliente quiere el informe una semana antes; adelantado.Idea: resumen semanal de hilos atrasados; a la cola. Ninguna de ellas es una obra literaria. Juntas forman un registro de la operación enormemente útil de maneras que no puedes prever cuando las escribes.
El cuaderno no recuerda por ti. Recuerda en tu lugar.
El cuaderno se gana el sueldo de tres maneras. Primero, alimenta el cierre y la revisión. Al final del día, hojear las entradas de hoy te dice qué se entregó y qué está abierto mucho más deprisa que reconstruirlo a partir de los hilos. Segundo, alimenta las revisiones semanales y trimestrales, de las que trata una parte posterior del libro. Repasar una semana de entradas revela patrones invisibles en el día a día: el proyecto que se atasca una y otra vez, el tipo de tarea que siempre sale mal, la hora del día en que no pasa nada bueno. Tercero, es un registro en el que puedes buscar cuando algo vuelve. Cuando un cliente pregunta por qué se hizo un cambio en marzo, el cuaderno suele tener la respuesta en una línea.
La cadena que importa es: anotarlo, releerlo, decidir. Un cuaderno que se escribe pero nunca se lee es un diario. Útil, quizá, pero no una herramienta operativa. Mete la relectura en tu ritmo: un vistazo en cada cierre, una lectura como es debido en cada revisión semanal. Cada lectura debería terminar en al menos una decisión, aunque solo sea añadir esta trampa al archivo de memoria o dejar de empezar hilos después de las cuatro.
Los agentes también pueden ayudar aquí, pero con cuidado. Un agente puede resumir una semana de entradas, extraer temas recurrentes o redactar una lista de pendientes. Es útil. Lo que un agente no debería hacer es escribirte el cuaderno, porque el acto de escribir una línea es en sí mismo un pequeño momento de reflexión, y ese momento forma parte del valor.
Esta semana, empieza el cuaderno si no lo tienes. Un archivo, un encabezado por día, una línea por cada cosa que pasó. En el cierre del viernes, lee las entradas de la semana de arriba abajo y escribe una decisión al final. Esa es toda la práctica. Va rindiendo en silencio, como hacen los buenos hábitos.
Fig. 33 · El cuaderno del operador. Las líneas del cuaderno alimentan el cierre, la revisión semanal y búsquedas futuras, y acaban en decisiones.
Capítulo 34 · Parte IV
Un registro de decisiones
Las decisiones son lo más valioso que produce un operador y lo que menos probabilidades tiene de quedar registrado. El código tiene control de versiones. Los documentos se guardan. Las pull requests tienen descripción. Pero los motivos que hay detrás, por qué este enfoque y no aquel, por qué este proyecto y no el otro, por qué quitamos la funcionalidad, suelen vivir solo en tu cabeza, donde se deterioran a una velocidad alarmante. Tres meses después miras algo y de verdad no recuerdas por qué es como es.
Un registro de decisiones lo arregla a bajo coste. Es un único archivo, por proyecto o para toda la operación, en el que anotas las decisiones significativas a medida que las tomas. Cada entrada es breve: la fecha, la decisión en una frase, el motivo en una o dos y la principal alternativa que descartaste. Nada más. Unas pocas líneas que te ahorrarán horas.
¿Por qué anotar la alternativa descartada? Porque es la parte que más necesitarás después. Cuando tú o un agente volváis sobre una decisión, la primera pregunta suele ser ¿por qué no hicimos simplemente lo otro, lo obvio? Si el registro dice se consideró el servicio de búsqueda alojado; descartado porque los resultados tenían que funcionar sin conexión, la pregunta se responde en segundos y no hay que reabrir el viejo debate. Sin esa línea, bien puedes pasarte una tarde redescubriendo el motivo o, peor, revertir la decisión sin recordar que había uno.
Anotar qué decidiste es útil. Anotar por qué es lo que te salva.
¿Qué cuenta como significativo? Una prueba aproximada es si alguien podría razonablemente preguntar por ello más adelante. Elecciones de arquitectura, cambios de alcance, abandonar o aparcar un proyecto, elegir una herramienta, cambiar un estándar, aceptar un riesgo conocido. Las pequeñas elecciones del día a día no necesitan entrada; para eso está el cuaderno. Si anotas más de unas pocas decisiones por proyecto a la semana, probablemente estás anotando demasiado.
El registro de decisiones también ayuda a los agentes. Si vive junto al proyecto, puedes remitir a él a los agentes cuando trabajen en algo afectado por una decisión anterior, o incluir un resumen breve en la memoria del proyecto. Un agente que sabe que el servicio de búsqueda se descartó por motivos de funcionamiento sin conexión no volverá a proponerlo, ni lo reintroducirá en silencio mientras arregla otra cosa. Es uno de los pocos casos en que dar historia a los agentes, y no solo el estado actual, mejora de verdad su trabajo.
Hay otro beneficio que es fácil pasar por alto. Escribir el motivo te obliga a tener uno. A veces los operadores descubren, al sentarse a anotar una decisión, que su razonamiento es más endeble de lo que creían. No es motivo para dejar de anotar. Es el registro haciendo su trabajo más útil, antes de que la decisión haya tenido consecuencia alguna.
Esta semana, empieza un registro de decisiones para tu proyecto más ajetreado. Rellena hacia atrás las tres decisiones más significativas que recuerdes del último mes, con sus motivos y sus alternativas descartadas. Luego añade entradas a medida que lleguen decisiones nuevas. Dentro de tres meses, cuando alguien pregunte por qué, tendrás el insólito placer de simplemente saberlo.
Fig. 34 · Un registro de decisiones. Una entrada del registro de decisiones con su motivo y la opción descartada responde una pregunta meses después.
Capítulo 35 · Parte IV
Notas que se leen
Los operadores escriben muchísimo: encargos, notas de relevo, archivos de memoria, entradas del cuaderno, registros de decisiones, informes de incidentes. La pregunta que importa sobre todo ello no es cuánto se escribió sino cuánto se volvió a leer, y cuánto de lo leído condujo a una decisión mejor. Imagínalo como un embudo. Por arriba entra mucho. Se relee menos. Menos aún cambia algo. El objetivo no es necesariamente escribir menos, sino hacer el embudo más estrecho por arriba y más ancho por abajo: menos notas, y más de ellas útiles.
Las notas que se leen tienen algunas cosas en común. Están escritas para un lector concreto en un momento concreto: la revisión de mañana por la mañana, la próxima sesión en este proyecto, un agente que empieza a trabajar, tú dentro de tres meses. Saber quién lo leerá y cuándo cambia lo que escribes. Una nota de relevo para mañana puede ser escueta. Una entrada del registro de decisiones para dentro de tres meses necesita sus motivos bien explicados, porque para entonces el contexto se habrá evaporado.
Empiezan por la conclusión. La línea más importante es la primera: cuál es el estado, qué se decidió, qué hay que hacer. Los detalles van después, para quien los necesite. Las notas que empiezan con una narración y terminan con lo esencial rara vez se leen hasta el final, lo que significa que lo esencial rara vez llega a leerse.
Escribe la nota para la persona cansada que la leerá. Esa persona suele ser tú.
Están en un sitio previsible. Una nota que no se encuentra no existe. Decide dónde vive cada tipo de nota, el cuaderno en un archivo, los relevos al principio de la memoria del proyecto, las decisiones en el registro, y cíñete a ello. Si tienes que buscar una nota, a menudo no te molestarás, y la nota se habrá desperdiciado.
Son cortas. Las notas largas se leen en diagonal, y las notas leídas en diagonal pierden sus detalles. Si una nota tiene que ser larga, ponle al principio un resumen de una línea que se sostenga solo. Muchos operadores adoptan una regla sencilla: ninguna nota de más de una pantalla sin una línea de resumen.
Y se podan. Una nota de relevo que ha quedado superada debería eliminarse o marcarse como antigua, o el siguiente lector actuará sobre información rancia. Un archivo de memoria lleno de consejos desfasados es peor que uno corto con consejos vigentes. El capítulo siguiente trata la poda con más detalle, pero también pertenece aquí, porque las notas que nunca se podan son notas en las que, tarde o temprano, se deja de confiar.
Hay una forma de poner a prueba tus notas. Una vez por semana, elige una nota que escribiste hace al menos quince días y léela en frío. Pregúntate si te dijo rápidamente lo que necesitabas saber, si algo en ella estaba mal o desfasado y si te llevó a hacer algo. Si las tres respuestas son buenas, sigue escribiendo ese tipo de nota. Si no, ajusta.
Esta semana, mira las últimas diez notas que escribiste, del tipo que sea, y pregúntate de cada una: ¿para quién era y la leyó? Si no sabes decirlo, probablemente la nota no era para nadie. Escribe menos de esas y más para alguien en particular.
Fig. 35 · Notas que se leen. De todo lo escrito, menos se lee y menos se aplica; cinco hábitos ensanchan la base.
Capítulo 36 · Parte IV
Podar la memoria
La memoria se acumula. Cada vez que un agente comete un error, añades una regla. Cada vez que surge una convención nueva, la anotas. Cada vez que una trampa muerde, la registras. Todo eso es buena práctica, y nada de ello se elimina nunca, porque quitar cosas parece arriesgado y añadirlas parece responsable. A los seis meses el archivo de memoria triplica su longitud, un tercio está desfasado y los agentes siguen instrucciones escritas para un proyecto que ya no existe del todo.
La memoria rancia es peor que no tener memoria. Un agente sin memoria pregunta o explora. Un agente con memoria rancia actúa con aplomo sobre información errónea. Usa el comando antiguo, sigue la convención abandonada, esquiva la trampa que se arregló hace meses rodeándola de una forma innecesariamente complicada. Los errores son sutiles porque parecen elecciones deliberadas, y en cierto sentido lo son: fueron tus elecciones deliberadas, en su día.
El remedio es un ciclo: añadir, revisar, podar. Añadir ocurre de forma natural en el curso del trabajo. Revisar y podar hay que programarlo, porque nunca ocurrirá de forma espontánea. Una vez al mes, o como mínimo en cada revisión trimestral, lee cada archivo de memoria entero con un bolígrafo rojo en mente. Para cada línea, pregúntate si sigue siendo cierta, si sigue haciendo falta y si está en el sitio adecuado.
La memoria que solo crece se convierte en un museo. Los agentes deberían trabajar en un taller.
Algunas líneas estarán simplemente mal: comandos que cambiaron, archivos que se movieron, reglas que se abandonaron. Corrígelas o bórralas. Otras serán ciertas pero ya innecesarias: una trampa que se arregló en origen, una convención que ahora impone la propia herramienta. Bórralas; la herramienta recuerda por ti. Otras serán ciertas y necesarias pero estarán en el sitio equivocado: una regla específica de un proyecto en un archivo general, o una instrucción puntual que acabó ascendida a permanente. Muévelas.
Un truco útil es pedir ayuda a un agente. Dale el archivo de memoria y el estado actual del proyecto y pídele que identifique las líneas que parecen desfasadas, contradictorias o sin respaldo en lo que puede ver. No lo cazará todo, y señalará unas cuantas cosas que en realidad están bien, pero es una buena primera pasada, y se le da especialmente bien detectar contradicciones entre reglas escritas con meses de diferencia.
Podar también mantiene corta la memoria, lo cual importa por sí mismo. Cada línea de un archivo de memoria la lee cada sesión. Un archivo podado hasta su mitad esencial no solo es más preciso sino más eficaz, porque las reglas que quedan no compiten por la atención con reglas muertas.
Esta semana, toma tu archivo de memoria más grande y pódalo. Intenta quitar al menos una quinta parte. Lee cada línea, borra lo que esté mal o sobre, mueve lo que esté fuera de sitio. Luego haz una sesión normal y mira si algo sale mal. En la mayoría de los casos no saldrá nada mal, y habrás aprendido algo útil: buena parte de lo que cargabas era peso, no conocimiento.
Fig. 36 · Podar la memoria. Cada línea de memoria afronta tres preguntas en un ciclo programado de añadir, revisar y podar.
Capítulo 37 · Parte IV
Una sola fuente de verdad
Cada hecho de tu operación debería tener exactamente un hogar. El comando de tests vive en un sitio. El estilo de la casa vive en un sitio. El estado actual de cada proyecto vive en un sitio. Cuando un hecho vive en dos sitios, las dos copias acabarán discrepando, y cuando lo hagan, tú y tus agentes perderéis tiempo averiguando cuál es la buena. A menudo ni siquiera notarás la discrepancia hasta que algo salga mal por su culpa.
La duplicación se cuela por motivos inocentes. Pones las instrucciones de compilación en el archivo de memoria para el agente y en el readme para los humanos. Llevas una lista de proyectos en tu cuaderno y otra en una hoja de cálculo. Anotas una decisión en el registro de decisiones y también en la descripción de la pull request, y luego actualizas una y no la otra. Cada copia fue útil cuando se hizo. El problema es que los hechos cambian, y solo actualizarás la copia que dé la casualidad de que estás mirando.
El remedio es elegir un hogar para cada tipo de hecho y, desde todos los demás sitios, señalar hacia él. El archivo de memoria dice consulta el readme para los comandos de compilación en lugar de repetirlos, o el readme dice consulta el archivo de memoria, según cuál mantengas con más cuidado. El registro de proyectos es el único sitio donde vive el estado de los proyectos; todo lo demás enlaza a él. El registro de decisiones es donde se anotan las decisiones; la descripción de la pull request remite a la entrada del registro.
Dos copias de un hecho son un hecho y un futuro fallo.
Señalar tiene un coste, que es que el lector tiene que seguir el puntero. Para los agentes, ese coste suele ser minúsculo; pueden abrir un archivo en un instante. Para ti es algo mayor, pero mucho menor que el coste de actuar sobre una copia rancia. La única excepción real es un resumen breve de algo que vive en otra parte, que a veces merece la pena conservar por comodidad. Si lo conservas, etiquétalo claramente como resumen y di dónde está la fuente, para que quien dude sepa de cuál fiarse.
Una sola fuente de verdad importa especialmente en un mundo de muchos agentes. Si tres hilos trabajan en el mismo proyecto y cada uno tiene una idea ligeramente distinta de las convenciones porque se les hizo el encargo a partir de copias ligeramente distintas, obtendrás tres tipos de trabajo ligeramente distintos. Reunir las convenciones en un solo archivo de memoria que cargan todos los hilos es la forma más sencilla de que la flota se comporte de manera coherente.
También te importa a ti, porque la duplicación es un impuesto sobre tu memoria además de sobre la de los agentes. Si tienes que recordar que el estado está en el cuaderno y también en el registro y también en la hoja de cálculo, olvidarás uno. Si el estado está solo en el registro, no hay nada que recordar salvo dónde está el registro.
Esta semana, elige un hecho que sepas que está escrito en más de un sitio y unifícalo. Elige el hogar, actualízalo y sustituye las otras copias por punteros. Luego haz lo mismo con otro la semana que viene. Es una limpieza sin glamur, y elimina para siempre toda una categoría de confusión de la operación.
Fig. 37 · Una sola fuente de verdad. Los datos copiados en varios sitios divergen; un hogar más punteros los mantiene coherentes.
Capítulo 38 · Parte IV
Los secretos, fuera
Los archivos de memoria, los cuadernos, los encargos y los registros están pensados para leerse ampliamente. Los agentes los leen en cada sesión. Se suben a repositorios, se sincronizan con almacenamiento en la nube, se pegan en hilos y de vez en cuando se comparten con colaboradores. Eso es exactamente lo que los hace útiles, y exactamente por qué nunca deben contener secretos. La memoria no es una caja fuerte.
Por secretos, piensa en sentido amplio. Contraseñas y claves de acceso, por supuesto. Pero también tokens, cadenas de conexión privadas, datos personales de clientes o usuarios, cualquier cosa cubierta por un acuerdo de confidencialidad y cualquier cosa que te incomodaría ver aparecer en un resultado de búsqueda público. La regla es sencilla: si causaría daño en malas manos, no va en nada que un agente lea por defecto.
Una forma útil de pensar cualquier dato es colocarlo en dos ejes. Uno es la sensibilidad: cuánto daño causaría su exposición. El otro es el alcance: en cuántos sitios y ante cuántos lectores acabará. Los archivos de memoria y los encargos tienen un alcance altísimo. Cualquier cosa sensible que aterrice en un documento de gran alcance está en el cuadrante equivocado. Mantenla fuera y ponla en un sitio diseñado para material sensible.
Si el agente puede leerlo cada mañana, da por hecho que el mundo podrá leerlo algún día.
Las alternativas prácticas están bien establecidas. Las credenciales van en un almacén de secretos como es debido, en variables de entorno o en la gestión de secretos que ofrezcan tus herramientas, y los agentes acceden a ellas a través de esos mecanismos, nunca pegando el valor en un encargo. Los datos personales de clientes van en el sistema que uses para los registros de clientes, y cuando un agente necesite trabajar con ellos, debería recibir solo el mínimo imprescindible para la tarea. El material confidencial debería mencionarse por su ubicación en lugar de copiarse: las condiciones del contrato están en la carpeta del cliente, y no las condiciones en sí.
También conviene pensar en lo que los agentes podrían escribir en la memoria por su cuenta. Algunas herramientas permiten que los agentes guarden hechos que aprenden durante una sesión. Es útil, pero significa que un valor visto una vez durante una depuración podría quedar guardado para siempre. Revisa periódicamente la memoria automática e incluye una instrucción fija de que los agentes nunca deben guardar credenciales, tokens ni datos personales en la memoria ni en las notas. La mayoría de los agentes lo respetará con fiabilidad una vez dicho. Algunos necesitarán que se lo recuerdes.
Si un secreto acaba donde no debe, trátalo como un incidente y no como una tarea de limpieza. Rota la credencial, no te limites a borrar la línea, porque un secreto que ha estado en un repositorio o en un archivo sincronizado debe darse por visto. Luego escribe una nota breve del incidente y añade la salvaguarda que lo habría evitado. El mismo principio reaparece en el capítulo sobre no subir nunca secretos, porque es una de las poquísimas reglas de este libro que no tiene excepciones.
Esta semana, busca en cada archivo de memoria, cuaderno y receta que tengas cualquier cosa que parezca una clave, una contraseña, un token o los datos personales de alguien. Elimina lo que encuentres y rota todo lo que fuera una credencial activa. Luego añade la instrucción fija a tu memoria. Lleva media hora y cierra una puerta que, de otro modo, seguiría discretamente abierta.
Fig. 38 · Los secretos, fuera. El material sensible en notas de gran alcance está en el cuadrante equivocado y va en un almacén.
Capítulo 39 · Parte IV
Relevos entre sesiones
Toda sesión termina y, para cualquier trabajo de cierta envergadura, otra sesión lo retomará más tarde. Puede que seas tú mañana, un hilo de agente nuevo o un hilo paralelo que necesita saber qué hizo este. La calidad de ese relevo depende casi por completo de un documento pequeño: la nota de relevo. Escríbela bien y la siguiente sesión arranca en minutos. Sáltatela y la siguiente sesión arranca con arqueología.
Un buen relevo responde a cuatro preguntas. ¿Cuál era el objetivo de esta sesión? ¿Cuál es el estado actual, concretamente, incluido lo que se terminó y lo que no? ¿Cuál es el siguiente movimiento? ¿Y qué debería saber la siguiente sesión que de otro modo no descubriría: un callejón sin salida ya explorado, una decisión tomada, una sorpresa encontrada? Cuatro párrafos breves, o cuatro líneas, según el tamaño del trabajo.
La más importante de las cuatro es el siguiente movimiento. Un relevo que describe el estado de maravilla pero no dice qué hacer a continuación deja que la siguiente sesión lo averigüe, lo que hace perder tiempo y se arriesga a una conclusión distinta. Siguiente: añadir el test del caso vacío y luego ejecutar la suite completa vale más que una página de descripción, porque permite a la siguiente sesión ponerse a actuar de inmediato.
El mejor relevo es el que permite a la siguiente sesión empezar con un verbo.
La segunda más importante son los callejones sin salida. Los agentes, y las personas, tienden a redescubrir el mismo camino equivocado. Si esta sesión pasó media hora descubriendo que el arreglo obvio no funciona por alguna restricción oculta, dilo en el relevo. Si no, la siguiente sesión gastará su propia media hora en el mismo descubrimiento, y puede que ni siquiera llegue a la misma conclusión.
¿Dónde vive el relevo? En algún sitio donde la siguiente sesión mire sin que se lo digan. Para muchos operadores es una sección breve al principio del archivo de memoria del proyecto, que se sustituye al final de cada sesión. Para otros es una nota en el registro de proyectos junto a la línea del proyecto. Para el trabajo en un repositorio, puede ser la descripción de la pull request, actualizada a medida que avanza el trabajo. El sitio importa menos que la constancia: elige uno y úsalo siempre.
A los agentes se les da bien redactar relevos, y deberías dejarles hacerlo. Al final de una sesión, pide al agente que escriba el relevo con las cuatro preguntas. Luego léelo y corrígelo. El paso de corrección no es opcional. Los agentes tienden a ser optimistas con el estado, y describen algo como casi terminado cuando está a medias, y no siempre saben cuáles de sus descubrimientos importarán después. Tu corrección es donde el relevo se vuelve fiable.
Esta semana, termina cada sesión de un trabajo de varias sesiones con un relevo de cuatro preguntas. Ponlo siempre en el mismo sitio. Luego fíjate en cómo va la siguiente sesión. Probablemente descubrirás que los diez primeros minutos, que antes se iban en averiguar dónde estaban las cosas, ahora se dedican a hacerlas. El relevo es una pequeña cortesía hacia tu yo futuro, y tu yo futuro es un cliente exigente.
Fig. 39 · Relevos entre sesiones. Un relevo redactado por el agente, corregido por ti y leído por la siguiente sesión.
Capítulo 40 · Parte IV
La mente archivador
Hay una idea popular según la cual la solución a la sobrecarga de información es un segundo cerebro: un sistema personal de conocimiento vasto, enlazado y etiquetado con mimo, en el que se guarda para más tarde todo lo que has leído o pensado. Algunas personas los construyen y les resultan de verdad útiles. Muchas más los construyen y descubren que han creado un archivo precioso que nunca consultan. Para un operador, un modelo mejor es más humilde: no un segundo cerebro, sino un archivador.
La diferencia está en qué optimizas. Un segundo cerebro optimiza la captura: meterlo todo, conectarlo, enriquecerlo. Un archivador optimiza la recuperación: poder poner la mano sobre lo correcto en el momento correcto. Capturar sin recuperar es acaparar. Recuperar sin capturar es imposible. Lo que quieres es la intersección, la información que capturaste y que de verdad puedes encontrar y usar cuando la necesitas. Esa intersección suele ser mucho más pequeña que el archivo.
Los operadores con agentes tienen un motivo particular para favorecer la recuperación. A los agentes se les da muy bien buscar, leer y resumir, lo que significa que unos archivos planos bien organizados son hoy muchísimo más útiles que antes. No necesitas etiquetar y enlazar todo a mano si un agente puede buscar en la carpeta y sacar lo relevante. Lo que sí necesitas es que los archivos estén en sitios previsibles, con nombres sensatos y escritos con la claridad suficiente para que una búsqueda los encuentre.
Una nota que no puedes encontrar es una nota que no escribiste.
Así que mantén sencillo el archivador. Un número pequeño de carpetas de primer nivel que coincida con cómo piensas tu trabajo: proyectos, recetas, decisiones, referencia, archivo. Dentro de cada carpeta de proyecto, los mismos pocos archivos siempre: memoria, entrada del registro, registro de decisiones, relevos. Nombres que una búsqueda encuentre. Texto plano siempre que sea posible. Y un hábito firme de archivar lo terminado, para que los cajones activos contengan solo lo activo.
Captura con criterio. No todo hay que guardarlo. Una prueba útil es si puedes imaginar un momento futuro concreto en que querrías esto: una pregunta de un cliente, una tarea recurrente, una decisión que revisar. Si puedes, archívalo donde ese momento vaya a buscar. Si no, déjalo ir. El miedo a perder algo es real, pero casi todo lo que guardan los operadores no se vuelve a abrir nunca, y el desorden que crea hace más difícil encontrar lo útil.
La recuperación mejora con la práctica. Cuando necesites algo, intenta encontrarlo antes de pedir a un agente que busque. Fíjate en dónde miraste primero. Ahí es donde tu mente espera que esté, y si estaba en otro sitio, plantéate moverlo. Con el tiempo, el archivador se reorganiza en torno a cómo piensas de verdad, que es el único sistema de organización que funciona de forma fiable.
Esta semana, pide a un agente que encuentre en tus archivos tres cosas que sabes que existen: una decisión del trimestre pasado, una receta que usas poco, una nota antigua de un cliente. Cronometra cada búsqueda. Donde la búsqueda fue lenta o fracasó, pregúntate por qué y arregla el archivo. No estás construyendo un cerebro. Estás construyendo un archivador que se abre por el cajón correcto, y eso es algo muchísimo más alcanzable.
Fig. 40 · La mente archivador. Un archivador sencillo de cajones, pensado para recuperar más que para guardar.
Parte V
El registro y los hilos
Proyectos, delegación y trabajo en paralelo.
Capítulo 41 · Parte V
El registro de proyectos
Un operador con agentes puede tener una cantidad asombrosa de cosas en vuelo. Un proyecto de cliente, dos herramientas internas, el borrador de un libro, una pregunta de investigación, una migración que lleva tres semanas al noventa por ciento, una idea que empezaste un domingo. Cada una puede tener varios hilos trabajando en ella. Sin un único sitio que lo enumere todo, la operación se vuelve imposible de ver entera, y lo que no puede verse entero no puede dirigirse.
Ese único sitio es el registro de proyectos. Es una lista de todos los proyectos que hay ahora mismo en tu vida, con una línea para cada uno, un estado y un siguiente paso. No es un sistema de gestión de proyectos, ni un gestor de tareas, ni un tablero kanban, aunque puede vivir en cualquiera de ellos si quieres. Es la vista de más alto nivel: la respuesta a la pregunta ¿qué estoy dirigiendo de verdad?
El registro está en lo alto de una pequeña jerarquía. Debajo están los proyectos, una línea cada uno. Cada línea apunta a un siguiente paso, la única cosa más importante que debería pasar en ese proyecto. Y debajo de eso están los hilos y las sesiones que hacen el trabajo real. El registro es la parte que miras cada mañana. Los hilos son la parte que miran los agentes. Mantener separados los dos niveles es lo que te permite pensar en la operación sin ahogarte en sus detalles.
Si no está en el registro, no es un proyecto. Es una distracción con ambiciones.
¿Qué va en el registro? Todo lo que vaya a necesitar más de una sesión, implique un compromiso con alguien o vaya a producir algo que se entregue. Las tareas puntuales no tienen cabida; su sitio son los tres de hoy o la cola. Las responsabilidades continuas, como mantener actualizada una herramienta, pueden ir en el registro como proyectos permanentes con su propio estado sencillo.
Guárdalo en un solo sitio, en texto plano si puedes, y lo bastante corto como para leerlo en un minuto. Muchos operadores lo llevan como un único archivo con un encabezado por estado y una línea por proyecto. Algunos lo llevan como tabla. Unos pocos lo tienen en papel junto a la mesa. El formato importa mucho menos que la disciplina de tener exactamente un registro y actualizarlo en cada cierre.
El registro hace tres trabajos a la vez. Alimenta la revisión de la mañana, porque los tres de hoy se eligen de él. Te mantiene honesto con tu capacidad, porque el número de líneas activas es una medida visible de cuánto has asumido. Y te muestra lo que va a la deriva, porque una línea cuyo siguiente paso no ha cambiado en quince días es una línea que necesita una decisión, no más trabajo.
También permite que los agentes ayuden con la supervisión. Un agente puede leer el registro junto con los hilos y decirte qué proyectos no han tenido actividad esta semana, qué siguientes pasos se han quedado rancios y qué hilos no están vinculados a ningún proyecto. Es un resumen matinal útil, siempre que el registro siga siendo tuyo para editarlo.
Esta semana, escribe tu registro. Cada proyecto, una línea, un estado y un siguiente paso. Puede que te sorprenda la longitud de la lista. Esa sorpresa es lo primero útil que te dirá el registro.
Fig. 41 · El registro de proyectos. El registro lista cada proyecto con un estado y un siguiente paso, por encima de los hilos de trabajo.
Capítulo 42 · Parte V
Una línea por proyecto
El registro solo funciona si cada proyecto cabe en una línea. Parece una norma de formato. En realidad es una norma de pensamiento, porque comprimir un proyecto en una sola línea te obliga a saber cuál es su estado y qué debería pasar a continuación. Si no puedes escribir la línea, ahora mismo no entiendes el proyecto lo bastante bien como para dirigirlo.
Una buena línea tiene cuatro partes: el nombre del proyecto, su estado, su siguiente paso y, si viene al caso, una fecha. Reescritura del importador: activo; siguiente, entregar el arreglo de filas vacías; para el jueves.Informe del cliente: en espera; siguiente, reclamar comentarios sobre el borrador dos.Esquema del curso: aparcado; siguiente, revisar en la revisión trimestral. Cada línea es una frase que podrías decir en voz alta en menos de cinco segundos, y cada una te dice exactamente qué hacer si decidieras trabajar en ese proyecto ahora.
El valor está en la compresión. Cada proyecto tiene asociada muchísima más información de la que cabe en una línea: historia, contexto, preguntas abiertas, riesgos, ideas. Todo eso tiene su sitio, en el archivo de memoria del proyecto, en el registro de decisiones o en las notas de relevo. La línea del registro no es un resumen de todo eso. Es un destilado de lo que importa para dirigir: ¿dónde está y qué viene ahora?
Si no puedes decirlo en una línea, todavía no lo sabes.
Escribir el siguiente paso es la parte más difícil, y la más útil. Tiene que ser una acción concreta, no un tema. Trabajar en el importador es un tema. Entregar el arreglo de filas vacías es un paso. Pensar en los precios es un tema. Redactar dos opciones de precio y elegir una es un paso. Los temas no te dicen qué hacer esta mañana. Los pasos sí, y por eso un registro de pasos es algo con lo que puedes llevar un día entero, mientras que un registro de temas es solo una lista de preocupaciones.
Cuando cueste escribir la línea de un proyecto, tómatelo en serio. Normalmente significa una de tres cosas. El proyecto son en realidad varios proyectos y debería dividirse en líneas separadas. El proyecto está esperando una decisión que no has tomado, en cuyo caso el siguiente paso es tomarla. O el proyecto ha perdido su propósito y sigue por inercia, en cuyo caso el siguiente paso puede ser aparcarlo o terminarlo. Las tres cosas merecen saberse.
Los agentes pueden redactar las líneas del registro a partir de las notas de relevo de un proyecto, y es un atajo práctico en el cierre. Pero edita tú cada línea. El siguiente paso, en particular, es una decisión, y los agentes tienden a proponer la continuación más obvia y no la más valiosa. A veces el siguiente paso más valioso es parar, y un agente rara vez lo sugiere sin que se lo pidan.
Esta semana, reescribe cada línea de tu registro con la forma de cuatro partes: nombre, estado, siguiente paso, fecha. Donde el siguiente paso sea un tema, conviértelo en acción. Donde una línea no se deje comprimir, averigua por qué. Al final deberías poder leer el registro entero en voz alta en menos de un minuto y saber exactamente qué necesita cada proyecto. Eso es el registro haciendo su trabajo.
Fig. 42 · Una línea por proyecto. Una línea del registro se divide en nombre, estado, siguiente paso y fecha; los pasos ganan a los temas.
Capítulo 43 · Parte V
Palabras de estado que significan algo
Cada proyecto del registro tiene un estado, y el vocabulario que usas para los estados importa más de lo que cabría esperar. Demasiadas palabras de estado y se emborronan entre sí: en curso, en marcha, en proceso, empezado, en desarrollo. Demasiado pocas y ocultan diferencias importantes. Lo que quieres es un vocabulario pequeño y honesto en el que cada palabra implique una acción concreta, y el conjunto más útil para la mayoría de los operadores son cuatro palabras: idea, activo, aparcado y hecho.
Una idea es algo que podrías hacer pero con lo que no te has comprometido. Está en el registro, o más a menudo en una lista aparte, para que no se pierda, pero no se espera nada de ella. Las ideas son baratas y deberían seguir siéndolo. El peligro con los agentes es que las ideas se vuelvan activas por accidente: abres un hilo para explorar algo, el hilo produce algo prometedor y de repente existe un proyecto que nunca decidiste empezar. Mantén una línea firme entre idea y activo, y crúzala solo a propósito.
Activo significa que te has comprometido con él y que recibe atención esta semana. Los proyectos activos tienen un siguiente paso en el que se está trabajando y compiten por los tres de hoy. El número de proyectos activos es el número más importante del registro, porque es lo más parecido que tienes a una medida de carga. La mayoría de los operadores en solitario pueden llevar bien entre tres y cinco proyectos activos. Más que eso, y cada uno recibe menos revisión de la que necesita.
Un estado es una promesa sobre lo que pasará a continuación. Que las promesas sean pocas.
Aparcado significa pausado deliberadamente. No es fracasado, ni olvidado, ni abandonado. Es un proyecto en el que has decidido no trabajar por ahora, con una nota de por qué y de cuándo volverás a mirarlo. Aparcado es el estado más infrautilizado en casi todas las operaciones y el más valioso, porque te da una forma honesta de reducir carga sin fingir que los proyectos no existen. De él trata el capítulo siguiente.
Hecho significa terminado y entregado. Es el estado al que se supone que llega cada proyecto, y debería marcarse con claridad, con una fecha y una línea sobre lo que se entregó. Los proyectos hechos pueden pasar a una sección de archivo del registro, pero conserva constancia. Repasar lo que se hizo en un trimestre es de lo más alentador que puede hacer un operador.
Puede que quieras un estado más para los proyectos bloqueados por otra persona: en espera. Está bien, siempre que cada proyecto en espera tenga una persona o un acontecimiento concreto al que espera y una fecha en la que vas a reclamarlo. Sin eso, en espera se convierte en un sinónimo educado de atascado.
Resiste la tentación de añadir más. Cada palabra de estado nueva añade una decisión sobre qué palabra usar, y cada palabra ambigua se convierte en un escondite para proyectos. Si te descubres queriendo un estado como casi hecho o en curso pero lento, suele ser señal de que un proyecto necesita una decisión y no una etiqueta nueva.
Esta semana, recorre tu registro y asigna a cada proyecto exactamente una de las cuatro palabras. Donde ninguna encaje, decide cuál debería ser. Cuenta los activos. Si el número te sorprende, el capítulo siguiente te ayudará.
Fig. 43 · Palabras de estado que significan algo. Los proyectos pasan entre idea, activo, en espera, aparcado y hecho mediante transiciones deliberadas.
Capítulo 44 · Parte V
Aparcar sin culpa
Todo operador tiene más proyectos de los que puede llevar bien. La respuesta natural es mantenerlos todos nominalmente activos, dar a cada uno un poco de atención, sentirse culpable por los que reciben menos y avanzar de forma lenta y dispersa en todo. La respuesta mejor es aparcar. Aparcar es el acto de pausar deliberadamente un proyecto, anotar por qué y cuándo volverás a mirarlo, y luego no pensar en él hasta entonces.
La prueba para aparcar es sencilla: ¿puede este proyecto avanzar de forma significativa esta semana, teniendo en cuenta todo lo demás? Si la respuesta es sí, mantenlo activo. Si es no, porque está esperando algo, porque otros proyectos importan más o porque sencillamente no tienes la atención, apárcalo. La respuesta será a menudo no para proyectos que te importan. No pasa nada. Que algo te importe no es lo mismo que tener capacidad para ello esta semana.
Aparcar como es debido implica tres pasos. Primero, escribe una nota de relevo, para que cuando vuelvas puedas retomarlo donde lo dejaste sin hacer arqueología. Segundo, escribe el motivo para aparcarlo y la condición para desaparcarlo: aparcado hasta que el cliente confirme el alcance, o aparcado hasta la revisión trimestral, o aparcado hasta que esté hecho el importador. Tercero, detén los hilos vinculados al proyecto o déjalos en un estado limpio y terminado. Un proyecto aparcado con hilos vivos no está aparcado. Está desatendido.
Aparcado es una decisión. A la deriva es la ausencia de una.
La culpa es la parte difícil. Aparcar parece admitir una derrota, sobre todo con proyectos que empezaste con entusiasmo. Pero la alternativa, mantener demasiados proyectos activos, garantiza que algunos irán a la deriva, y los proyectos a la deriva cargan con mucha más culpa que los aparcados, porque su estado es incierto. Un proyecto aparcado descansa tranquilo con una nota clara pegada. Un proyecto a la deriva te reprocha algo cada vez que ves su nombre.
Aparcar también mejora los proyectos que siguen activos. Con menos líneas compitiendo por los tres de hoy, cada proyecto activo recibe más revisión, mejores encargos y finales más rápidos. Los operadores que aparcan con decisión a menudo descubren que su producción total sube, no baja, porque terminar unas pocas cosas es muchísimo más productivo que hacer avanzar muchas.
Los agentes hacen que aparcar sea más importante, no menos. Como empezar es tan barato, el número de cosas en las que podrías estar trabajando crece sin parar. Sin el hábito de aparcar, el registro se hincha hasta volverse ilegible. Con él, el registro mantiene un tamaño manejable, y las ideas que lo habrían hinchado esperan en una cola ordenada donde pueden evaluarse con calma.
Revisa los proyectos aparcados en cada revisión trimestral, o cuando se cumpla su condición para desaparcarlos. Algunos volverán a activo. Otros resultarán ser, a la luz fría de unos meses, proyectos que ya no quieres, y esos pueden terminarse con delicadeza, de lo que trata un capítulo posterior.
Esta semana, mira tus proyectos activos y aparca al menos uno. Escribe la nota, fija la condición, detén los hilos. Luego fíjate en cómo se sienten los activos que quedan. Normalmente, más ligeros. Al proyecto aparcado no le importará. Tiene una nota.
Fig. 44 · Aparcar sin culpa. Los proyectos que no pueden avanzar esta semana se aparcan en tres pasos hasta que se cumpla una condición.
Capítulo 45 · Parte V
Los hilos son unidades de delegación
Casi todas las herramientas de agentes organizan el trabajo en hilos: conversaciones o sesiones separadas, cada una con su propio contexto, su historial y su estado en curso. Es fácil pensar en un hilo como una ventana de chat, un sitio donde da la casualidad de que hablas con un agente. Es más útil pensar en él como una unidad de delegación, un trabajo acotado entregado a un trabajador, con un encargo, un alcance, un conjunto de comprobaciones y un relevo al final.
Ese cambio de mentalidad cambia cómo empiezas los hilos. Una ventana de chat se abre a la ligera, cada vez que se te ocurre una pregunta. Una unidad de delegación se abre deliberadamente, cuando hay un trabajo que merece delegarse y sabes cómo es su final. El primer hábito produce docenas de hilos usados a medias, cada uno con un fragmento de contexto, ninguno claramente terminado. El segundo produce menos hilos, cada uno con un propósito y un final.
Un hilo como unidad de delegación tiene cuatro partes, reunidas a su alrededor como en un eje. El encargo que lo inició, que fija el objetivo y el final. El alcance, que dice qué puede tocar este hilo y qué no. Las comprobaciones que debe ejecutar antes de informar. Y el relevo que deja cuando termina o se detiene. Si puedes nombrar las cuatro para un hilo, es una delegación bien formada. Si no, es una conversación que podría convertirse en trabajo, que es algo distinto y menos fiable.
Un hilo sin encargo es una conversación. Un hilo con encargo es un trabajo.
Pensar en unidades también te ayuda a decidir cuándo empezar un hilo nuevo y cuándo continuar uno viejo. Continúa cuando el trabajo sea el mismo y el contexto siga siendo relevante. Empieza de cero cuando el trabajo haya cambiado, cuando el contexto se haya llenado de callejones sin salida o cuando quieras unos ojos frescos. Un hilo largo acumula historia, y la historia no siempre ayuda. Los agentes pueden quedarse anclados a un enfoque temprano que tú ya has abandonado. Un hilo nuevo con un encargo limpio y una buena nota de relevo a menudo rinde más que un hilo largo que sabe demasiado.
Las unidades de delegación son también lo que hace funcionar el registro. Cada hilo debería pertenecer a un proyecto del registro. Si encuentras un hilo que no, o bien forma parte de un proyecto que no has registrado, cosa que deberías arreglar, o bien es un hilo suelto, que deberías terminar o cerrar. Una auditoría rápida de los hilos abiertos frente al registro es un buen hábito semanal, y casi siempre encuentra unos cuantos sueltos.
Cuando te describes tu trabajo en términos de hilos como trabajos, empiezas a pensar de forma natural como alguien que delega, que es lo que eres. Te preguntas si el encargo era claro, si el alcance era el correcto, si las comprobaciones eran suficientes. Esas son las preguntas que mejoran la delegación. ¿Por qué salió mal el chat? no lo es.
Esta semana, antes de abrir cualquier hilo nuevo, escribe sus cuatro partes en una o dos líneas cada una. Si no puedes, no abras todavía el hilo. Cuenta, al final de la semana, cuántos hilos abriste en comparación con la semana anterior. Menos, casi seguro. Mejores, casi seguro también.
Fig. 45 · Los hilos son unidades de delegación. Un hilo como unidad de delegación, con encargo, alcance, pruebas y relevo.
Capítulo 46 · Parte V
Un hilo, un resultado
Cada hilo debería apuntar exactamente a un resultado. No a un resultado y unos cuantos retoques relacionados. No a dos resultados que dan la casualidad de que tocan los mismos archivos. Uno. Es la regla más eficaz para que el trabajo en paralelo de los agentes siga siendo revisable, y se incumple constantemente, normalmente con la mejor de las intenciones.
La tentación es la eficiencia. Tienes un hilo abierto sobre el importador, el agente tiene el contexto cargado y recuerdas que el exportador tiene un fallo parecido. ¿Por qué no pedirle al mismo hilo que lo arregle también? Lo tiene ahí mismo. Conoce el código. Le llevará cinco minutos. Y así el hilo tiene ahora dos resultados, trenzados, y cuando vuelve tienes un cambio grande que arregla dos cosas, y tienes que revisar ambas a la vez, desenredando qué partes pertenecen a cuál.
Trenzar resultados tiene tres costes. La revisión se vuelve más difícil, porque se mezclan cambios con fines distintos, y es fácil aprobar el conjunto porque una mitad está claramente bien. La entrega se vuelve más difícil, porque un resultado puede estar listo y el otro no, y ahora están en el mismo trabajo. Y revertir se vuelve más difícil, porque si un arreglo resulta estar mal, deshacerlo significa deshacer los dos. Los tres costes se pagan más tarde, y por eso la eficiencia del principio resulta tan tentadora.
Dos resultados en un hilo son un hilo que no puedes entregar.
Piensa en los hilos en dos ejes: lo amplio que es su alcance y lo claro que es su resultado. Alcance estrecho con resultado claro es el rincón que quieres. Alcance amplio con resultado claro es manejable pero lento de revisar. Alcance estrecho con resultado poco claro tiende a vagar. Alcance amplio con resultado poco claro es el hilo que funciona tres días y produce algo que nadie puede evaluar. Un hilo, un resultado, te empuja con firmeza hacia el rincón bueno.
Así que, cuando llegue la idea relacionada a mitad de hilo, mándala a la cola o abre un hilo aparte para ella con su propio encargo. Sí, el hilo nuevo tendrá que volver a cargar el contexto. Cuesta un minuto. Desenredar un cambio trenzado cuesta mucho más, y ese minuto te compra dos trabajos limpios que pueden revisarse, entregarse y revertirse cada uno por su cuenta.
La misma regla ayuda a los agentes. Un agente que trabaja en un solo resultado puede contrastar su trabajo con una sola definición de terminado. Un agente que trabaja en dos tiene que equilibrarlos, y bien puede decidir que un cambio útil para uno es aceptable aunque perjudique un poco al otro. Quieres que esas compensaciones las hagas tú, al revisar, y no el agente, a mitad de ejecución.
Hay excepciones. A veces dos cambios son de verdad inseparables, porque uno no puede hacerse sin el otro. En ese caso son en realidad un solo resultado, y el encargo debería decirlo. La regla no va del número de archivos tocados. Va del número de cosas sobre las que tendrás que decidir cuando vuelva el trabajo.
Esta semana, audita tus hilos abiertos. Para cada uno, escribe su resultado en una frase. Si necesitas la palabra y, el hilo tiene dos resultados. Divídelo o deja que uno espere. Tus revisiones se acortarán casi de inmediato.
Fig. 46 · Un hilo, un resultado. Un alcance estrecho y un resultado claro mantienen los hilos revisables, entregables y reversibles.
Capítulo 47 · Parte V
En paralelo, no enredado
Una de las grandes promesas de los agentes es el paralelismo. Varios hilos pueden funcionar a la vez, cada uno trabajando en una pieza distinta de la operación mientras tú revisas los resultados según llegan. Bien hecho, es extraordinario: una mañana en la que cuatro trabajos distintos avanzan simultáneamente y cada uno termina limpio. Mal hecho, es una maraña en la que los hilos se estorban, se pisan los cambios y generan más revisión de la que una sola persona puede asumir.
La diferencia se reduce a la separación. El trabajo en paralelo se mantiene limpio cuando las piezas están de verdad separadas: archivos distintos, resultados distintos, ramas distintas, ningún estado compartido que más de un hilo esté cambiando a la vez. El trabajo en paralelo limpio es la intersección de dos cosas: funcionar al mismo tiempo y no tocarse. Pierde cualquiera de las dos y obtendrás o bien trabajo secuencial lento o bien trabajo rápido y enredado.
El enredo más frecuente es que dos hilos cambien los mismos archivos. Cada hilo hace un trabajo sensato en sus propios términos y, cuando ambos terminan, sus cambios entran en conflicto. Resolver el conflicto exige entender ambos cambios en detalle, que es justo el esfuerzo de revisión que esperabas que el paralelismo repartiera. El remedio es planificar el trabajo en paralelo para que cada hilo tenga su propio territorio. Si dos trabajos tienen que tocar los mismos archivos, hazlos uno detrás de otro, no en paralelo.
El trabajo en paralelo solo es un regalo cuando las piezas no comparten pared.
Muchas herramientas ayudan ya directamente con esto. Los agentes pueden trabajar en copias separadas de un repositorio, a menudo llamadas worktrees o entornos aislados, para que sus cambios no choquen hasta que tú decidas combinarlos. Úsalos siempre que tengas más de un hilo sobre el mismo código. Para el trabajo que no es código, el equivalente son documentos separados o secciones separadas, cada una propiedad de un hilo.
El segundo enredo es la sobrecarga de revisión. Cuatro hilos en paralelo producen cuatro tandas de resultados, y tienden a terminar más o menos a la vez. Si cada uno necesita una revisión cuidadosa, ahora tienes una cola de revisión que puede llevar más tiempo del que tardaron los hilos en ejecutarse. El remedio es escalonar: lanza los hilos a intervalos, o dales trabajos de distinto tamaño, para que los resultados lleguen de uno en uno. O simplemente lanza menos en paralelo. Dos hilos que revisas bien ganan a cinco que revisas con prisa.
El tercer enredo es la atención. Vigilar varios hilos a la vez parece eficiente y no lo es. Cada asomada cuesta un cambio de contexto, y los cambios de contexto son caros para las personas aunque sean gratis para los agentes. Agrupa tus asomadas: mira todos los hilos en marcha juntos a intervalos fijos, en lugar de saltar de uno a otro cada vez que uno se mueve.
Esta semana, antes de lanzar hilos en paralelo, dibuja un mapa rápido: qué hilo toca qué archivos o documentos. Si dos se solapan, ponlos en secuencia. Usa copias aisladas para el código. Escalona los arranques. Luego fíjate en cómo se sienten las revisiones. El trabajo en paralelo debería parecerse a una cocina bien llevada, no a una abarrotada, y la diferencia está casi toda en la planificación previa, antes de que nadie coja un cuchillo.
Fig. 47 · En paralelo, no enredado. Hilos escalonados en territorios separados entregan resultados para revisar de uno en uno.
Capítulo 48 · Parte V
Pasar bien el testigo
Toda delegación empieza con un traspaso: el momento en que pasas un trabajo a un agente. La mayoría de los operadores piensa en ello como escribir el encargo, y el encargo es, en efecto, casi todo. Pero un buen traspaso es un intercambio breve y no un único mensaje, y la segunda mitad, la parte en que el agente hace preguntas antes de empezar, es donde se cazan muchos malentendidos caros.
El intercambio va así. Envías el encargo y el contexto que el agente necesite. El agente lo lee, mira los archivos o el material relevantes y vuelve con preguntas o con un plan breve. Tú respondes, ajustas o confirmas. Solo entonces empieza el trabajo. En cualquier caso, es muchísimo más barato que descubrir un malentendido cuando el trabajo ya está hecho.
Muchos agentes no harán preguntas si no se les invita. Están hechos para ser serviciales, y servicial a menudo significa ponerse manos a la obra. Así que invítalos explícitamente. Una línea como antes de empezar, enumera las preguntas o ambigüedades que veas y propón un plan breve convierte un monólogo en un diálogo. Si el agente no tiene preguntas, lo dirá, y no habrás perdido nada. Si las tiene, habrás encontrado el hueco de tu encargo antes de que costara nada.
Las preguntas que hace un agente antes de empezar salen más baratas que las respuestas que adivina.
Lee las preguntas con atención, porque son diagnósticas. Si el agente pregunta algo que te parecía obvio, probablemente tu encargo daba por supuesto un contexto que no estaba ahí. Respóndela y plantéate añadir la respuesta a la memoria del proyecto para que el próximo encargo no tenga el mismo hueco. Si el agente pregunta por algo que no habías considerado, estupendo: ha encontrado una ambigüedad real, y puedes decidirla ahora en lugar de descubrir más tarde lo que adivinó el agente.
Lee también el plan con atención. Un plan te dice cómo entendió el agente la tarea. Si el plan apunta al blanco equivocado, el malentendido se ve con palabras claras, antes de hacer ningún trabajo. Si el plan es correcto pero más ambicioso de lo que querías, puedes recortarlo. Si es correcto y de tamaño adecuado, confirma y apártate.
Un buen traspaso también fija expectativas sobre el informe. Dile al agente qué quieres ver cuando termine: el resultado, las pruebas, los desvíos, las preguntas abiertas. Dile cuándo detenerse y consultar, por ejemplo antes de hacer cualquier cambio irreversible o si la tarea resulta mucho mayor de lo esperado. Estas instrucciones moldean el final del trabajo tanto como el encargo moldea el principio.
Hay una tentación, cuando ya confías en un agente, de saltarse el intercambio y mandar solo el encargo. Para tareas pequeñas y conocidas, no pasa nada. Para cualquier cosa de cierta envergadura o nueva, mantén el intercambio, aunque solo sea un minuto. La confianza se construye sobre los intercambios que cazaron problemas a tiempo; sáltatelos y acabarás redescubriendo por qué importaban.
Esta semana, añade la línea de preguntas y plan a cada encargo de una tarea de cierta envergadura. Lleva la cuenta de cuántas veces el intercambio caza algo. La mayoría de los operadores descubre que son más de las que esperaba, y que cada captura ahorró muchísimo más tiempo del que costó el intercambio.
Fig. 48 · Pasar bien el testigo. Un intercambio de relevo: encargo, preguntas y plan de vuelta, confirmación, y empieza el trabajo.
Capítulo 49 · Parte V
Cuándo reconducir un hilo
Los hilos se desvían. Un agente arranca con una tarea bien encargada y, en algún punto del camino, empieza a hacer algo contiguo. Refactoriza un módulo que el encargo no mencionaba. Se pasa veinte minutos con un problema del entorno de pruebas que no tiene nada que ver con la tarea. Reescribe una sección que solo necesitaba un retoque. Da tres vueltas al mismo bucle, probando ligeras variaciones de un enfoque que no funciona. Cada paso es razonable por sí solo. La dirección es la equivocada.
La habilidad del operador es detectar pronto el desvío y reconducir el hilo antes de que cueste mucho. Eso exige saber qué aspecto tiene el desvío y asomarse con la frecuencia suficiente para verlo. El ritmo del centro del día descrito antes ayuda: en cada asomada, pregúntate no solo si el hilo está ocupado, sino si está ocupado en lo que toca.
Algunas señales de desvío son fiables. El agente está editando archivos fuera del alcance que fijaste. El agente está arreglando problemas que no le pediste arreglar. El agente ha probado el mismo tipo de arreglo más de dos veces sin éxito. Los informes de progreso del agente describen actividad y no resultados. El tiempo transcurrido supera con creces lo que la tarea debería haber necesitado. Cualquiera de estas señales merece una mirada más atenta. Dos o más juntas casi siempre significan desvío.
El desvío no es falta de esfuerzo. Es esfuerzo apuntado hacia donde no es.
Cuando detectes un desvío, la respuesta depende de lo lejos que haya llegado. Un desvío temprano se corrige con una frase: quédate en el importador; olvídate del exportador por ahora. Un desvío moderado puede necesitar un reencargo breve: para, resume lo que has aprendido y luego sigue con este objetivo más estrecho. Un desvío grave, en el que el hilo se ha metido hasta el fondo en territorio equivocado o ha acumulado un historial confuso, a menudo se resuelve mejor deteniendo el hilo por completo y empezando de cero con un encargo mejor y una nota de relevo que recoja lo útil que descubrió el hilo desviado.
Reconducir un hilo no es una crítica al agente. El desvío suele remontarse a algo río arriba: un encargo que dejó ambiguo el alcance, una restricción que no se dijo, una definición de terminado que no dejaba claro el blanco o una sorpresa real en el trabajo que el agente resolvió improvisando. Cuando reconduzcas un hilo, tómate un momento para preguntarte cuál de estas se aplicó. Arreglar la causa mejora todos los hilos futuros. Arreglar solo el síntoma mejora este.
También hay argumentos para dejar que un hilo siga. A veces lo que parece un desvío es el agente descubriendo que la tarea de verdad exige más de lo que el encargo preveía. Si lo señala con claridad, como le pide una buena instrucción de desvío, puedes decidir si el alcance mayor es aceptable. El problema no es un agente que va más allá del encargo. Es un agente que va más allá del encargo en silencio.
Esta semana, en cada asomada, haz una pregunta a cada hilo en marcha: ¿está trabajando en lo que le pedí? Reconduce todo lo que no. Anota qué causó cada desvío. Al cabo de una semana tendrás una lista breve de hábitos de redacción de encargos que cambiar, y menos hilos que reconducir la semana siguiente.
Fig. 49 · Cuándo reconducir un hilo. Señales de deriva y las respuestas crecientes, de una frase a un hilo nuevo.
Capítulo 50 · Parte V
La silla del coordinador
En algún momento, el papel del operador pasa de llevar hilos a coordinarlos. En lugar de un hilo a la vez, hay varios, cada uno trabajando en una porción de un resultado mayor, y el trabajo consiste en decidir cómo dividir la tarea, repartir las porciones, revisar lo que vuelve e integrar los resultados en algo completo. Es la silla del coordinador, y es la forma más ambiciosa de llevar una operación unipersonal.
Algunas herramientas ya permiten coordinar directamente, con un agente principal que descompone el trabajo y entrega porciones a otros agentes, o con un espacio de proyecto en el que una sesión coordinadora reparte hilos en paralelo. Son útiles, y seguirán mejorando. Pero el papel de coordinar no desaparece cuando una herramienta asume parte de él. Alguien tiene que decidir cómo dividir el trabajo, si las porciones encajan y si el resultado integrado es lo que se quería. Ese alguien eres tú.
El ciclo del coordinador tiene tres pasos. Repartir: dividir el resultado en porciones que puedan funcionar en paralelo sin enredarse, y encargar cada una con su propio objetivo, alcance y final. Revisar: a medida que vuelven las porciones, contrastar cada una con su propio encargo. Integrar: combinar las porciones, comprobar que el conjunto funciona y decidir si cumple el resultado original. Luego, normalmente, dar otra vuelta, porque la integración suele revelar un hueco que necesita otra porción.
El coordinador no hace el trabajo. El coordinador hace que las piezas encajen.
La integración es donde está el valor, y es el paso que más probablemente se subestima. Cada porción puede pasar sus propias comprobaciones y el conjunto puede fallar igualmente, porque las porciones partían de supuestos ligeramente distintos o porque nadie era responsable de las juntas entre ellas. Los buenos coordinadores definen las juntas de antemano: la interfaz entre dos porciones, el formato compartido, el vocabulario acordado. Y en la integración comprueban primero las juntas, porque es ahí donde se esconden los problemas.
La división del trabajo es el otro sitio donde se nota la habilidad. Una buena división da a cada porción un resultado claro e independiente y minimiza las juntas. Una mala división crea porciones que dependen de los detalles de las otras, de modo que una no puede terminar hasta que termine otra, y el paralelismo se desploma en una cola. El tiempo dedicado a la división es tiempo ahorrado en todo lo demás. Dibújala antes de repartir nada.
La silla del coordinador es exigente. Requiere más atención que llevar un solo hilo, no menos, porque tienes el conjunto en la cabeza mientras se fabrican las piezas. Merece la pena para resultados grandes que se dividen bien de verdad. No la merece para resultados lo bastante pequeños como para caber en un hilo, y muchos operadores recurren a la coordinación demasiado pronto, porque parece avanzado. Un solo hilo bueno suele ser más rápido que tres coordinados para cualquier cosa que quepa en una sesión.
Esta semana, busca un resultado lo bastante grande como para dividirlo. Dibuja en una página las porciones y las juntas. Reparte dos o tres porciones con encargos cuidadosos. Revisa cada una y luego integra, comprobando primero las juntas. Fíjate en cuánto de tu tiempo se fue en la división y las juntas y no en las porciones. Esa proporción es el trabajo del coordinador.
Fig. 50 · La silla del coordinador. El coordinador reparte trozos, revisa cada uno, integra por las uniones y repite.
Parte VI
Revisar el trabajo
Pruebas, diffs y gusto.
Capítulo 51 · Parte VI
Revisar es el trabajo
Cuando los agentes hacen casi toda la fabricación, las horas de trabajo del operador migran hacia la revisión. Esto sorprende a la gente. Esperaban dedicar el tiempo liberado a la estrategia, la creatividad o el descanso, y en cambio se encuentran leyendo diffs, comprobando borradores y probando funcionalidades buena parte de cada día. Puede parecer una degradación: de artesano a inspector. Es lo contrario. La revisión es donde el operador aporta la mayor parte del valor, y tratarla como una tarea pesada es uno de los errores más caros del oficio.
Piensa en lo que hace de verdad la revisión. El trabajo de los agentes llega a la base de la pila: abundante, rápido, normalmente bueno, de vez en cuando equivocado de formas difíciles de ver. Arriba está la decisión de entregar, que pone tu nombre en el trabajo. Entre ambas está la revisión, la única capa en la que tu juicio toca directamente el trabajo. Todo lo que sabes del cliente, de los usuarios, del listón de calidad y de los riesgos entra en el trabajo a través de la revisión. Escatímala y todo ese conocimiento se queda en tu cabeza, sin usar.
La revisión es también donde aprendes. Cada revisión te muestra cómo interpretó el agente tu encargo, lo que te dice cómo encargar mejor la próxima vez. Te muestra dónde está incompleta la memoria del proyecto, dónde son débiles sus tests, dónde no están claras sus convenciones. Un operador que revisa con cuidado mejora en todas las demás partes del oficio, porque la revisión es el bucle de retroalimentación que conecta las partes.
Fabricar ya es barato. Saber si está bien, no.
Tratar la revisión como el trabajo cambia cómo la programas. Recibe tiempo de verdad en las sesiones, no minutos sobrantes entre otras cosas. Recibe tus mejores horas, no las peores, porque una revisión cansada es por donde se cuelan los defectos. Y se protege de las interrupciones, porque revisar necesita una atención sostenida que encargar no necesita.
También cambia cómo mides tu propia productividad. Si revisar es el trabajo, un día dedicado a revisar con cuidado cuatro trabajos y entregar tres es un día excelente, aunque tú no hayas fabricado nada. Los operadores que se miden por lo que han producido personalmente tienden a sentirse culpables por el tiempo de revisión y a apresurarla. Los que se miden por lo que se entregó bien tienden a dar a la revisión el tiempo que necesita.
Nada de esto significa revisarlo todo con la misma profundidad. Un capítulo posterior trata cómo ajustar la profundidad de la revisión al riesgo. Un cambio de una línea de texto necesita un vistazo. Un cambio en cómo se calculan los pagos necesita una lectura lenta y deliberada y una prueba de verdad. La habilidad está en saber cuál es cuál y dar a cada uno lo que necesita.
Esta semana, mira tu calendario y busca dónde ocurre la revisión. Si está apretujada en los huecos, dale sus propios bloques, en tus horas más lúcidas. Luego fíjate en lo que cambia: menos sorpresas después de entregar, mejores encargos a medida que aprendes de cada revisión y una sensación creciente de que diriges el trabajo en lugar de limitarte a recibirlo. Esa sensación es el oficio, bien entendido.
Fig. 51 · Revisar es el trabajo. El trabajo de los agentes sube por tu revisión, la única capa donde lo toca tu criterio.
Capítulo 52 · Parte VI
Pruebas, no promesas
Los agentes tranquilizan. Te dicen que el trabajo está completo, que los tests pasan, que los casos límite están cubiertos y que el cambio está listo para revisión. Casi siempre tienen razón. Pero tranquilizar no es probar, y un operador que acepta promesas en lugar de pruebas acabará, tarde o temprano, entregando algo que no era lo que decía ser.
La distinción es sencilla. Una promesa es una afirmación: todos los tests pasan. Una prueba es algo que puedes comprobar: la salida de la ejecución de los tests, que muestra qué tests se ejecutaron y que pasaron. La promesa es la página funciona en móvil. La prueba es una captura a ancho de móvil o, mejor aún, tú abriendo la página en tu teléfono. La promesa es he cubierto el caso vacío. La prueba es un test que ejercita el caso vacío y su resultado. En cada par, lo primero es lo que el agente cree. Lo segundo es lo que tú puedes verificar.
El motivo para exigir pruebas no es que los agentes mientan. Es que los agentes, como las personas, pueden equivocarse sobre su propio trabajo. Puede que una ejecución de tests se hiciera contra una versión antigua. Puede que una comprobación pasara por el motivo equivocado. Puede que un caso límite se cubriera en un camino y se olvidara en otro. El agente informa sinceramente de un éxito, y el informe está mal. Las pruebas cazan estos casos. Las promesas, no.
Pide el recibo, no la promesa.
El hábito práctico es pedir pruebas en el encargo y mirarlas en la revisión. En el encargo: cuando termines, incluye la salida completa de los tests y una captura de la página nueva a ancho de móvil. En la revisión: lee la salida, mira la captura y comprueba que muestran de verdad lo que afirma el resumen. Lleva un minuto o dos. Es el minuto más fiable de la revisión.
Hay una versión más sutil de la misma idea. Unas pruebas son más sólidas que otras. Un test que pasa es una prueba débil si también habría pasado antes del cambio. Una captura es una prueba débil si muestra una página distinta de la que se cambió. Las pruebas sólidas demuestran que el cambio marcó una diferencia: el test nuevo falla sin el cambio y pasa con él; las capturas de antes y después muestran el arreglo. Pide pruebas sólidas cuando importe.
Los agentes se han vuelto bastante buenos aportando pruebas cuando se les piden, y muchos ya lo hacen por defecto con el código. Para otros tipos de trabajo quizá tengas que ser más explícito. Para un resumen de investigación, pide fuentes y citas. Para una transformación de datos, pide el recuento de filas antes y después y una muestra de la salida. Para un cambio de diseño, pide capturas en los tamaños que importan. Cada una de estas peticiones convierte una afirmación en algo comprobable.
Esta semana, en cada trabajo de agente que revises, busca las pruebas antes de leer el resumen. Donde no las haya, pídelas antes de aprobar. Fíjate en cuántas veces las pruebas confirman el resumen, y en las contadas ocasiones en que no lo hacen. Esas contadas ocasiones son la razón de ser del hábito.
Fig. 52 · Pruebas, no promesas. Seis afirmaciones de agentes junto a las pruebas que te permitirían comprobar cada una.
Capítulo 53 · Parte VI
Lee el diff, no el resumen
Cada trabajo de un agente viene con un resumen, y los resúmenes de los agentes son excelentes: claros, bien organizados, seguros y fáciles de leer. También los escribe la parte que hizo el trabajo, con toda la tendencia natural que eso implica a subrayar lo que salió bien y pasar de puntillas por lo que no. Lee el resumen, desde luego. Pero lee primero el diff.
El diff, el registro real de lo que cambió, es la verdad sobre el terreno. Muestra cada archivo tocado, cada línea añadida y eliminada, cada cambio, lo mencione el resumen o no. Para el código, es literalmente un diff. Para los documentos, es una comparación entre la versión antigua y la nueva. Para los datos, es el antes y el después. Sea cual sea el medio, el diff te dice qué pasó. El resumen te dice qué cree el agente que pasó, que suele ser lo mismo y, de vez en cuando, algo importantemente distinto.
Las diferencias suelen responder a unos pocos patrones. El resumen omite un cambio porque el agente lo consideró menor: un retoque de configuración, un test borrado, un archivo modificado fuera del alcance indicado. El resumen describe la intención en lugar del resultado: mejorada la gestión de errores, cuando el diff muestra que se cubrió un caso de error y se eliminaron dos. El resumen es exacto pero incompleto: enumera lo que se pidió y no lo que vino de propina. Nada de esto es engañoso. Todo importa.
El resumen es la historia. El diff es lo que pasó.
Leer diffs es una habilidad, y merece la pena desarrollarla aunque no seas programador. Empieza por la forma: cuántos archivos cambiaron, cuáles y, más o menos, cuánto. Si la forma te sorprende, más archivos de los esperados, archivos fuera del alcance, borrados donde esperabas añadidos, mira ahí primero. Luego lee los cambios de fondo. No necesitas entender cada línea para darte cuenta de que se borró un test, de que una constante pasó de un valor a otro o de que se reescribió una sección entera de un documento cuando pediste un retoque.
Después del diff, lee el resumen y compara. ¿Menciona el resumen todo lo que viste? ¿Describe los cambios con exactitud? Si hay un hueco, pregunta por él. A menudo hay un buen motivo. A veces no, y la pregunta saca a la luz algo que de otro modo se habría entregado sin que nadie lo notara.
Los agentes también pueden ayudarte a leer diffs. Pedir a otro agente que revise un cambio, sin más contexto que el encargo original y el diff, es una segunda opinión útil, sobre todo con cambios grandes. Un agente revisor que no hizo el trabajo no le tiene apego y a menudo verá cosas que el agente original pasó por alto. Trata sus hallazgos como pruebas que sopesar, no como un veredicto que aceptar.
Esta semana, invierte tu orden de lectura. En cada trabajo de agente, abre el diff antes que el resumen. Fórmate tu propia idea de lo que cambió. Luego lee el resumen y mira si coincide. Cuenta las veces que no. Esa cuenta mide cuánto se apoyaba tu revisión en el relato que otro hacía de su propio trabajo.
Fig. 53 · Lee el diff, no el resumen. Contrastar el resumen de un agente con su diff revela omisiones y exageraciones.
Capítulo 54 · Parte VI
Primero la comprobación barata
No toda revisión tiene que ser profunda. Algunos cambios son triviales y otros son peligrosos, y tratarlos todos igual o bien desperdicia tu tiempo en lo trivial o bien escatima en lo peligroso. Un enfoque mejor es ordenar las comprobaciones por coste, de la más barata a la más cara, y parar en cuanto tengas suficiente confianza para el riesgo en juego.
Las comprobaciones más baratas llevan segundos. ¿Tiene el diff el tamaño que esperabas? ¿Pasaron las comprobaciones? ¿Coincide el resumen con el encargo? ¿Están las pruebas? Estas preguntas cazan una fracción sorprendente de problemas, sobre todo los gordos: el agente trabajó en el archivo equivocado, se dejó media tarea o rompió algo evidente. Si alguna falla, ya sabes lo que necesitas sin gastar más tiempo, y el trabajo vuelve atrás.
El siguiente nivel es el uso real. Abre la página. Ejecuta la funcionalidad. Lee el documento como lo leería su destinatario. Carga los datos en la herramienta que los va a usar. Esto lleva minutos y no segundos, y caza otra clase de problema: el trabajo técnicamente correcto que no hace lo que de verdad necesitaba nadie. El uso real es la comprobación que más a menudo se salta, porque parece lenta comparada con leer. También es la que más probabilidades tiene de cazar los problemas que encontrarían los usuarios.
Mira primero donde mirar es barato. Mira más a fondo donde equivocarse es caro.
El nivel más profundo es la lectura cuidadosa. Línea a línea por el diff, pensando en los casos límite, preguntándote qué podría salir mal, comprobando que el cambio es coherente con el resto del sistema. Esto lleva tiempo de verdad y atención de verdad, y es la comprobación adecuada para cambios con mucho en juego: cualquier cosa que implique dinero, seguridad, datos personales, acciones irreversibles o código del que dependen muchas otras cosas. Es la comprobación equivocada para un cambio en el texto de un botón.
El orden importa porque te permite parar pronto. Un cambio que falla una comprobación barata no necesita una lectura profunda; necesita rehacerse. Un cambio que supera las comprobaciones baratas y la prueba de uso real puede estar bien para entregarse si lo que está en juego es poco. Solo los cambios que superan los dos primeros niveles y conllevan un riesgo real necesitan el tercero. Así es como un operador revisa un gran volumen de trabajo sin ahogarse ni volverse descuidado.
Ayuda decidir la profundidad de antemano, como parte del encargo. Cuando escribas la definición de terminado, anota también el nivel de riesgo: bajo, medio o alto. El trabajo de riesgo bajo recibe comprobaciones baratas y una prueba rápida de uso real. El de riesgo medio recibe todo eso más una lectura centrada de los cambios clave. El de riesgo alto lo recibe todo, despacio y, preferiblemente, cuando estés fresco. Anotar el riesgo de antemano evita que lo decidas en el momento, cuando estás cansado y propenso a creer que todo es de riesgo bajo.
Esta semana, etiqueta cada encargo con un nivel de riesgo y revisa en consecuencia. Fíjate en cuánto tiempo ahorran las comprobaciones baratas en el trabajo de riesgo bajo, y en cuánta más atención te queda para el de riesgo alto. Esa redistribución es toda la cuestión. La atención es finita; gástala donde los errores cuestan más.
Fig. 54 · Primero la comprobación barata. Tres niveles de revisión ordenados por coste, con salidas tempranas para entregar o devolver.
Capítulo 55 · Parte VI
La revisión en dos pasadas
Para cualquier cosa mayor que un cambio pequeño, revisa en dos pasadas. La primera mira la forma: ¿es esto el tipo de cosa adecuado, apuntado al blanco adecuado, construido de forma sensata? La segunda mira el detalle: ¿es correcta cada parte? Hacerlas en ese orden ahorra muchísimo tiempo, porque un trabajo con la forma equivocada no merece una revisión detallada.
La pasada de forma es rápida y de alto nivel. Lee el resumen y hojea el diff. Mira la estructura del documento o la maquetación de la página. Pregúntate: ¿entendió el agente la tarea? ¿Es razonable el enfoque? ¿Es correcto el alcance, ni demasiado estrecho ni desparramado? ¿Encaja con el resto del proyecto? No estás comprobando nada línea a línea. Estás comprobando que el trabajo es el trabajo que querías.
Si la forma está mal, para. No pases al detalle. Los comentarios detallados sobre un trabajo con la forma equivocada son un desperdicio, porque el trabajo se rehará y los detalles cambiarán. Peor aún, los comentarios detallados pueden dar a entender que la forma es aceptable y que solo hay que arreglar los detalles, lo que orienta el siguiente intento en la dirección equivocada. Devuélvelo con una nota clara sobre la forma: esto lo resuelve en la base de datos; yo quería resolverlo en la interfaz. Una frase sobre la forma vale más que veinte sobre el detalle.
Nunca pulas lo que no es.
Si la forma está bien, pasa a la pasada de detalle. Ahora ve despacio. Comprueba los casos límite, la gestión de errores, la redacción, las cifras. Mira cada cambio y pregúntate si es correcto, coherente y necesario. Aquí se aplica la profundidad elegida en el capítulo anterior: un cambio de riesgo bajo recibe una pasada de detalle más ligera; uno de riesgo alto, una exhaustiva.
Luego decide. Entrégalo, devuélvelo con notas concretas o apárcalo. La decisión cierra el ciclo, y si el trabajo vuelve atrás, la siguiente versión recibe las mismas dos pasadas. A menudo, en la segunda vuelta, la pasada de forma lleva segundos porque la forma ya estaba resuelta, y solo la de detalle necesita tiempo de verdad.
El hábito de las dos pasadas merece aplicarse a tu propio trabajo además de al de los agentes. Cuando escribas un encargo, una línea del registro o una decisión, mira primero si es lo que toca y luego si es correcto en sus particularidades. Los operadores que se saltan la pasada de forma en su propio trabajo a menudo se descubren editando con esmero un encargo para una tarea que no deberían haber empezado.
Hay también un beneficio social, para las ocasiones en que revisas trabajo de personas y no de agentes. Separar la forma del detalle hace los comentarios mucho más claros. El enfoque es correcto; aquí van algunos detalles es muy distinto de hay que replantear el enfoque, y la gente agradece saber qué tipo de comentario va a recibir antes de leerlo.
Esta semana, revisa cada trabajo de cierta envergadura en dos pasadas explícitas. Escribe un veredicto de una línea tras la pasada de forma antes de empezar la de detalle. Fíjate en cuántas veces la pasada de forma zanja por sí sola la cuestión, y en lo rápida que va la de detalle cuando ya sabes que el trabajo es el que tocaba.
Fig. 55 · La revisión en dos pasadas. Una pasada de forma filtra la de detalle; las formas erróneas se devuelven antes de editar líneas.
Capítulo 56 · Parte VI
Lo que esconde el verde
Hay una sensación concreta de la que los operadores aprenden a desconfiar: el alivio de verlo todo en verde. Los tests pasan. Las comprobaciones pasan. La compilación funciona. El agente informa de que ha terminado. El verde es una buena noticia, y casi siempre significa lo que parece. Pero el verde tiene zonas ciegas, y los problemas más peligrosos son los que viven en ellas.
El verde te dice que las comprobaciones que tienes han pasado. No te dice que sean las comprobaciones adecuadas. Una suite de tests que cubre el camino principal y no los casos límite estará en verde para un código que falla en los casos límite. Una comprobación que verifica que una página carga estará en verde para una página que carga con el contenido equivocado. Un linter que impone el formato estará en verde para un código precioso de formato y erróneo de lógica. La intersección entre todo en verde y aun así mal es donde se esconden los problemas.
Los agentes añaden aquí un riesgo concreto. Un agente al que se le pide que haga pasar las comprobaciones se esforzará mucho en conseguirlo, y de vez en cuando la forma más fácil de que una comprobación pase es cambiar la comprobación. Puede debilitar una aserción, saltarse un test que falla, ampliar un valor esperado o simular con un mock justo la parte que fallaba. La mayoría de los agentes ya se cuidan bastante de no hacerlo, y muchos lo señalan si lo hacen. Pero ocurre, y produce el verde más engañoso de todos: comprobaciones que pasan porque ya no comprueban nada.
Verde significa que las comprobaciones pasaron. No significa que fueran las correctas.
La defensa es revisar las comprobaciones además del código. Cuando un diff incluya cambios en los tests, lee esos cambios con especial cuidado. Pregúntate si algún test se ha debilitado: una aserción eliminada, un valor relajado, un caso saltado. Un encargo puede ayudar aquí indicando que se pueden añadir tests pero no debilitarlos sin aprobación explícita, y que cualquier cambio en un test existente debe señalarse.
La segunda defensa es buscar pruebas de que las comprobaciones ejercitaron el trabajo nuevo. Una funcionalidad nueva debería venir con un test nuevo que falle sin la funcionalidad. El arreglo de un fallo debería venir con un test que reproduzca el fallo. Si todos los tests pasaban antes del cambio y todos pasan después, y no se añadió ningún test nuevo, el verde solo te dice que no se rompió nada evidente. No te dice nada sobre si lo nuevo funciona.
La tercera defensa es el uso real, de un capítulo anterior. Las comprobaciones son un modelo de lo que significa correcto, y los modelos siempre son incompletos. Usar la cosa, abrir la página, ejecutar la importación, leer el documento, la pone a prueba frente a la realidad y no frente al modelo. El uso real caza lo que esconde el verde con más fiabilidad que cualquier otra cosa.
Esta semana, siempre que lo veas todo en verde, hazte una pregunta extra antes de entregar: ¿qué tendría que ser cierto para que esto estuviera en verde y mal? Mira en concreto los cambios en los tests dentro del diff y comprueba que al menos una comprobación ejercitó el trabajo nuevo. Añade un minuto. Elimina toda una clase de sorpresas que, si no, llegan en el momento menos oportuno, normalmente de la mano de un usuario.
Fig. 56 · Lo que esconde el verde. Todo verde y aun así mal se cruzan en un punto ciego; tres defensas lo reducen.
Capítulo 57 · Parte VI
Revisar prosa e imágenes
Buena parte de lo que los agentes producen para un operador no es código. Es escritura: correos, informes, propuestas, documentación, publicaciones. O es visual: páginas, diapositivas, diagramas, maquetaciones. No tienen suite de tests ni compilación que se ponga en verde. Revisarlos exige otro conjunto de comprobaciones, y muchos operadores los revisan con menos cuidado que el código precisamente por eso. Es un error, porque la prosa y las imágenes suelen ser lo que ven los demás.
Para la prosa, revisa en dos ejes. Uno es la exactitud: ¿son correctos los hechos, están respaldadas las afirmaciones, hay algo inventado? El otro es la voz: ¿suena a ti, en el registro adecuado para el lector, sin los tics que delatan un texto hecho por una máquina? La prosa exacta y con tu voz está lista para enviarse. La prosa exacta pero sin tu voz puede valer para uso interno, pero no debería llegar a un cliente. La prosa con tu voz pero inexacta es la más peligrosa, porque convence.
La exactitud necesita comprobación de verdad. Los agentes escriben con fluidez, y la fluidez puede tapar errores: una fecha ligeramente equivocada, una cifra de la fuente que no es, el resumen de un documento que tergiversa sutilmente su conclusión. Para cualquier cosa que vaya a leer alguien que importa, comprueba cada afirmación factual con su fuente. Pide al agente que cite las fuentes en el borrador para poder comprobarlas deprisa, y haz clic de verdad. Es tedioso y es imprescindible.
Fluido no es lo mismo que cierto, y el lector no puede notar la diferencia. Tú sí.
La voz es más difícil de comprobar, pero se puede. Lee la prosa en voz alta o, al menos, despacio. Fíjate en las frases que tú nunca dirías. Fíjate en las estructuras que se repiten: todos los párrafos empezando igual, todas las listas con exactamente tres elementos, todas las conclusiones resumiendo lo que se acaba de decir. Son patrones habituales del texto generado y los lectores los reconocen cada vez más. Táchalos o, mejor, añade una nota a tu memoria o a tu receta para que los borradores futuros los eviten. Tener a mano unos cuantos ejemplos de tu propia escritura, como sugería un capítulo anterior, ayuda muchísimo aquí.
Para las imágenes, los equivalentes son la corrección y el encaje. Corrección: ¿funciona la maquetación en los tamaños en que se verá, es legible el texto, son accesibles los colores, funciona todo lo que debería poder pulsarse? Encaje: ¿parece que pertenece a tu marca y a tu otro trabajo, o parece competente de forma genérica? Comprueba en tamaños reales, en dispositivos reales, en modo claro y oscuro si viene al caso. Un diseño revisado solo a ancho de escritorio completo es un diseño revisado para uno de cada cinco lectores.
El método de las dos pasadas se aplica también aquí. Primero la forma: ¿es este el documento o el diseño adecuado, con la estructura adecuada, para el lector adecuado? Luego el detalle: ¿es cierta cada frase, correcto cada elemento? La prosa y las imágenes que no superan la pasada de forma deberían volver atrás sin una sola corrección de estilo.
Esta semana, toma un texto escrito por un agente que esté a punto de ir a otra persona y revísalo despacio en exactitud y voz, comprobando cada afirmación factual y tachando cada frase que tú no dirías. Cronométralo. Llevará más de lo que esperabas, y merecerá la pena cada vez.
Fig. 57 · Revisar prosa e imágenes. La prosa clasificada por exactitud y voz, junto a las comprobaciones que necesitan las imágenes.
Capítulo 58 · Parte VI
Comentarios que enseñan
Cuando devuelves un trabajo, los comentarios que escribes hacen dos cosas. La evidente es arreglar este trabajo. La menos evidente, y con el tiempo la más importante, es mejorar el siguiente. Los comentarios que solo hacen lo primero te dejan corrigiendo los mismos problemas una y otra vez. Los que hacen las dos cosas mejoran la operación cada vez que revisas.
Un comentario que enseña tiene tres cualidades. Es concreto: dice exactamente qué está mal y dónde, en lugar de apuntar a una insatisfacción general. El segundo párrafo da una cifra sin fuente y no le falta rigor. Es explicativo: dice por qué, para que el agente pueda aplicar el motivo a casos parecidos. Los clientes ya han preguntado por las fuentes otras veces; cada cifra necesita una y no solo añade una fuente. Y es portátil: enuncia un principio que podría aplicarse más allá de este trabajo.
Los comentarios concretos consiguen que el trabajo actual se arregle deprisa. Los explicativos ayudan al agente a acertar con problemas parecidos en otras partes del mismo trabajo. Los portátiles son los que merece la pena ascender a la memoria: en cuanto hayas escrito tres veces cada cifra necesita una fuente como comentario, su sitio es el archivo de memoria del proyecto o la receta correspondiente, para que todos los borradores futuros empiecen con ello.
Un comentario arregla un borrador. Un comentario ascendido a la memoria arregla todos los que vienen después.
La secuencia importa. Revisas y escribes notas concretas y explicativas. El agente revisa su trabajo. Tú compruebas la revisión. Luego, si el comentario era portátil, actualizas la memoria o la receta. Ese último paso es el que más a menudo se salta, porque cuando se aprueba la revisión ya estás deseando pasar a otra cosa. Pero es el paso que convierte una revisión en una mejora, y suele llevar menos de un minuto.
Algunos comentarios funcionan mejor como preguntas. ¿Por qué reintenta esta función tres veces? invita al agente a explicar su razonamiento, lo que puede revelar o bien un buen motivo que no habías considerado o bien una suposición errónea que puedes corregir. Las preguntas son especialmente útiles cuando sospechas que algo está mal pero no estás seguro, porque te permiten aprender antes de dar instrucciones.
Evita los comentarios puramente emocionales. Esto no está bien no le da al agente nada con lo que trabajar. No me gusta el tono apenas es mejor. Si te descubres escribiendo comentarios así, detente y pregúntate qué está mal en concreto. A menudo descubrirás que sí lo sabes y que puedes decirlo. De vez en cuando descubrirás que no lo sabes, y que el problema está en el encargo y no en el trabajo.
Los comentarios son también un registro. Repasar de vez en cuando tus propios comentarios antiguos te muestra qué te importa, qué sigue saliendo mal y cuáles son de verdad tus estándares, frente a los que crees que son. Es materia prima útil para los archivos de memoria, las recetas y la próxima revisión trimestral.
Esta semana, tras cada revisión en la que escribas comentarios, pregúntate cuáles eran portátiles. Asciende al menos uno al día a la memoria o a una receta. Al final de la semana, fíjate en si alguno de los problemas que comentaste ha dejado de repetirse. Alguno lo habrá hecho. Eso es la enseñanza funcionando.
Fig. 58 · Comentarios que enseñan. Una nota concreta y explicada arregla un borrador; subida a memoria los arregla todos.
Capítulo 59 · Parte VI
Rehacer o reparar
Cuando un trabajo de un agente vuelve con problemas, te enfrentas a una elección: repararlo, mandando notas para que el agente lo arregle, o rehacerlo, descartando el trabajo y empezando de nuevo con un encargo mejor. La mayoría de los operadores reparan por defecto. Parece económico: el trabajo está casi hecho, ¿para qué tirarlo? Pero reparar suele ser la opción más cara, y saber cuándo rehacer es una de las habilidades más discretas del oficio.
La pregunta decisiva es si la forma es la correcta. Si el trabajo apunta al blanco adecuado y está construido de forma sensata, con problemas limitados a los detalles, repáralo. Los arreglos de detalle son rápidos y el agente tiene el contexto para hacerlos bien. Si la forma está mal, el enfoque desencaminado, la estructura inviable, el blanco malinterpretado, rehazlo. Reparar una forma equivocada produce una versión parcheada y llena de concesiones de algo que no debería existir, y lleva más tiempo que empezar de cero.
Los agentes cambian la economía a favor de rehacer. Cuando un compañero humano ha dedicado un día a algo, tirarlo es costoso y desmoralizador. Cuando un agente ha dedicado veinte minutos, tirarlo cuesta veinte minutos y ningún disgusto. La tentación de reparar viene en parte de hábitos formados en un mundo en que fabricar era caro, y esos hábitos ya no encajan.
Cuando fabricar es barato, lo caro es parchear lo que no es.
Rehacer tiene otra ventaja: mejora el encargo. Un primer intento fallido es información. Te muestra qué malinterpretó el agente, qué contexto le faltaba, qué restricción olvidaste indicar. Cuando rehaces, escribes un encargo mejor con esa información dentro, y el segundo intento se beneficia. Reparar no te obliga a ello; arreglas los síntomas en el trabajo actual y el encargo se queda como estaba, listo para producir el mismo problema la próxima vez.
Está también la cuestión del historial del hilo. Un hilo que ha pasado por varias rondas de reparación lleva todas esas rondas en su contexto. El agente ve su enfoque erróneo original, tus correcciones, sus arreglos parciales y tus nuevas correcciones. Ese historial puede anclarlo y hacer más difícil pasar limpiamente a un enfoque mejor. Un hilo nuevo con un encargo mejor empieza sin anclas.
Una regla práctica útil es el límite de dos rondas. Si un trabajo ha pasado por dos rondas de reparación y sigue sin estar bien, para y rehazlo. Para entonces, los problemas son casi con seguridad de forma, parecieran lo que parecieran al principio, y una tercera ronda de reparación rara vez triunfa donde dos han fracasado.
Cuando rehagas, conserva lo útil. Puede que el intento fallido descubriera algo real: una restricción en el código, un dato sobre los datos, un callejón sin salida que merece anotarse. Pon esos descubrimientos en el encargo nuevo. Rehacer no significa olvidar. Significa volver a fabricar con todo lo aprendido y nada enredado.
Esta semana, aplica la pregunta de la forma a cada trabajo que vuelva con problemas. Donde la forma esté mal, rehaz con un encargo mejor en lugar de mandar notas. Lleva la cuenta de cuánto tarda rehacer frente a lo que habría tardado reparar. La mayoría de los operadores descubre que rehacer es más rápido más a menudo de lo que esperaba, y que el segundo intento es claramente mejor.
Fig. 59 · Rehacer o reparar. La forma correcta se repara; la forma errónea, o dos rondas fallidas, se rehace.
Capítulo 60 · Parte VI
El gusto es una habilidad de revisión
Después de las comprobaciones, las pruebas, los diffs y la forma, hay un filtro más que aplican los operadores, a menudo sin nombrarlo: el gusto. ¿Es este trabajo no solo correcto, sino bueno? ¿Y no solo bueno, sino el tipo de bueno que quieres asociado a tu nombre? El gusto es el último y más estrecho filtro de la revisión, y es uno de los pocos que los agentes todavía no pueden aplicar por ti.
Imagina los filtros como un embudo. Arriba, muchísimo trabajo es correcto: cumple el encargo, supera las comprobaciones, hace lo que se pidió. Menos es bueno: bien hecho, claro, sencillo en su justa medida, agradable de usar o de leer. Menos aún es tuyo: lleva las elecciones y los estándares particulares que hacen reconocible tu trabajo. El embudo se estrecha porque cada filtro es más difícil de satisfacer y más difícil de especificar.
Los agentes son ya muy buenos produciendo trabajo correcto y a menudo buenos produciendo trabajo bueno. Lo que más les cuesta es producir trabajo que refleje tu gusto particular, porque el gusto es casi todo tácito. Lo reconoces cuando lo ves. Te cuesta ponerlo por escrito. Y por eso es la parte del estándar que más a menudo hay que aplicar en la revisión, tú, una vez hecho el trabajo.
Lo correcto es el suelo. El gusto es la firma.
El gusto se puede cultivar y, en parte, transmitir. Cultivar, porque mejoras prestando atención: fijándote en lo que admiras del trabajo ajeno y por qué, en lo que te molesta del tuyo y por qué. Transmitir, porque puedes capturar partes de él en ejemplos, en la memoria, en recetas y en comentarios que explican en lugar de limitarse a corregir. Cada vez que escribes preferimos una frase clara a dos cuidadosas o nada de ilustraciones decorativas, solo las que explican, trasladas un poco de tu gusto de lo tácito a lo explícito, y los agentes se acercan un poco más.
Pero el gusto no debería delegarse del todo, y hay un motivo que va más allá de la capacidad. El gusto es lo que diferencia tu trabajo del de todos los demás. Si todo el mundo entrega su gusto a los mismos agentes, el trabajo de todos converge. El operador que sigue aplicando su propio gusto en la revisión, que rechaza lo competente y genérico en favor de lo particular, produce un trabajo que destaca precisamente porque pasó por la sensibilidad de una persona.
El gusto es también un freno al volumen. Los agentes facilitan producir grandes cantidades de trabajo aceptable. El gusto es lo que te impide entregarlo todo. Dice: esto está bien, pero no lo bastante como para llevar nuestro nombre, así que no sale. Esa negativa incomoda, porque el trabajo está ahí mismo y publicarlo solo costaría un clic. También es lo que impide que la calidad de lo que produces vaya bajando a medida que sube el volumen.
Esta semana, añade una pregunta al final de cada revisión: ¿esto es mío? No meramente aceptable, no meramente correcto, sino algo que te alegraría ver asociado a ti. Donde la respuesta sea no, di por qué en una frase y mira si esa frase pertenece a tu memoria. Poco a poco, los agentes aprenderán algo de tu gusto. El resto seguirá siendo tuyo, que es como debe ser.
Fig. 60 · El gusto es una habilidad de revisión. El trabajo se estrecha de correcto a bueno a tuyo, el filtro que más les cuesta a los agentes.
Parte VII
Disciplina de entregas
Pull requests, automerge y entregar en pequeño.
Capítulo 61 · Parte VII
Entrega poco y a menudo
La disciplina de entregas más fiable para un operador en solitario es también la más sencilla: entrega poco y a menudo. Cambios pequeños, cada uno revisado y publicado por su cuenta, en un flujo constante. No grandes lotes reunidos durante semanas y publicados en un bloque nervioso. Los agentes lo facilitan más que nunca, y también facilitan más que nunca el error contrario, así que merece la pena hacerlo de forma deliberada.
Los cambios pequeños son más fáciles de revisar. Un cambio que toca tres archivos y hace una cosa se entiende en minutos. Un cambio que toca treinta archivos y hace seis cosas lleva una hora, y aun así no estás del todo seguro de haberlo visto todo. Como revisar es el trabajo, y la atención para revisar es finita, los cambios pequeños son sencillamente la forma eficiente de gastarla.
Los cambios pequeños son más fáciles de entregar con seguridad. Si algo sale mal tras una entrega pequeña, sabes exactamente qué cambió y puedes arreglarlo o revertirlo deprisa. Si algo sale mal tras una entrega grande, tienes que averiguar cuál de muchos cambios lo causó, a menudo con usuarios esperando. El radio de impacto de un cambio pequeño es pequeño por construcción.
Los lotes pequeños no son timidez. Son la forma de ir rápido sin caerse.
Y los cambios pequeños mantienen la operación en movimiento. Cuando el trabajo se acumula en entregas grandes, todo está perpetuamente terminado al noventa por ciento, que es el estado más agotador en que puede estar cualquier proyecto.
Los agentes complican esto de una forma particular. Son capaces de producir cambios grandes muy deprisa, y un agente bienintencionado al que se le pide implementar una funcionalidad a menudo implementará la funcionalidad entera, sus tests, su documentación y unas cuantas mejoras por el camino, de una sola vez. El resultado es un cambio grande que llegó rápido, y su rapidez disimula su tamaño. El remedio es encargar cambios pequeños de forma explícita: implementa solo la capa de datos; la interfaz la haremos en un cambio aparte. Divide el resultado antes de que el agente empiece, no después de que termine.
Para el trabajo que no es código, el principio es el mismo. Publica la primera sección de una guía en lugar de esperar a tener las diez. Envía al cliente el primer borrador de la página más importante en lugar del sitio entero. Publica el conjunto de datos con los campos esenciales y añade los extras después.
Hay una objeción honesta: algunas cosas de verdad no pueden entregarse por mitades. Una migración de base de datos y el código que depende de ella quizá tengan que ir juntos. Un rediseño puede parecer roto si se entrega a medias. En esos casos, busca la forma de entregar en pequeño igualmente: esconde el trabajo nuevo tras un interruptor apagado por defecto, entrega primero la migración de forma compatible con lo anterior, publícalo para ti antes de publicarlo para todos. Casi todos los cambios grandes pueden trocearse si lo piensas antes de empezar el trabajo.
Esta semana, mira el tamaño de todo lo que entregas. Si alguna entrega te llevó más de media hora de revisión, pregúntate cómo podría haberse dividido. Luego encarga el siguiente trabajo parecido como dos o tres piezas más pequeñas. Fíjate en cuánto más tranquilo resulta entregar cuando cada entrega es algo que entiendes por completo.
Fig. 61 · Entrega poco y a menudo. Una gran entrega frente a un flujo de entregas pequeñas, más tres formas de trocear el trabajo grande.
Capítulo 62 · Parte VII
La pull request como rastro documental
Para cualquiera cuyo trabajo viva en un repositorio de código, la pull request es la unidad natural de entrega: un cambio propuesto, con su descripción, sus comprobaciones y su discusión, esperando a fusionarse. La mayoría de los operadores la ven como una puerta, el sitio donde ocurre la revisión antes de que entre el código. Lo es. Pero para una operación unipersonal es igual de valiosa como otra cosa: un rastro documental. Cada pull request es un registro permanente y consultable de qué cambió, por qué y qué pruebas lo respaldaban.
Ese registro vale lo que valga lo que pongas en él. Una pull request con el título actualizaciones y la descripción vacía es una puerta sin rastro documental. Seis meses después, cuando intentes entender por qué cambió cierto comportamiento, no te dirá nada. Una pull request con un título claro, una descripción del motivo y una nota de las pruebas es una pequeña pieza de documentación que responderá a esa pregunta en segundos.
Piensa en una buena pull request como cuatro capas. El título enuncia el resultado, con palabras que un desconocido entendería: El importador gestiona las filas vacías sin caerse. La descripción da el porqué: qué problema resuelve, qué enfoque se adoptó, qué alternativas se descartaron. Las pruebas enumeran las comprobaciones: qué tests se añadieron, qué se verificó a mano, alguna captura. Y el diff muestra exactamente qué cambió. La descripción es la capa que más a menudo falta, y es la que más vas a echar de menos después.
Una pull request fusionada es una carta a tu yo futuro. Escríbela como si fuera a leerla.
Los agentes escriben bien las descripciones de pull requests cuando se les pide, y muchas herramientas de agentes ya crean pull requests con descripción por defecto. Aprovéchalo, pero revisa la descripción igual que revisas el código. Los agentes tienden a describir lo que hicieron y no por qué hacía falta, y el porqué es la parte que quizá solo sepas tú. Una frase tuya al principio, explicando el motivo del cambio en términos del proyecto, convierte una descripción competente en un registro útil.
Enlaza la pull request con el resto de tu sistema. Si implementa una decisión, menciona la entrada del registro de decisiones. Si arregla algo de un incidente, menciona la nota del incidente. Si completa el siguiente paso de un proyecto, actualiza el registro. Estos enlaces son baratos de hacer en el momento y muy difíciles de reconstruir después.
Para el trabajo que no vive en un repositorio, la misma idea se aplica de otra forma. El historial de versiones de un documento, un registro de cambios de un conjunto de datos, una nota breve en la carpeta del proyecto que recoja qué se publicó y por qué: cada uno es un rastro documental. El medio varía. La disciplina de dejar constancia con cada entrega, no.
Esta semana, mira tus últimas cinco pull requests fusionadas, o su equivalente. ¿Podría un desconocido entender en cada una qué cambió y por qué? Si no, escribe una descripción mejor para las próximas cinco. Pide al agente que la redacte y añade tú el porqué. Dentro de unos meses empezarás a encontrar en tu propio historial las respuestas que necesitas, que es uno de los placeres discretos de llevar una operación bien cuidada.
Fig. 62 · La pull request como rastro documental. Una pull request en cuatro capas, del título del resultado al diff, enlazada hacia fuera.
Capítulo 63 · Parte VII
El automerge y sus condiciones
Muchas plataformas de repositorios permiten que una pull request se fusione sola cuando se cumplen sus condiciones: las comprobaciones pasan, están las revisiones obligatorias, no quedan conflictos. Para un operador en solitario que trabaja con agentes, esta fusión automática, el automerge, es muy atractiva. Llega el trabajo del agente, se ejecutan sus comprobaciones y, si pasan, se fusiona sin que muevas un dedo. La cadena de entregas funciona mientras duermes. También es una forma de entregar cosas que no has mirado, así que merece una reflexión cuidadosa.
La cuestión no es si el automerge es bueno o malo. Es qué cambios pueden usarlo. La respuesta depende de dos cosas: el riesgo del cambio y la solidez de las comprobaciones. Los cambios de riesgo bajo con comprobaciones sólidas son buenos candidatos. Los de riesgo alto, o aquellos cuyas comprobaciones son débiles, no. La decisión es una bifurcación: o el cambio es lo bastante seguro como para fusionarse solo con el respaldo de sus comprobaciones, o necesita una fusión humana tras una revisión.
¿Qué hace que un cambio sea de riesgo bajo? Toca una zona bien cubierta por tests. Es fácil de revertir. No implica dinero, seguridad, datos personales ni nada de lo que los usuarios dependan de forma crítica. Es el tipo de cambio que ha salido bien muchas veces antes. Las actualizaciones de dependencias que pasan la suite completa, los arreglos de documentación, las pequeñas refactorizaciones en código bien probado y los cambios de contenido en páginas con poco tráfico son candidatos típicos.
El automerge no elimina la revisión. La traslada a las comprobaciones, así que más vale que las comprobaciones sean buenas.
¿Qué hace sólidas las comprobaciones? Que fallarían de verdad si el cambio estuviera mal. Una suite de tests que cubra los caminos principales y los casos límite. Una compilación que se rompería ante un error de tipos. Una comprobación visual que cazaría una maquetación rota. Si no confías en que las comprobaciones cazarían un mal cambio, el automerge no es más que fusionar sin revisar, que es un nombre educado para tener esperanza.
Fija las condiciones de forma explícita. La mayoría de las plataformas te permiten exigir que pasen comprobaciones concretas, exigir etiquetas o exigir que solo cambien ciertas rutas. Úsalas para imponer tu política en lugar de confiar en acordarte de ella. Un patrón habitual es permitir el automerge solo en pull requests que lleven una etiqueta concreta que pones tú o una receta de confianza, y solo cuando pasan todas las comprobaciones obligatorias. Los cambios que tocan rutas sensibles, como el código de pagos o la configuración, pueden excluirse por completo.
Revisa después lo que se fusionó solo, aunque sea brevemente. El automerge significa que no estabas en el circuito en el momento de fusionar, no que nunca debas mirar. Un repaso rápido en la revisión de la mañana de lo que se fusionó de noche te mantiene al tanto de cómo cambia el código y te permite detectar cualquier patrón de problemas antes de que se convierta en una crisis. Si alguna vez se fusiona solo algo malo, trátalo como un incidente: averigua qué condición debería haberlo detenido y endurécela.
Esta semana, escribe tu política de automerge en una o dos frases: qué cambios pueden fusionarse solos y qué comprobaciones deben pasar. Si aún no usas automerge, elige una categoría segura para empezar. Si ya lo usas, comprueba si tu configuración real coincide con la política. A menudo no coincide, y esa brecha es exactamente por donde algún día se colará algo.
Fig. 63 · El automerge y sus condiciones. Tres puertas deciden si un cambio puede fusionarse solo o necesita una fusión humana.
Capítulo 64 · Parte VII
Comprobaciones de fiar
Toda cadena de entregas tiene comprobaciones: tests, compilaciones, linters, comprobadores de tipos, comparaciones visuales, comprobadores de enlaces, lo que necesite el proyecto. Con el tiempo, casi todos los proyectos acumulan muchas. Lo que importa no es cuántas comprobaciones tienes sino de cuántas te fías: cuántas fallarían de verdad si algo importante saliera mal. Esas son las comprobaciones que muerden. Ellas, y solo ellas, son la puerta de verdad.
Empieza por distinguir las comprobaciones que muerden de las que simplemente existen. Una comprobación que muerde ha cazado algo real en los últimos meses, o estás seguro de que lo haría. Una que simplemente existe pasa siempre y no sabes muy bien qué cazaría. Una comprobación inestable, que a veces falla sin motivo, es peor que inútil, porque te enseña a ignorar los fallos y a volver a ejecutar hasta que salga verde. Cada tipo necesita un trato distinto.
Las comprobaciones que muerden deberían ser obligatorias: sin ellas no hay fusión, automática o no. Las que simplemente existen deberían examinarse. Algunas merecen conservarse porque protegen contra problemas raros pero graves. Otras son ruido y pueden eliminarse, lo que hace la cadena más rápida y la señal más clara. Las inestables deberían arreglarse o desactivarse de inmediato. Una comprobación que da falsas alarmas socava a todas las demás, porque te enseña que el rojo no siempre significa que algo esté mal.
Una puerta es tan sólida como las comprobaciones que de verdad te creerías.
Los agentes pueden ayudar a reforzar las comprobaciones, y es uno de los mejores usos de la capacidad sobrante de los agentes. Pide a un agente que mire un módulo importante y proponga tests para sus casos límite. Pídele que introduzca a propósito un fallo pequeño y mire si los tests existentes lo cazan; si no, has encontrado un hueco. Pídele que encuentre los tests inestables ejecutando la suite varias veces y comparando resultados. Cada una de estas cosas convierte una confianza vaga en tus comprobaciones en una confianza medida.
Presta especial atención a las comprobaciones de lo que más importa. Si lo más importante que hace tu proyecto es calcular bien las facturas, las comprobaciones del cálculo de facturas deberían ser las más sólidas que tengas, con tests para cada caso límite que se te ocurra. Si lo más importante es que una página cargue rápido para usuarios con conexiones lentas, debería haber una comprobación que fallara si no lo hiciera. Las comprobaciones deberían reflejar los riesgos, y los riesgos mayores merecen los dientes más afilados.
Fuera del código, las comprobaciones tienen otro aspecto, pero el principio se mantiene. Una receta para redactar correos a clientes podría incluir la comprobación de que cada cifra tiene fuente. Una receta para publicar entradas podría incluir la comprobación de que todos los enlaces funcionan y todas las imágenes tienen texto descriptivo. Son comprobaciones en el mismo sentido: cosas que deben pasar antes de entregar y que cazarían un problema real.
Esta semana, enumera cada comprobación de la cadena de entregas de un proyecto y marca cada una como muerde, existe o inestable. Arregla o elimina las inestables. Para la parte más importante del proyecto, pide a un agente que intente colar un fallo pequeño entre las comprobaciones. Si lo consigue, ya sabes cuál es la próxima comprobación que tienes que escribir.
Fig. 64 · Comprobaciones de fiar. Comprobaciones clasificadas en muerde, solo existe e inestable, cada una con su tratamiento.
Capítulo 65 · Parte VII
Pasadas con número
Los trabajos grandes no tienen por qué hacerse en un solo intento heroico. Pueden hacerse por pasadas: una primera versión que acierta con la forma, una segunda que rellena el detalle, una tercera que pule. Cada pasada es una unidad completa y revisable con su propio número, y cada una se apoya en la anterior. Así han trabajado siempre muchos escritores, diseñadores e ingenieros, y encaja de maravilla con el trabajo de los agentes.
La clave es numerar las pasadas y dar a cada una un propósito distinto. Pasada uno: estructura y esqueleto, todo presente pero en bruto. Pasada dos: sustancia, cada parte rellena como es debido. Pasada tres: calidad, casos límite resueltos, lenguaje ajustado, detalles comprobados. Dile al agente en qué pasada está y para qué es. Un agente al que se le pide la pasada uno no malgastará esfuerzo puliendo. Un agente al que se le pide la pasada tres no reestructurará.
Las pasadas numeradas facilitan muchísimo la revisión. Revisas la pasada uno solo por la forma, con la primera mitad de la revisión en dos pasadas. Revisas la pasada dos por la sustancia. Revisas la pasada tres por la calidad y el gusto. En cada fase buscas un solo tipo de problema, lo que es mucho menos agotador y mucho más fiable que buscar todos los tipos de problema a la vez. Y como cada pasada se revisa antes de empezar la siguiente, los problemas se cazan en el momento más barato.
No pidas la perfección. Pide la pasada uno, y luego la pasada dos.
Las pasadas también hacen visible el progreso. En lugar de un trabajo grande que está en algún punto entre empezado y terminado, tienes un registro claro: pasada uno hecha, pasada dos en curso. Eso encaja limpiamente en el registro y en las notas de relevo. También facilita parar en el punto justo. Algunos trabajos solo necesitan dos pasadas. Otros, cuatro. Numerarlas te permite decidir, tras cada revisión, si merece la pena otra.
Conserva cada pasada. Guarda la pasada uno antes de empezar la dos, ya sea como versión en un repositorio, como archivo numerado o como copia en la carpeta del proyecto. Si la pasada dos sale mal, puedes volver a la uno sin perder nada. Si más adelante quieres entender cómo evolucionó el trabajo, las pasadas cuentan la historia. A veces los agentes hacen una pasada posterior peor que una anterior, sobre todo cuando se les pide mejorar algo que ya estaba bien, y tener a mano la versión anterior hace fácil notarlo y recuperarse.
Las pasadas funcionan para casi cualquier tipo de producto. Un informe: esquema, borrador, edición. Una funcionalidad: modelo de datos, lógica, interfaz. Un diseño: maquetación, contenido, pulido visual. Un conjunto de datos: esquema, carga, validación. En cada caso se aplica la misma disciplina: nombra la pasada, enuncia su propósito, revísala para ese propósito, consérvala y empieza la siguiente.
Esta semana, toma un trabajo de cierta envergadura y hazlo en pasadas numeradas explícitas. Encarga cada pasada por separado con su propósito. Revisa cada una por su propio tipo de problema. Conserva cada versión. Al final, compara cómo fue el trabajo con cómo suele irte un único intento grande. La diferencia suele estar menos en la calidad final, que puede ser parecida, que en lo mucho más tranquilo que fue el camino.
Fig. 65 · Pasadas con número. Trabajo hecho en pasadas con número, cada una revisada para un tipo de problema y guardada.
Capítulo 66 · Parte VII
Entregar gana a perfecto, casi siempre
Hay un viejo principio, muy querido por cualquiera que haya entregado algo alguna vez, según el cual entregar gana a perfecto. Una cosa buena en el mundo vale más que una cosa perfecta en una carpeta de borradores. Los usuarios pueden reaccionar a lo que existe; no pueden reaccionar a lo que sigues puliendo. Los agentes hacen este principio más pertinente que nunca, porque la distancia entre suficientemente bueno y perfecto suele ser mucho menor de lo que parece, y el tiempo dedicado a cerrarla suele estar mejor invertido en lo siguiente.
Pero el principio tiene un asterisco, y los operadores que lo olvidan lo aprenden por las malas. Entregar gana a perfecto cuando el coste de equivocarse es bajo y el coste de deshacer es pequeño. Cuando cualquiera de los dos costes es alto, el cálculo cambia, y un poco más de pulido antes de entregar no es perfeccionismo sino prudencia.
Piénsalo en dos ejes. Uno es cuánto pulido ha recibido el trabajo. El otro es cuánto costaría deshacerlo si resulta estar mal. El trabajo barato de deshacer puede entregarse con un pulido modesto: si algo no cuadra, se arregla mañana. El trabajo caro de deshacer, un correo a todos los clientes, un cambio en cómo se calcula el dinero, una declaración pública, un borrado, necesita más pulido antes de salir. El rincón en el que deberías entregar ya es el de coste de deshacer bajo y pulido suficiente, que es donde está casi todo el trabajo.
Entrega lo que puedes recuperar. Pule lo que no.
La trampa de los perfeccionistas es tratar cada trabajo como si fuera caro de deshacer. Una entrada de blog puede editarse después de publicarse. Una página puede arreglarse en la siguiente entrega. Una funcionalidad puede mejorarse la semana que viene. Ninguna de estas cosas necesita ser perfecta antes de salir; necesita ser buena y correcta. Retenerlas para pulirlas no es cautela. Es retraso, y el retraso tiene sus propios costes.
La trampa de los que entregan es la contraria: tratarlo todo como barato de deshacer porque casi todo lo es. Un operador con una fuerte inclinación a entregar, armado con agentes rápidos, puede sacar algo irreversible con la misma ligereza que algo trivial. El hábito que lo evita es etiquetar el trabajo por su coste de deshacer antes de revisarlo, como parte del encargo. Coste de deshacer bajo: revisa a la ligera, entrega rápido. Coste de deshacer alto: revisa a fondo, plantéate una entrega escalonada, consúltalo con la almohada si puedes.
Hay un camino intermedio para el trabajo que es caro de deshacer pero tiene que salir: abaratar el deshacerlo. Publícalo primero para un público reducido. Ponlo tras un interruptor que puedas apagar. Envía el correo a ti mismo y a un colega antes de enviarlo a la lista. Muchas acciones irreversibles pueden volverse parcialmente reversibles con un poco de reflexión, y esa reflexión suele salir más barata que el pulido extra.
Esta semana, etiqueta todo lo que entregues con su coste de deshacer: bajo o alto. Entrega lo bajo en cuanto sea bueno y correcto. Da a lo alto una revisión especialmente cuidadosa y, donde sea posible, un camino de vuelta. Fíjate en lo rápido que se mueve lo bajo cuando dejas de tratarlo como lo alto.
Fig. 66 · Entregar gana a perfecto, casi siempre. Trabajo situado por pulido y coste de deshacer; lo barato de deshacer y suficiente se entrega ya.
Capítulo 67 · Parte VII
La nota de entrega
Toda entrega merece una nota. No larga, y no necesariamente pública, sino un registro breve escrito en el momento de la entrega que diga qué salió, por qué, qué podría salir mal y cómo deshacerlo. Lleva dos minutos. Son los dos minutos más útiles que puedes dedicar en el momento de entregar, y casi siempre se omiten.
La nota tiene cuatro partes. Qué: el cambio, en una frase que entendería un usuario o tu yo futuro. Las exportaciones ahora incluyen los elementos archivados. Por qué: el motivo, brevemente. Los usuarios pidieron un historial completo. Riesgo: qué podría salir mal, en tu estimación sincera. Las cuentas grandes podrían notar exportaciones más lentas. Deshacer: cómo revertirlo si hace falta. Revertir la fusión; no hay cambios de datos. Cuatro líneas, reunidas en torno a la entrega como los radios en torno a un eje.
Las líneas de riesgo y de deshacer son las que rinden. Escribir lo que podría salir mal te obliga a pensarlo un momento, lo que a veces revela un problema antes de entregar. Y escribir cómo deshacerlo significa que, si algo sale mal a una hora intempestiva, no tienes que idear la recuperación bajo presión. Lees la nota y la sigues. Los operadores que han tenido que idear una marcha atrás a medianoche con un cliente preocupado al teléfono suelen adoptar las notas de entrega muy deprisa a partir de entonces.
El momento de escribir cómo deshacerlo es antes de necesitarlo.
¿Dónde deberían vivir las notas? En algún sitio donde las encuentres cuando algo salga mal. Un archivo de registro de cambios en el proyecto, al que se añade una entrada con cada entrega, funciona bien. También una sección en la descripción de la pull request, o una entrada en el cuaderno etiquetada con el nombre del proyecto. Para las entregas que ven los usuarios, un registro de cambios público es un documento aparte y útil, pero no sustituye a la nota privada, que puede ser más franca sobre los riesgos.
Los agentes pueden redactar notas de entrega a partir de la pull request y el diff, y es un uso sensato. Pero la línea de riesgo, en particular, necesita tu atención, porque depende de un conocimiento que el agente quizá no tenga: qué clientes son sensibles a qué cambios, qué ha salido mal antes, qué te preocupa en silencio. Edita el borrador antes de fiarte de él.
Las notas de entrega alimentan también tus revisiones más largas. Al final de una semana o de un trimestre, releer las notas de entrega te da un registro preciso y fechado de qué se entregó, qué riesgos aceptaste y cuáles se materializaron. Es un material excelente para aprender: puedes ver si tus estimaciones de riesgo tienden a ser demasiado pesimistas o demasiado optimistas, y ajustarlas.
Hay también un modesto beneficio de disciplina. Si no consigues escribir una línea de qué sensata, probablemente la entrega agrupa demasiado. Si no puedes escribir el deshacer, la entrega quizá sea más irreversible de lo que creías. La nota es una última comprobación disfrazada de papeleo.
Esta semana, escribe una nota de entrega de cuatro líneas para todo lo que entregues. Guárdalas en un solo sitio por proyecto. En el cierre del viernes, reléelas. Fíjate en qué riesgos nombraste, cuáles ocurrieron y cuáles no. Ese pequeño ejercicio te hará mejor juez del riesgo más deprisa que cualquier cantidad de lecturas sobre el tema.
Fig. 67 · La nota de entrega. Una nota de entrega en cuatro radios: qué, por qué, riesgo y cómo deshacerlo.
Capítulo 68 · Parte VII
Volver atrás es una funcionalidad
Las cosas salen mal después de entregar. No a menudo, si entregas en pequeño y revisas bien, pero a veces, y cuando ocurre, la pregunta más importante es lo rápido que puedes dejarlo todo como estaba. Una operación que puede volver atrás en un minuto puede permitirse entregar con audacia. Una operación que no puede volver atrás tiene que entregar con nervios, despacio y rara vez. Volver atrás no es un procedimiento de emergencia. Es una funcionalidad de un proceso de entrega sano, y hay que diseñarla, probarla y mantenerla funcionando.
La secuencia que quieres es corta. Entregas un cambio. Tú o una comprobación detectáis un problema. Vuelves atrás. El servicio se restablece, y solo entonces investigas. El orden importa. El instinto, cuando algo se rompe, es diagnosticarlo sobre la marcha y arreglarlo hacia delante, porque estás bastante seguro de saber qué falla y el arreglo probablemente es pequeño. A veces funciona. A menudo el arreglo introduce un segundo problema, y ahora estás depurando bajo presión con usuarios afectados. Volver atrás primero quita la presión. Puedes investigar con calma con todo funcionando.
Para el código de un repositorio, volver atrás suele ser sencillo: revertir la fusión y volver a desplegar. Asegúrate de saber exactamente cómo hacerlo en cada proyecto y de que funciona de verdad. Algunas configuraciones de despliegue lo hacen trivial; otras lo hacen sorprendentemente engorroso. Averígualo antes de necesitarlo. Un procedimiento de marcha atrás que nunca se ha probado es una hipótesis, no un procedimiento.
Si no puedes deshacerlo, no lo has entregado. Te has comprometido con ello.
Algunos cambios son más difíciles de revertir que otros, y merecen una reflexión extra antes de entregarse. Los cambios de base de datos que eliminan o transforman datos no pueden simplemente revertirse, porque los datos antiguos han desaparecido. Los correos y mensajes, una vez enviados, no pueden desenviarse. Los cambios de los que dependen otros sistemas pueden dejar esos sistemas en un estado raro si se revierten. Para estos, planifica la marcha atrás antes de entregar: haz copia de los datos, haz el cambio de forma compatible con lo anterior o escalona la entrega para que primero lo vea solo un público reducido.
Los agentes pueden ayudar a planificar la marcha atrás. Como parte del encargo de cualquier cambio arriesgado, pide al agente que describa cómo podría revertirse el cambio y qué se perdería. Si la respuesta es complicada o implica pérdida de datos, es una señal para reestructurar el cambio antes de entregarlo. Muchos agentes, si se les pide, también escribirán los pasos de marcha atrás en la descripción de la pull request, lo que los pone exactamente donde mirarás cuando los necesites.
Después de cualquier marcha atrás, escribe una nota de incidente, que se describe en una parte posterior de este libro. La marcha atrás restableció el servicio; la nota se asegura de que el mismo problema sea menos probable la próxima vez. Juntas convierten un mal momento en una mejora.
Esta semana, elige tu proyecto más importante y haz un ensayo de marcha atrás. Entrega un cambio inofensivo y luego reviértelo, cronometrando cuánto tarda todo y anotando cualquier paso engorroso. Arregla los pasos engorrosos. Luego escribe el procedimiento en el manual de operaciones del proyecto. Probablemente nunca lo necesites con prisa. Si lo necesitas, te alegrarás de que fuera una funcionalidad y no una improvisación.
Fig. 68 · Volver atrás es una funcionalidad. Cuando una entrega sale mal: revertir, restaurar el servicio y luego investigar.
Capítulo 69 · Parte VII
Nunca subas secretos
Casi todas las reglas de este libro son valores por defecto, puntos de partida sensatos que deberías adaptar a tu propia operación. Esta no. Nunca subas secretos. Ni a un repositorio, ni a un archivo de memoria, ni a un documento compartido, ni a un encargo, ni a la descripción de una pull request, ni a un cuaderno que se sincroniza con la nube. Contraseñas, claves de acceso, tokens, cadenas de conexión privadas: nada de eso pertenece a ningún sitio donde se guarde código o notas.
El motivo es sencillo. Los repositorios y las notas están diseñados para copiarse, compartirse, sincronizarse y conservarse para siempre. Una vez que un secreto está en el historial de un repositorio, quitarlo de la versión actual no lo quita del historial, ni de los clones hechos entretanto, ni de ningún servicio que lo haya indexado. Un secreto que se ha subido debe darse por visto. La intersección entre tu código y un secreto no es un sitio donde se guardan cosas. Es un incidente esperando a ser descubierto.
Los agentes suben la apuesta de dos maneras. Primero, trabajan deprisa y tocan muchos archivos, así que un secreto pegado en un encargo o encontrado en un archivo de configuración puede acabar en un commit sin que lo notes. Segundo, son serviciales, y un agente que depura un problema de conexión bien puede poner una credencial directamente en el código para probarla y luego olvidarse de quitarla.
Un secreto en un repositorio ya no es un secreto. Es una cuenta atrás.
Las defensas van por capas. Guarda los secretos en un almacén como es debido, en variables de entorno o en la gestión de secretos que ofrezca tu plataforma, y cárgalos en tiempo de ejecución. Nunca pegues el valor de un secreto en un encargo; dile al agente dónde está configurado y deja que use el mecanismo. Asegúrate de que los archivos que guardan secretos locales están excluidos del control de versiones, y compruébalo al montar cualquier proyecto nuevo. Activa el escaneo de secretos en tus repositorios siempre que la plataforma lo ofrezca, para que un secreto subido se cace en el momento del push y no meses después. Y pon una instrucción fija en la memoria de cada proyecto: las credenciales y los tokens nunca deben escribirse en el código, las notas ni los commits.
Si aun así se sube un secreto, actúa de inmediato y en el orden correcto. Primero rota el secreto, para que el valor expuesto deje de funcionar. Luego quítalo del repositorio y, si procede, del historial. Luego comprueba si alguien más usó el valor expuesto mientras estaba activo. Luego escribe una nota de incidente y añade la salvaguarda que lo habría cazado. Rotar primero es el paso crucial. Borrar la línea sin rotar es como cambiar la etiqueta de la cerradura sin cambiar la cerradura.
Esta es la única regla del libro que merece convertirse en un reflejo. Cada vez que estés a punto de pegar algo en un encargo, una nota o un archivo, pregúntate: ¿es un secreto? Si lo es, detente y búscale el sitio adecuado.
Esta semana, activa el escaneo de secretos en todos tus repositorios, comprueba que los archivos de secretos locales están excluidos del control de versiones y añade la instrucción fija a cada archivo de memoria. Luego rota todo aquello de lo que no estés completamente seguro de que nunca se haya subido. Es una tarde de trabajo aburrido. Cierra la única puerta que nunca debería estar abierta.
Fig. 69 · Nunca subas secretos. Código que toca un secreto es un incidente: primero rotar, luego quitar, comprobar, anotar.
Capítulo 70 · Parte VII
Terminado significa en vivo
¿Cuándo está algo terminado? Los operadores responden a esta pregunta de forma distinta, y la respuesta moldea en silencio cuánto se entrega de verdad. Algunos consideran el trabajo terminado cuando el agente informa de que ha acabado. Otros, cuando se supera la revisión. Otros, cuando se fusiona la pull request. La respuesta más útil, y la que recomienda este libro, es más estricta: terminado significa en vivo, delante de las personas para las que era, y comprobado ahí.
La cadena que va del trabajo acabado al trabajo terminado tiene varios eslabones, y cada uno es un sitio donde las cosas se atascan. El trabajo está fusionado pero no desplegado, porque el despliegue es un paso aparte que nadie lanzó. Está desplegado pero no en vivo, porque está tras un interruptor que nunca se encendió, o en un servidor de pruebas que nadie visita. Está en vivo pero sin comprobar, porque diste por hecho que si se desplegó tenía que funcionar. Cada atasco deja el trabajo en un estado que parece terminado y no lo está, y es un estado sorprendentemente cómodo en el que dejar las cosas.
El último eslabón, comprobado, es el que más importa. Una vez que el trabajo está en vivo, míralo ahí. Abre la página en el sitio real. Usa la funcionalidad como lo haría un usuario. Confirma que el correo llegó a una bandeja de entrada real. Comprueba que los datos aparecen en el panel real. Lleva un minuto o dos y caza toda una clase de problemas que ninguna cantidad de comprobaciones previas puede cazar: diferencias de configuración entre entornos, cachés, permisos, servicios de terceros que se comportan de otra manera en producción. Un trabajo que superó todas las comprobaciones antes de entregarse puede fallar igualmente en el mundo real, y la única forma de saberlo es mirar.
Fusionado es un hito. En vivo y comprobado es un resultado.
Definir así el terminado cambia el comportamiento río arriba. Cuando sabes que terminado significa en vivo y comprobado, encargas pensando en la entrega: ¿cómo se desplegará esto, cómo se encenderá, cómo lo comprobaré en producción? Notas la fricción del despliegue, porque cada despliegue atascado impide que algo esté terminado. Programas la comprobación en lugar de darla por hecha. Y el registro se vuelve más honesto, porque los proyectos no se marcan como hechos hasta que de verdad lo están.
También cambia cómo cuentas. El capítulo anterior sobre el volumen sugería contar lo terminado. Con terminado significando en vivo y comprobado, la cuenta pasa a ser una cuenta de cosas que de verdad llegaron a la gente. Es un número menor que el de fusiones o finalizaciones, y es el único que refleja lo que tu operación hizo por alguien.
Para el trabajo que no se despliega, el principio se traduce. Un documento está terminado cuando la persona a la que iba dirigido lo ha recibido y puede abrirlo. Un conjunto de datos está terminado cuando está cargado donde se va a usar y se ha comprobado una muestra. Un diseño está terminado cuando está en manos de quien vaya a construirlo o publicarlo. En cada caso, terminado se define en el extremo lejano de la cadena, no en tu mesa.
Esta semana, cambia tu definición de terminado a en vivo y comprobado, y aplícala a todo. Fíjate en cuántas cosas que antes habrías llamado terminadas están atascadas en un eslabón anterior. Empuja cada una hasta el final y mírala ahí. Algunas necesitarán un pequeño arreglo que, si no, se te habría escapado. Todas estarán, por fin, terminadas.
Fig. 70 · Terminado significa en vivo. La cadena de informado a comprobado, con los atascos donde el trabajo parece hecho.
Parte VIII
Semanas, trimestres y energía
Ciclos más largos y el presupuesto de fondo.
Capítulo 71 · Parte VIII
La revisión semanal
El día tiene su revisión y su cierre. La semana necesita algo mayor: una hora, una vez por semana, en la que te apartas del ritmo diario y miras la operación en su conjunto. La revisión semanal es donde notas lo que los días no pueden mostrarte, el proyecto que se ha atascado sin hacer ruido, el patrón de problemas, el compromiso que olvidaste, y donde decides para qué es la semana que viene.
La revisión tiene cuatro movimientos. Reunir: recoger todo lo que pasó esta semana. El registro, el cuaderno, las notas de entrega, la cola de ideas aparcadas, los hilos abiertos. Revisar: leerlo todo buscando lo que fue bien, lo que fue mal y lo que no se ha movido. Decidir: tomar las decisiones que la semana ha sacado a la superficie, sobre qué proyectos empujar, cuáles aparcar, qué hilos cerrar, qué recetas arreglar. Planear: esbozar la semana que viene, no al detalle, sino en términos de los dos o tres resultados que la convertirían en una buena semana.
Decidir es el corazón del asunto. Una revisión semanal que reúne y lee pero no decide es una hora agradable de reflexión sin efecto alguno. Asegúrate de que la revisión produce decisiones, por escrito, al menos unas cuantas cada semana. Aparcar el esquema del curso hasta el próximo trimestre.Cerrar los tres hilos sueltos de la migración antigua.Añadir la comprobación del archivo vacío a la receta de importación.Resultado principal de la semana que viene: entregar la funcionalidad de exportación. Estas son las frases que convierten la reflexión en dirección.
El día te mantiene en movimiento. La semana te mantiene bien orientado.
Elige una hora fija y protégela. Muchos operadores prefieren el final de la semana laboral, cuando la semana está fresca en la memoria y la revisión puede servir también como un cierre en condiciones antes del fin de semana. Otros prefieren el principio de la semana, cuando están descansados y planificar sale de forma natural. Las dos opciones funcionan. Lo que no funciona es revisar cuando encuentres una hora libre, porque no la encontrarás.
Los agentes pueden encargarse de buena parte de la recogida. Una buena receta pide a un agente que lea las entradas del cuaderno de la semana, el registro, las notas de entrega y los hilos abiertos, y que produzca un resumen breve: qué se entregó, qué se atascó, qué te está esperando, qué parece rancio. Ese resumen hace la revisión más rápida y más completa. No sustituye tu lectura del material de fondo, sobre todo del cuaderno, donde tus propias palabras a menudo revelan más que cualquier resumen.
La revisión semanal también mantiene la máquina. Es el momento natural para comprobar que el registro está al día, podar la cola, cerrar hilos sueltos, echar un vistazo a los archivos de memoria por si hay algo rancio y asegurarse de que nada ha quedado en un estado ambiguo. Diez minutos de orden cada semana evitan la lenta acumulación de desorden que, si no, haría falta un día entero para despejar.
Esta semana, reserva una hora para la revisión semanal y hazla con los cuatro movimientos. Reunir, revisar, decidir, planear. Escribe al menos cinco decisiones. La semana que viene, empieza la revisión comprobando si esas decisiones se llevaron a cabo. Ese bucle sencillo, decidir y luego comprobar, es lo que convierte la revisión semanal en un motor y no en un ritual.
Fig. 71 · La revisión semanal. Reunir, revisar, decidir y planificar, repartido entre el resumen de un agente y tu lectura.
Capítulo 72 · Parte VIII
Despejar la cubierta
A lo largo de una semana se acumulan cabos sueltos. Un hilo que empezaste y no terminaste. Un mensaje que pensabas contestar. Una idea en la cola. Una revisión a medias. Una pull request esperando. Una nota para ti mismo de mirar algo. Cada uno es pequeño, y cada uno se queda en el fondo de tu mente consumiendo una brizna de atención. Juntos producen el zumbido bajo y constante de las cosas sin resolver, que es una de las sensaciones más agotadoras que puede tener un operador.
Despejar la cubierta es la práctica de tomar, una vez por semana, cada cabo suelto y resolverlo de una de unas pocas maneras. Cerrarlo, terminándolo si lleva dos minutos. Decidirlo, eligiendo qué pasará a continuación y apuntándolo. Aparcarlo, con una nota y una condición. O soltarlo, aceptando que no va a ocurrir y dejándolo ir. El objetivo no es terminarlo todo. Es asegurarse de que nada se queda en estado de indecisión.
El embudo es empinado. Empiezas con todos los cabos sueltos que puedas encontrar, y habrá más de los que esperabas. La mayoría, examinados de cerca, solo necesitan una decisión rápida: este hilo puede cerrarse, aquella idea puede soltarse, este mensaje necesita una respuesta de una línea. Un número menor necesita reflexión de verdad. Al fondo, cada cabo ha quedado despejado o tiene un siguiente paso claro, y el zumbido se calla.
Un cabo suelto cuesta atención trabajes en él o no. Uno decidido no cuesta nada.
Encontrar los cabos es la mitad del trabajo. Mira en los sitios obvios: el registro, la cola, los hilos abiertos, las carpetas de borradores, las pull requests, tu bandeja de entrada. Luego mira en los menos obvios: el cuaderno, donde quizá escribiste tengo que mirar esto el martes y nunca lo hiciste; el final de los informes de los agentes, donde se enumeran preguntas abiertas que luego se olvidan; los rincones de tu mesa, física o digital. Muchos operadores tienen una lista breve de sitios donde mirar, que convierte encontrar los cabos de un acto de memoria en una rutina.
Sé decidido a la hora de soltar. Algunos cabos nunca se harán, y está bien, pero solo si lo admites. Una idea que lleva un mes en la cola sin entrar en ningún plan semanal probablemente no va a ocurrir. Suéltala. Un hilo que exploraba algo que ya no te importa puede cerrarse. Soltar no es fracasar. Es una decisión, y las decisiones son lo que despeja la cubierta.
Los agentes pueden ayudar a encontrar cabos. Pide a uno que enumere todos los hilos abiertos con la fecha de su última actividad, todas las pull requests en borrador, todas las preguntas sin responder de los informes recientes y todos los elementos de la cola de más de dos semanas. Esa lista es un buen punto de partida. Pero decidir te toca a ti, y es mejor hacerlo deprisa, casi con brío, sin agonizar sobre cada elemento.
Esta semana, como parte de la revisión semanal, despeja la cubierta. Encuentra cada cabo suelto y, para cada uno, ciérralo, decídelo, apárcalo o suéltalo. Cuenta con cuántos empezaste y cuántos quedan sin decidir al final. El objetivo para la segunda cifra es cero. Puede que no lo alcances la primera vez. Notarás el silencio cuando te acerques.
Fig. 72 · Despejar la cubierta. Cada cabo suelto se localiza y se cierra, decide, aparca o suelta hasta que no quede ninguno.
Capítulo 73 · Parte VIII
Contar lo entregado
Los operadores con agentes pueden perder la cuenta de lo que de verdad han conseguido. Pasa tanto, funcionan tantos hilos, llega tanto material, que al final de una semana es genuinamente difícil decir qué ha cambiado. Esto importa más de lo que parece, porque un operador que no sabe qué se entregó no puede juzgar si la operación funciona, y tiende a compensar la incertidumbre empezando más cosas.
El remedio es una cuenta semanal honesta. No de horas trabajadas, hilos empezados o tokens usados, sino de cosas entregadas: en vivo y comprobadas, delante de las personas para las que eran. Lleva la cuenta en el cuaderno o en el registro, con una línea por elemento. Al final de la semana, lee la lista.
Ayuda ver la cuenta como la cima de una pila. En la base está todo lo empezado: la capa más ancha y la menos significativa. Encima está todo lo que han acabado los agentes, más estrecha. Encima, todo lo fusionado o enviado, más estrecha aún. En la cima está lo que quedó en vivo y comprobado. Cada capa es real, pero solo la de arriba es un resultado. Muchos operadores, cuando hacen esta cuenta por primera vez, descubren que su capa superior es sorprendentemente fina comparada con las de debajo.
Cuenta lo terminado. Lo empezado ya se cuida solo.
Ese descubrimiento es útil, no deprimente. Una capa superior fina con una intermedia gruesa significa que el trabajo se atasca entre acabado y entregado, normalmente en el despliegue, en la revisión final o en el momento de enviar algo de verdad. Una capa superior fina con una base gruesa significa que se empieza demasiado y no se lleva lo suficiente hasta el final. Cada patrón sugiere un remedio concreto, y la cuenta te dice qué patrón tienes.
La cuenta también es buena para la moral, en el buen sentido. Trabajar solo puede aislar, y sin compañeros que reparen en tu trabajo es fácil sentir que no consigues gran cosa. Una lista escrita de lo entregado, leída al final de la semana, es una prueba concreta de lo contrario. Las semanas en que la lista es corta, es un aviso para preguntarse por qué, sin culpa, como uno se preguntaría por una máquina que funciona por debajo de su capacidad.
Guarda las cuentas. A lo largo de un trimestre se convierten en un registro de la producción real de la operación, muchísimo más útil que tu recuerdo de ella. En la revisión trimestral, leer doce semanas de listas de lo entregado te muestra tendencias que ninguna semana suelta revela: qué tipos de trabajo se entregan de forma fiable, cuáles se atascan, cómo ha cambiado el volumen, si tus estimaciones de capacidad son acertadas.
Sé estricto con lo que cuenta. Algo está entregado si está en vivo y comprobado, no si está casi, fusionado pero no desplegado, o enviado al agente para una última revisión. El rigor mantiene honesta la cuenta, y las cuentas honestas son las únicas que merece la pena llevar.
Esta semana, lleva una lista de lo entregado, una línea por elemento, con una definición estricta. En la revisión semanal, léela y compárala con lo que empezaste. Mira la distancia entre las capas. En esa distancia se esconde la próxima mejora de tu operación.
Fig. 73 · Contar lo entregado. El trabajo se estrecha de empezado a en vivo y comprobado; los huecos muestran dónde se atasca.
Capítulo 74 · Parte VIII
La revisión trimestral
La revisión semanal mantiene la operación apuntando en la dirección correcta. La revisión trimestral se pregunta si es la dirección correcta en absoluto. Una vez cada tres meses, tómate medio día, a ser posible lejos de la mesa de siempre, y mira toda la operación desde lo bastante lejos como para ver su forma. Aquí es donde cambias de rumbo a propósito y no por deriva.
La revisión trimestral gira en torno a cuatro preguntas sobre cada parte de la operación. ¿Qué debería seguir haciendo, porque funciona? ¿Qué debería terminar, porque ya no se gana su sitio? ¿Qué debería empezar, porque falta algo? ¿Y qué debería cambiar, porque es correcto en principio pero erróneo en la práctica? Hazte estas preguntas sobre los proyectos del registro, las recetas de la biblioteca, las herramientas de la caja, los hábitos del ritmo diario. Las respuestas son las decisiones del trimestre.
Empieza por el registro escrito. Lee las listas de lo entregado de cada semana, el registro de decisiones, las notas de incidentes y el cuaderno. Busca patrones. ¿Qué proyectos produjeron más? ¿Cuáles consumieron más atención para menos resultado? ¿Qué tipos de trabajo fueron bien y cuáles seguían saliendo mal? ¿Qué decidiste en la última revisión trimestral, y ocurrió? Esta lectura es la materia prima de unas respuestas honestas, y protege contra la tendencia natural a recordar el trimestre como mejor o peor de lo que fue.
La semana pregunta qué hacer a continuación. El trimestre pregunta qué dejar de hacer.
La pregunta de terminar es la más difícil y la más valiosa. Toda operación acumula proyectos, herramientas, hábitos y compromisos que tuvieron sentido en su día y ya no lo tienen. Persisten porque terminar cosas incomoda y continuarlas es fácil. La revisión trimestral es el momento de terminarlas deliberadamente. Un proyecto que lleva todo el trimestre aparcado sin que se cumpla su condición probablemente debería terminar. Una herramienta que no has usado en tres meses probablemente debería irse. Una receta que sigue dando malos resultados debería arreglarse o retirarse. El capítulo siguiente trata de terminar bien las cosas.
La pregunta de empezar es de donde sale el rumbo nuevo. Mira las ideas aparcadas, la cola, los huecos que reveló el trimestre. Elige como mucho una o dos cosas nuevas que empezar. Empezar más, encima de todo lo que continúa, suele significar que ninguna recibe la atención suficiente para salir adelante.
Escribe las decisiones, brevemente, y déjalas donde las encuentre la revisión del próximo trimestre. Luego haz que las revisiones semanales las ejecuten: cada decisión se convierte en una línea del registro o en un cambio en una receta o un hábito, y la revisión semanal comprueba el avance. Una revisión trimestral cuyas decisiones nunca se ejecutan es solo una tarde agradable de reflexión. Las tardes agradables están bien. No son dirigir.
Este trimestre, reserva medio día para la revisión. Lee el registro escrito. Hazte las cuatro preguntas sobre cada proyecto, receta, herramienta y hábito. Escribe las decisiones, sobre todo las de terminar. Luego pásaselas a las revisiones semanales para que las ejecuten. Dentro de tres meses, reléelas y mira cuántas ocurrieron. La proporción te dirá cuánto se dirige tu operación y cuánto simplemente se mueve.
Fig. 74 · La revisión trimestral. La revisión trimestral lee el historial y pregunta: mantener, terminar, empezar o cambiar.
Capítulo 75 · Parte VIII
Matar proyectos con delicadeza
Algunos proyectos deberían terminar antes de estar acabados. El mercado se movió, el cliente cambió de opinión, la idea resultó menos interesante de lo que parecía o, sencillamente, tienes cosas mejores que hacer con la atención. Terminar un proyecto es una de las decisiones más útiles que toma un operador, y una de las más evitadas, porque parece un fracaso. No lo es. Es una poda, y una operación bien podada crece más que una asilvestrada.
La pregunta no es si el proyecto es bueno, sino si sigue valiendo lo que cuesta. Cada proyecto activo o aparcado cuesta algo: atención en el registro, culpa cuando lo miras, hilos que atender, un hueco que podría ocupar otra cosa. Si el valor probable del proyecto ya no justifica ese coste, debería terminar. A veces la respuesta será sigue adelante, y está bien. Cuando sea termínalo, la siguiente pregunta es cómo.
Termínalo bien. Eso significa cuatro cosas. Termina o cierra cada hilo, para que no quede nada en marcha. Escribe una nota de cierre breve: qué era el proyecto, qué consiguió, por qué terminó y lo que merezca conservarse. Archiva el material en algún sitio donde podrías volver a encontrarlo, en lugar de borrarlo. Y avisa a quien necesite saberlo, un cliente, un colaborador, los usuarios de una herramienta, con la antelación y la explicación suficientes para que no les pille por sorpresa.
Terminar bien un proyecto es una habilidad. Dejar que muera despacio es una costumbre.
La nota de cierre importa más de lo que parece. Los proyectos que terminan de golpe dejan confusión: hilos a medias, archivos huérfanos, una vaga sensación de asunto pendiente. Los proyectos que terminan con una nota dejan un registro limpio. Si algún día quieres resucitar la idea, la nota te dice hasta dónde llegaste y por qué paraste. Si no lo quieres nunca, la nota te permite dejar de pensar en ello, que es un alivio en sí mismo.
Busca lo que se pueda rescatar. Los proyectos terminados suelen contener piezas útiles: una receta que funcionó, un componente reutilizable, una investigación que responde a una pregunta en otra parte, una lección que merece añadirse a la memoria. Antes de archivar, dedica diez minutos a extraerlas. Son los dividendos del proyecto, y a menudo justifican el esfuerzo aunque el proyecto en sí no alcanzara su objetivo.
Los agentes pueden ayudar con la mecánica: cerrar hilos, archivar archivos, redactar la nota de cierre, enumerar las piezas reutilizables. No deberían tomar la decisión. Terminar un proyecto es exactamente el tipo de juicio que corresponde al operador, porque depende de prioridades y compromisos que solo tú puedes sopesar.
Los proyectos más difíciles de terminar son los que empezaste con entusiasmo y en los que has invertido mucho. El coste hundido tira de ti: tanto trabajo, sería un desperdicio parar ahora. Pero el trabajo está gastado en cualquier caso. La única pregunta es si la próxima hora está mejor invertida en este proyecto o en otra cosa. Responde a esa pregunta con honestidad y el coste hundido pierde su agarre.
Este trimestre, encuentra un proyecto que deba terminar y termínalo bien: hilos cerrados, nota escrita, material archivado, personas avisadas. Fíjate en cómo se siente el registro después. Más ligero, casi seguro. Esa ligereza es atención que se te devuelve.
Fig. 75 · Matar proyectos con delicadeza. Un proyecto que ya no compensa su coste se cierra bien en cuatro pasos, rescatando primero.
Capítulo 76 · Parte VIII
La energía es el presupuesto real
La forma habitual de pensar la capacidad es en horas: ¿cuántas tengo y cómo debería gastarlas? Para un operador con agentes, las horas son la unidad equivocada. Los agentes pueden trabajar cualquier número de horas. Lo que limita la operación no es tu tiempo sino tu energía: la calidad de atención que puedes aportar a decidir y revisar. Una hora de atención afilada y una hora de atención nublada son ambas una hora. No son el mismo presupuesto.
La energía varía a lo largo del día, de la semana y de periodos más largos. La mayoría de la gente tiene unas pocas horas al día en que piensa con claridad, decide bien y revisa con cuidado, y muchas más horas en que puede hacer un trabajo útil pero no el mejor. El patrón exacto cambia de una persona a otra. Lo que no cambia es que las mejores horas escasean y que el trabajo que las necesita es el más valioso de la operación.
Así que ajusta el trabajo a la energía. Piensa en las tareas del operador en dos ejes: cuánto valor crean y cuánta energía exigen. El trabajo de mucho valor y mucha energía, tomar decisiones importantes, revisar cambios arriesgados, escribir encargos para tareas difíciles, pertenece a tus mejores horas. El de poco valor y poca energía, ordenar archivos, cerrar hilos, responder mensajes rutinarios, pertenece a las horas en que no estás en tu mejor momento. El error más común es el inverso: gastar la primera hora lúcida de la mañana en el correo y la última hora nublada de la tarde en una revisión de alto riesgo.
Las horas son lo que tienes. La energía es lo que gastas.
Los agentes facilitan este ajuste, porque buena parte del trabajo rutinario puede delegarse. Pero también crean una nueva fuga de energía: la demanda constante y de bajo nivel de vigilar hilos, leer informes y responder a avisos. Cada demanda es pequeña. Juntas pueden consumir una parte sorprendente de tu mejor energía si las dejas entrar en tus mejores horas. Protege esas horas. Agrupa la vigilancia en las partes menos valiosas del día.
La energía tiene también una forma semanal y estacional. Muchos operadores descubren que deciden mejor a principios de semana y revisan mejor a mitad de semana, o que ciertos meses son sistemáticamente más agotadores que otros. Fíjate en tus propios patrones y planifica en torno a ellos. Pon las grandes decisiones donde eres más fuerte. Aligera la carga donde sabes que estarás más flojo.
Hay una tentación de tratar la energía como una cuestión de fuerza de voluntad, de atravesar a la fuerza los periodos de poca energía. Funciona de vez en cuando y fracasa como estrategia. Las decisiones tomadas con poca energía son peores, las revisiones hechas con poca energía se dejan cosas, y el coste de esos descuidos llega más tarde y más grande. Es mejor hacer menos, bien, que más, mal, sobre todo cuando los agentes están encantados de seguir haciendo sin ti.
Esta semana, puntúa tu energía cada hora en una escala sencilla de alta, media o baja. Al final de la semana, mira el patrón e identifica tus mejores horas. Luego mueve a ellas tus decisiones y revisiones más importantes, y lleva la rutina al resto. Es una pequeña reorganización. Su efecto sobre la calidad de tu trabajo no tiene nada de pequeño.
Fig. 76 · La energía es el presupuesto real. Tareas clasificadas por valor y energía que exigen, para que las mejores horas reciban lo más duro.
Capítulo 77 · Parte VIII
La atención tiene techo
Con agentes, el número de cosas que podrías tener en marcha a la vez es, en la práctica, ilimitado. Diez hilos, veinte, cincuenta, cada uno trabajando en algo útil. La limitación no son los agentes sino tú, porque cada hilo acaba necesitando tu atención: para encargarlo, desbloquearlo, revisar lo que produce y decidir qué pasa después. Tu atención tiene un techo, y el techo está mucho más bajo que el número de hilos que podrías lanzar.
Imagina tres números. Los hilos que podrías lanzar son muchísimos, limitados solo por las ideas y el presupuesto. Los hilos que puedes vigilar, siguiendo su progreso y pillándolos cuando se desvían, son muchos menos, quizá un puñado a la vez. Los hilos que puedes revisar como es debido, dando a lo que producen la atención cuidadosa que necesita antes de entregarse, son menos todavía. Ese último número es la capacidad real de la operación. Todo lo que esté por encima produce material que o bien esperará en una cola o bien se entregará sin la revisión debida.
La mayoría de los operadores, cuando estrenan agentes, trabajan muy por encima del techo. Parece eficiente: más hilos, más material, más progreso. En la práctica produce un atasco de trabajo sin revisar, una sensación creciente de ir con retraso y una rebaja progresiva de los estándares de revisión mientras intentas seguir el ritmo. El trabajo no se hace más rápido. Se hace peor, y luego parte de él hay que volver a hacerlo.
Lanza tantos hilos como puedas revisar. Ni uno más.
Encontrar tu techo exige un poco de observación honesta. Durante una semana, anota cuántos hilos lanzas cada día y cuántos de sus resultados revisas como es debido frente a cuántos lees en diagonal. El punto en que empieza la lectura en diagonal es, más o menos, tu techo. Para muchos operadores está entre tres y seis hilos de cierta envergadura al día, aunque varía muchísimo según el tipo de trabajo y lo bien escritos que estén los encargos.
Los buenos encargos suben el techo. Un hilo con una definición de terminado clara y exigencias de prueba sólidas se revisa más deprisa que uno sin ellas, así que puedes revisar más. Los cambios pequeños también lo suben, porque cada uno necesita menos revisión. Las buenas recetas lo suben, porque el trabajo conocido se evalúa más deprisa. Todas son formas de sacar más de la misma atención, y son mucho más eficaces que simplemente esforzarse más.
Delegar la revisión lo sube un poco, pero solo un poco. Un agente revisor puede hacer una primera pasada sobre el material, señalando problemas y resumiendo cambios, y eso ahorra tiempo. No elimina la necesidad de tu revisión, porque tu revisión es donde tu juicio y tu responsabilidad entran en el trabajo. Piensa en el agente revisor como un ayudante que prepara los papeles, no como uno que los firma.
Cuando estés por encima del techo, el remedio no es trabajar más horas sino lanzar menos hilos. Aparca proyectos. Pon en secuencia lo que iba en paralelo. Deja que algunas ideas esperen en la cola. Parece ir más despacio. En realidad es ir más deprisa, porque el trabajo revisado como es debido se entrega una vez y no dos.
Esta semana, encuentra tu techo. Luego, durante la semana siguiente, no lances más hilos de los que permite. Fíjate en si se entrega más o menos. A la mayoría de los operadores les sorprende la respuesta, y gratamente.
Fig. 77 · La atención tiene techo. Hilos que podrías lanzar, puedes vigilar y puedes revisar; el último es la capacidad real.
Capítulo 78 · Parte VIII
Las horas para las que sirves
Nadie sirve para ocho horas seguidas de juicio de alta calidad. La mayoría de la gente sirve para unas pocas, repartidas a lo largo del día según un patrón sorprendentemente constante una vez que lo notas. Un operador que planifica el día en torno a esas horas les saca más partido que uno que trata todas las horas como intercambiables, y muchísimo más que uno que las gasta en lo que no toca.
El día alterna de forma natural entre tres tipos de tiempo. Trabajo profundo: las horas en que puedes concentrarte por completo, tomar decisiones difíciles y revisar cambios complejos con cuidado. Trabajo ligero: las horas en que puedes hacer cosas útiles que no necesitan concentración plena, como ordenar, revisiones rutinarias, cerrar hilos, escribir encargos sencillos. Y recuperación: el tiempo intermedio, en el que no trabajas en absoluto y se reconstruye tu capacidad para el siguiente tramo profundo. Los tres son necesarios. El error es tratar el trabajo ligero o la recuperación como fracasos en hacer trabajo profundo.
Para la mayoría de la gente, el trabajo profundo llega en bloques de una o dos horas, unas pocas veces al día como mucho. Algunos encuentran su mejor bloque a primera hora de la mañana; otros, a media mañana; unos pocos, por la noche. El patrón es personal, pero suele ser estable, y merece la pena conocerlo. Una vez que conozcas tus horas profundas, protégelas. Sin mensajes, sin vigilancia, sin trabajo ligero que pueda hacerse más tarde. Pon ahí la parte más exigente de los tres resultados del día.
No puedes trabajar a fondo todo el día. Puedes organizar el día para que las horas profundas hagan el trabajo profundo.
El trabajo ligero llena buena parte del resto, y los agentes han cambiado su naturaleza. Mucho de lo que antes era trabajo ligero, dar formato, buscar, redactar lo rutinario, ahora se delega. Lo que queda es sobre todo vigilancia y revisión rápida: mirar hilos, aprobar cambios sencillos, leer resúmenes. Es trabajo de verdad y debería programarse, no dejar que se filtre en las horas profundas, donde más daño hace.
La recuperación es la parte que la gente se salta, y la que determina si el siguiente bloque profundo sirve de algo. Un paseo, una comida, una conversación, una hora haciendo algo que no tenga nada que ver. Mirar hilos en el móvil durante un descanso no es recuperación; es trabajo ligero en otra silla. Los agentes estarán perfectamente sin ti durante una hora. Tú estarás mejor por haberte ido.
El ciclo se repite a lo largo del día. Profundo, ligero, recuperación, luego profundo otra vez si te queda otro bloque dentro, ligero, recuperación, cierre. Muchos operadores descubren que dos bloques profundos al día es un buen día y tres es excepcional. Planificar más suele producir bloques que son profundos sobre el papel y superficiales en la realidad.
Esta semana, apunta en qué horas piensas mejor. Luego planifica la semana siguiente en torno a ellas: las decisiones y revisiones más difíciles en los bloques profundos, el trabajo rutinario en los ligeros y descansos de verdad entre medias. Trata los descansos como citas, no como sobras. Al final de la semana, compara la calidad de tus revisiones y decisiones con la de la semana anterior. Las horas eran las mismas. Lo que pusiste en ellas, no.
Fig. 78 · Las horas para las que sirves. Un día que alterna tiempo profundo, ligero y de recuperación, con dos bloques profundos.
Capítulo 79 · Parte VIII
Descansar es mantenimiento
Hay una suposición silenciosa, frecuente entre quienes trabajan solos y sobre todo entre quienes tienen agentes incansables, según la cual el descanso es lo que te ganas cuando el trabajo está hecho. El trabajo nunca está hecho, así que el descanso nunca termina de llegar. Los agentes siguen funcionando, los hilos siguen terminando, siempre hay una cosa más que revisar, y las tardes y los fines de semana se van llenando poco a poco de pequeños actos de comprobación. Parece diligencia. Es la lenta avería de la pieza más importante de la máquina.
El descanso no es una recompensa. Es mantenimiento. El criterio del operador, lo que hace funcionar todas las demás piezas, depende del descanso igual que una máquina depende del aceite. Sin él, las decisiones empeoran, las revisiones se dejan cosas, los encargos se vuelven más vagos, y el coste de esos fallos aparece más tarde, en trabajo rehecho, incidentes y el agotamiento particular de arreglar problemas que causaste estando cansado. El buen criterio vive en la intersección entre trabajo y descanso. Quita el descanso y la intersección desaparece.
Los agentes lo hacen más difícil de una forma concreta: nunca necesitan descansar, así que nunca te dan un punto natural para parar. Un equipo humano se va a casa al final del día y el trabajo se detiene. Los agentes pueden funcionar toda la noche, y saber que algo podría haber terminado crea una atracción hacia mirar. La atracción es más fuerte justo cuando más necesitas resistirla, tarde por la noche y los fines de semana, cuando tu criterio está en su punto más bajo y el coste de actuar sobre algo leído a medias es más alto.
La máquina puede funcionar sin descanso. El operador no. Planifica en consecuencia.
Así que mete el descanso en la estructura, no en las sobras. El cierre diario termina explícitamente la jornada. El fin de semana es fin de semana: sin revisiones, sin encargos, sin mirar, salvo que algo esté de verdad ardiendo, y casi nada lo está. Las vacaciones son vacaciones, preparadas de antemano con proyectos aparcados y relevos claros para que nada te necesite mientras estás fuera. Estos límites no son lujos. Forman parte del sistema operativo.
Haz que los límites sean más fáciles de respetar diseñando para ellos. El trabajo de los agentes por la noche y el fin de semana debería limitarse a tareas bien encargadas y de bajo riesgo que puedan esperar tranquilamente a la revisión. Los avisos deberían estar apagados fuera del horario de trabajo. Lo que de verdad pudiera necesitarte con urgencia debería ser raro, estar bien definido y llegar por un solo canal, para que el silencio en ese canal signifique que puedes parar de verdad.
Ayuda notar la diferencia entre descanso y distracción. Hacer scroll, ver algo a medias mientras piensas en el trabajo o hacer gestiones ligeras un domingo no es descansar. Descansar es tiempo en el que el trabajo de verdad no está en tu cabeza: ejercicio, gente, sueño, actividades absorbentes que no tienen nada que ver con la operación. Es cuando la mente hace su lento trabajo de fondo de dar sentido a las cosas, y muchas de las mejores decisiones llegan, sin que nadie las llame, el lunes después de un fin de semana como es debido.
Esta semana, fija un límite firme: una tarde y un día completo sin mirar, sin encargar, sin revisar. Prepáralo en el cierre previo. Fíjate en lo que le pasa a tu primera revisión después. La mayoría de los operadores descubre que es notablemente más afilada. Esa agudeza es el mantenimiento dando fruto.
Fig. 79 · Descansar es mantenimiento. El buen criterio vive donde se cruzan trabajo y descanso; quita el descanso y se va.
Capítulo 80 · Parte VIII
Un ritmo que puedas sostener
Los operadores más productivos no son los que tienen las semanas más impresionantes. Son los que tienen buenas semanas, de forma constante, durante años. Un ritmo que puedes sostener gana a un ritmo que impresiona, porque la operación se acumula como el interés compuesto. Las recetas mejoran, la memoria se enriquece, el registro se mantiene sano, el criterio se afila, y el trabajo de cada año se construye sobre los cimientos del anterior. Los arrebatos de esfuerzo heroico seguidos de recuperación no se acumulan. Oscilan.
Los agentes empujan a los operadores hacia los arrebatos. La capacidad está ahí mismo: podrías lanzar veinte hilos, trabajar toda la noche y entregar un producto entero en un fin de semana. A veces es la decisión correcta, ante un plazo real o una oportunidad que no va a esperar. Como hábito, es corrosivo. Cada arrebato toma prestado de la energía y el criterio de las semanas siguientes, y el préstamo se devuelve con intereses en forma de decisiones cansadas, revisiones fallidas y la lenta acumulación de problemas a los que se dio el visto bueno con las prisas.
Un ritmo sostenible empieza con un día estable: la revisión, las sesiones y el cierre descritos antes, con los tres de hoy como objetivo y el techo de atención respetado. Los días estables suman una semana estable, con su revisión, su cubierta despejada y su cuenta honesta de lo entregado. Las semanas estables suman un año estable, con revisiones trimestrales que cambian de rumbo a propósito y una operación que al final es notablemente mejor que al principio. La cadena no tiene nada de notable en ninguno de sus eslabones. El resultado al final sí lo tiene.
Las hazañas dan buenas historias. Los hábitos dan buenos años.
¿Cómo se siente un ritmo sostenible desde dentro? Sobre todo, tranquilo. Sabes en qué estás trabajando y por qué. Sabes qué se entregó la semana pasada. No vas atrasado con la revisión, porque solo lanzas lo que puedes revisar. Paras al final del día sin angustia, porque el cierre lo ha recogido todo. Te tomas fines de semana y vacaciones sin temor, porque la operación está diseñada para hacer pausas.
Casi siempre lo son. La prueba no es lo duro que parece, sino lo que produce a lo largo de los meses. Un operador tranquilo que entrega tres cosas bien revisadas al día, todos los días, produce más que uno frenético que entrega diez cosas una semana y ninguna la siguiente mientras se recupera de la primera. Y el trabajo del operador tranquilo suele ser mejor, porque lo revisó alguien que estaba prestando atención.
El ritmo es también algo que puedes ajustar deliberadamente. Hay temporadas en que conviene apretar un poco más y temporadas en que es sensato aflojar un poco. La revisión trimestral es el sitio natural para decidirlo: ¿qué ritmo necesita el próximo trimestre y qué haré para asegurarme de que sea sostenible? Decidir el ritmo a propósito es muy distinto de que te lo decida lo que grite más fuerte.
Esta semana, pregúntate con honestidad: ¿podría mantener el ritmo de esta semana durante un año? Si la respuesta es no, encuentra la única cosa que lo hace insostenible y cámbiala. Luego vuelve a preguntártelo la semana que viene. El objetivo es un sí que te creas. Cuando llegues, tendrás lo más valioso que puede construir un operador: una máquina que funciona bien, indefinidamente, contigo todavía en la silla.
Fig. 80 · Un ritmo que puedas sostener. Un ritmo constante se acumula por encima de los arrebatos heroicos; los días hacen semanas y años.
Parte IX
Herramientas, errores e incidentes
Mantenimiento, cicatrices y el manual de operaciones.
Capítulo 81 · Parte IX
Menos herramientas, mejor cuidadas
Nunca ha habido un momento mejor para coleccionar herramientas. Cada semana llegan nuevos productos de agentes, extensiones, conectores, complementos y servicios, cada uno prometiendo eliminar algún roce de tu día. Muchos son de verdad buenos. La mayoría de los operadores prueban muchísimos y se quedan con más de los que usan. El resultado es un cinturón de herramientas tan pesado que los frena: demasiados sitios donde mirar, demasiadas suscripciones que gestionar, demasiadas integraciones que podrían romperse y demasiado poco conocimiento a fondo de cualquiera de ellas.
El enfoque mejor es menos herramientas, mejor cuidadas. Un conjunto pequeño que conoces a fondo, usas a diario y mantienes como es debido te servirá mejor que un conjunto grande que conoces por encima y usas de vez en cuando. La profundidad importa porque el valor de una herramienta viene sobre todo de conocerla bien: sus atajos, sus límites, sus modos de fallo, cómo se comporta cuando algo sale mal. Ese conocimiento tarda en construirse, y se reparte demasiado fino cuando el cinturón es ancho.
Piénsalo como un embudo. Arriba, todas las herramientas que has probado alguna vez. Debajo, las que de verdad usas cada semana. Al fondo, tu cinturón de herramientas: el conjunto pequeño en el que confías, que conoces como es debido y cuya rotura notarías al instante. Si el tuyo tiene treinta, la mayoría probablemente están arriba del embudo haciéndose pasar por las de abajo.
Una herramienta que conoces bien gana a dos que conoces a medias.
Cada herramienta tiene un coste de mantenimiento, aunque sea gratis. Hay que actualizarla. Hay que revisar sus permisos. Hay que vigilar sus integraciones. Ocupa espacio en tu cabeza y en tus archivos de memoria. Cuando cambia, tienes que aprender el cambio. Cuando falla, tienes que notarlo y responder. Para una herramienta que usas a diario, ese coste se justifica con facilidad. Para una que usas una vez al mes, a menudo no.
Así que sé lento en adoptar y rápido en soltar. Cuando aparezca una herramienta nueva, pregúntate qué problema concreto resolvería que tus herramientas actuales no resuelven. Si no puedes nombrar ninguno, déjala pasar, por impresionante que parezca. Si puedes, pruébala en un trabajo pequeño y acotado antes de dejarla entrar en tu ritmo diario. Y cuando una herramienta deje de ganarse su sitio, quítala, limpiamente, incluidos sus permisos y cualquier memoria o receta que la mencione.
Este principio convive cómodamente con la regla de la máquina pequeña de la primera parte del libro. Un cinturón de herramientas pequeño forma parte de una máquina pequeña, y una máquina pequeña es una que puedes tener en la cabeza en un mal día. Cuando algo sale mal en una operación con cinco herramientas, sabes dónde mirar. Cuando algo sale mal en una con treinta, puedes pasarte la mañana averiguando qué herramienta está implicada.
Esta semana, enumera cada herramienta, servicio e integración que usa tu operación ahora mismo. Marca cada una con la frecuencia con que la usaste el último mes. Todo lo que no usaste es candidato a eliminarse. Todo lo que usaste solo una o dos veces merece una mirada dura. Luego quita al menos una herramienta, limpiamente. Tu cinturón pesará menos, y conocerás un poco mejor el resto gracias al espacio liberado.
Fig. 81 · Menos herramientas, mejor cuidadas. Las herramientas se reducen de todo lo probado a un cinturón pequeño conocido a fondo.
Capítulo 82 · Parte IX
La auditoría del cinturón
Las herramientas se acumulan en silencio. Un conector añadido para un proyecto sigue conectado cuando el proyecto termina. Una extensión del navegador instalada para una prueba sigue funcionando meses después. Una suscripción se renueva porque nadie la miró. Una integración de agentes sigue teniendo acceso a una carpeta que ya no usas. Nada de esto es dramático. Todo es desorden, parte cuesta dinero y una pequeña parte es un riesgo de seguridad. El remedio es una auditoría periódica.
La auditoría del cinturón es una revisión breve y estructurada, una vez por trimestre, de todo lo que en tu operación es una herramienta: software, servicios, suscripciones, conectores, integraciones, extensiones, scripts y automatizaciones. Tiene tres pasos. Enumerarlo todo. Comprobar cómo se usa cada cosa. Decidir qué conservar, cambiar o quitar.
Enumerar es el paso que más revela. La mayoría de los operadores, la primera vez que lo hacen, encuentran herramientas que habían olvidado que existían. Mira en todas partes: aplicaciones instaladas, extensiones del navegador, servicios conectados en cada una de tus plataformas principales, conectores de agentes y sus permisos, tareas programadas, automatizaciones, suscripciones en tus extractos. Los agentes pueden ayudar con partes de esto, sobre todo con enumerar integraciones y tareas programadas, pero algunos sitios tendrás que mirarlos tú.
Cada herramienta que olvidaste que tenías es una herramienta que puede darte una sorpresa.
Comprobar el uso significa preguntarse, para cada elemento: ¿cuándo lo usé por última vez, para qué, y notaría que ha desaparecido? Pregúntate también a qué puede acceder. Una herramienta que usas poco y que tiene acceso amplio a tus archivos o cuentas es una preocupación mucho mayor que una que usas a diario con acceso limitado. Presta especial atención a todo lo conectado a agentes, porque los agentes actúan con el acceso que se les da, y un acceso rancio es una invitación a que algo salga mal de una forma que no vas a prever.
Decidir es el objetivo del ejercicio. Conserva las herramientas que usas y echarías de menos. Cambia las que usas pero tienes mal configuradas: demasiado acceso, ajustes desfasados, solapamiento con otra herramienta. Quita las que no usas, limpiamente: revoca su acceso, cancela suscripciones, borra integraciones y actualiza cualquier archivo de memoria o receta que las mencione. Quitar una herramienta de tu vida pero dejar su acceso en su sitio no es quitarla. Es abandonarla.
La auditoría es también un buen momento para comprobar la salud de las herramientas que conservas. ¿Están al día? ¿Sus ajustes son los que crees? ¿Han cambiado de formas que afectan a cómo las usas? ¿Hay algo de ellas que llevas tiempo queriendo aprender? Un poco de atención aquí mantiene el cinturón afilado en lugar de simplemente presente.
Anota brevemente la auditoría en el cuaderno o en el registro de decisiones: qué quitaste, qué cambiaste, cualquier sorpresa. El próximo trimestre, empieza leyendo la última auditoría. Con el tiempo, estos registros te muestran cómo evoluciona tu cinturón y si crece o encoge, que es un indicador útil de si la regla de la máquina pequeña se sostiene.
Este trimestre, haz la auditoría. Enumera, comprueba, decide. Intenta quitar al menos unos cuantos elementos y restringir el acceso de al menos uno. Lleva una tarde. Te deja una operación que entiendes mejor y con menos sitios donde pueda pasar algo inesperado.
Fig. 82 · La auditoría del cinturón. Lista, revisa y decide cada herramienta; las poco usadas con acceso amplio preocupan más.
Capítulo 83 · Parte IX
El mantenimiento se programa
Toda operación necesita mantenimiento. Las herramientas necesitan actualizarse. Las dependencias necesitan subir de versión. Los archivos de memoria necesitan podarse. Las recetas necesitan refrescarse. Las credenciales necesitan rotarse. Las copias de seguridad necesitan probarse. Los dominios, los certificados y las suscripciones necesitan renovarse. Nada de esto es interesante, nada es urgente hasta que de repente lo es, y todo es fácil de aplazar. La única forma fiable de que se haga es programarlo.
El mantenimiento sin programar ocurre de una de dos maneras: nunca, o en plena crisis. El certificado caduca y el sitio se cae. La dependencia va tres versiones mayores por detrás y la actualización es ahora una semana de trabajo en vez de una hora. La credencial que debería haberse rotado queda expuesta. La copia de seguridad que nunca se probó resulta que no se restaura. Cada crisis cuesta muchísimo más de lo que habría costado el mantenimiento programado, y cada una llega en un momento elegido por el problema y no por ti.
El mantenimiento programado convierte estas crisis en rutina. El ciclo es sencillo. Programa cada tarea de mantenimiento con un intervalo sensato. Cuando llegue, haz la actualización. Luego verifica que la actualización funcionó y que no se rompió nada. Para entonces, la siguiente ocasión ya está en la agenda. El punto de partida del ciclo, la programación, es donde está casi todo el valor, porque es lo que hace que el resto llegue a ocurrir.
El mantenimiento en el calendario es barato. El mantenimiento en una emergencia, no.
Monta un calendario de mantenimiento. Algunas tareas son semanales: comprobar que las tareas automáticas se ejecutaron, echar un vistazo a los registros de errores. Otras son mensuales: actualizar dependencias, podar archivos de memoria, revisar los hilos abiertos. Otras son trimestrales: la auditoría del cinturón, rotar credenciales, probar la restauración de una copia de seguridad, revisar recetas. Otras son anuales: renovar dominios, revisar cada suscripción. Anótalas con sus intervalos y ponlas en el calendario que de verdad miras.
Los agentes son excelentes para el trabajo de mantenimiento, y es uno de los mejores sitios para usarlos. Una receta para actualizar dependencias puede pedir a un agente que suba de versión, ejecute la suite de tests completa e informe de cualquier fallo. Una receta para podar la memoria puede pedirle que señale las entradas rancias. Una receta para comprobar copias de seguridad puede recorrer una restauración en una ubicación de prueba. Las tareas de agentes programadas pueden ejecutar algunas de estas de forma automática. Sigues teniendo que revisar los resultados, pero la revisión es rápida cuando el trabajo es rutinario y la receta es buena.
El paso de verificar merece énfasis. El mantenimiento hecho pero no verificado está hecho a medias. Una actualización que rompió algo en silencio, una rotación que dejó activa una credencial antigua, una copia de seguridad que se ejecuta pero produce archivos vacíos: cada una parece completa hasta el momento en que la necesitas. Toda tarea de mantenimiento debería terminar con una comprobación de que cumplió de verdad su propósito.
Que el calendario de mantenimiento sea pequeño y realista. Si enumera cincuenta tareas, muchas se saltarán y el hábito se erosionará. Empieza por el puñado de tareas cuyo fallo más dolería, prográmalas y añade otras solo cuando el hábito esté asentado. Una lista corta cumplida con fiabilidad es mejor que una larga cumplida de vez en cuando.
Esta semana, escribe tu calendario de mantenimiento. Enumera las tareas, fija sus intervalos y pon en tu calendario la próxima ocasión de cada una. Luego haz hoy una tarea atrasada. Ese pequeño acto de ponerse al día es el principio de no tener que volver a ponerse al día nunca.
Fig. 83 · El mantenimiento se programa. Programar, actualizar, verificar: un pequeño calendario convierte las crisis de mantenimiento en rutina.
Capítulo 84 · Parte IX
Los permisos como política
Los agentes actúan con los permisos que se les dan. Casi todas las herramientas de agentes ofrecen ya una gama de modos, desde preguntar antes de cada acción hasta actuar libremente dentro de ciertos límites, junto con formas de permitir o denegar comandos, archivos y servicios concretos. Muchos operadores gestionan los permisos de forma reactiva: aprueban las peticiones de una en una según van saliendo y van permitiendo más a medida que se cansan de los avisos. El resultado es un conjunto de permisos que nadie diseñó de verdad, y que puede permitir muchísimo más, o muchísimo menos, de lo que se pretendía.
Un enfoque mejor es tratar los permisos como una política. Decide una vez, deliberadamente, qué pueden hacer los agentes sin preguntar, sobre qué deben preguntar antes y qué no pueden hacer nunca. Escribe esa política. Configura tus herramientas para que la impongan. Así dejas de tomar las mismas pequeñas decisiones docenas de veces al día, y puedes confiar en que los límites reflejan tu juicio meditado y no tu nivel de irritación a las cuatro de la tarde.
La política tiene tres niveles. Permitido sin preguntar: acciones seguras, reversibles y rutinarias, como leer archivos del proyecto, ejecutar la suite de tests o editar archivos dentro del alcance del proyecto. Preguntar antes de actuar: acciones significativas o más difíciles de revertir, como instalar dependencias, cambiar la configuración, ejecutar comandos con efectos fuera del proyecto o hacer llamadas de red a sitios desconocidos. Nunca permitido: acciones destructivas, irreversibles o fuera de los límites de la operación, como borrar fuera del proyecto, tocar credenciales, subir directamente a producción o acceder a archivos personales.
Decide tus permisos una vez, cuando estés tranquilo, para no decidirlos cien veces cuando estés ocupado.
Proyectos distintos pueden necesitar políticas distintas. Un experimento desechable puede ser generoso. Un proyecto de cliente con datos sensibles debería ser estricto. Un sistema en producción, más estricto todavía. Muchas herramientas permiten fijar permisos por proyecto, que es exactamente lo que quieres: que la política se ajuste al riesgo.
Revisa la política en la auditoría del cinturón, o cuando algo salga mal. Mira lo que has permitido y pregúntate si cada cosa sigue siendo apropiada. Mira sobre qué siguen preguntando los agentes y pregúntate si esas peticiones deberían aprobarse de antemano o seguir siendo avisos. Mira los incidentes y pregúntate si un cambio de permisos los habría evitado. Los permisos que nunca se revisan tienden a derivar hacia lo demasiado generoso, porque cada aprobación por separado parece inofensiva.
Presta especial atención a los permisos del trabajo desatendido: tareas nocturnas, tareas programadas, todo lo que funciona sin que lo mires. Deberían ser los más restrictivos de todos, porque no hay nadie para cazar un error en el momento en que ocurre. Una buena regla es que los agentes desatendidos reciban solo lo que necesita la tarea concreta, y nada más.
Una buena política tiene un efecto secundario agradable: menos interrupciones. Cuando las acciones rutinarias están aprobadas de antemano y las peligrosas están bloqueadas, los únicos avisos que ves son los de acciones de verdad significativas, y esos son los que merecen tu atención. El goteo de peticiones de aprobación triviales desaparece, y con él la costumbre de pulsar que sí sin leer.
Esta semana, escribe tu política de permisos para tu proyecto principal: tres listas breves. Luego contrasta con ella la configuración real de tu herramienta y corrige cualquier desajuste. Fíjate en cuántos avisos desaparecen, y en cuánta más atención prestas a los que quedan.
Fig. 84 · Los permisos como política. Los permisos de los agentes como política escrita: permitido, preguntar antes y nunca, por proyecto.
Capítulo 85 · Parte IX
Las victorias frágiles salen caras
A veces la forma más rápida de que algo funcione es un apaño. Un valor escrito a fuego en el código. Un paso manual que alguien tiene que recordar. Un script que funciona en tu máquina y en ninguna otra. Un rodeo de un agente que silencia un error en lugar de arreglarlo. El apaño te da una victoria hoy, y las victorias sientan bien. Pero las victorias frágiles generan intereses, y los intereses se pagan después, normalmente en el peor momento posible y normalmente por más de lo que valía la victoria original.
El problema de las victorias frágiles no es que fallen. Todo acaba fallando. Es que fallan de forma impredecible y silenciosa. Una fecha escrita a fuego funciona hasta que la fecha pasa. Un paso manual funciona hasta que lo olvidas. Un error silenciado esconde un problema hasta que el problema crece lo bastante como para abrirse paso. Cuando fallan, a menudo no sabes que eran frágiles, porque el apaño se hizo hace meses, quizá lo hizo un agente, y nadie lo apuntó.
Piensa en las soluciones en dos ejes: lo rápido que dan resultados ahora y lo frágiles que son. Una solución rápida y frágil es tentadora y peligrosa. Una lenta y robusta es segura y a veces excesiva. El rincón que sueles querer es el de lo bastante rápida y lo bastante robusta: no el arreglo más veloz posible, ni el más blindado, sino uno que siga funcionando sin que nadie recuerde que existe.
El apaño ahorra una hora hoy y cuesta un día el peor día del mes.
Los agentes pueden producir victorias frágiles muy deprisa, sobre todo cuando se les pide que algo funcione bajo presión. Un agente al que se le dice haz que pasen los tests puede encontrar el camino más rápido, que no siempre es el correcto. Busca las señales en la revisión: valores escritos a fuego que deberían ser configuración, errores capturados e ignorados, casos especiales añadidos para una sola entrada, comentarios que dicen temporal o arreglar luego. Cada uno es una victoria frágil en ciernes.
Cuando aceptes una victoria frágil, y a veces deberías, porque un plazo es real o lo que está en juego es poco, déjala registrada. Escribe una línea en el registro de decisiones o en la memoria del proyecto: qué es el apaño, por qué se aceptó y cuál sería el arreglo de verdad. Añade un recordatorio para volver sobre él. Un apaño registrado es una deuda conocida con un plan de pago. Uno sin registrar es una trampa esperando a alguien, normalmente a ti.
Parte de la fragilidad viene de la propia operación y no del trabajo: un paso que solo tú sabes hacer, un proceso que depende de tu memoria, una integración que nadie más podría reparar. Son victorias frágiles a nivel de la máquina, y importan todavía más para un operador en solitario, porque no hay ningún compañero en quien apoyarse. Los próximos capítulos sobre incidentes y manuales de operaciones tratan en gran parte de convertir este tipo de fragilidad en algo más sólido.
Esta semana, busca victorias frágiles en un proyecto. Busca valores escritos a fuego, errores silenciados, comentarios de temporal y pasos manuales sin documentar. Registra cada uno que encuentres y arregla el que más probabilidades tenga de dar problemas. No es un trabajo emocionante. Es el tipo de trabajo que hace que el mes que viene transcurra sin incidentes, que es el mejor tipo de mes que se puede tener.
Fig. 85 · Las victorias frágiles salen caras. Soluciones situadas por velocidad y fragilidad, apuntando a bastante rápido y bastante robusto.
Capítulo 86 · Parte IX
Los errores son datos
Los errores son inevitables en cualquier operación, y una operación con agentes comete una variedad particular de ellos. Un encargo malinterpretado. Un cambio que rompió algo inesperado. Una revisión que dejó pasar un problema. Una entrega que fue al sitio equivocado. Un mensaje enviado con un error dentro. Cada uno molesta y, de vez en cuando, sale caro. Cada uno es también un dato, y un operador que trata los errores como datos mejora muchísimo más deprisa que uno que los trata como bochornos que arreglar y olvidar.
Cuando ocurre un error, hay una bifurcación. Un camino lleva a ocultar u olvidar: arreglarlo en silencio, seguir adelante, esperar que no se repita. Es el camino natural, porque los errores incomodan y arreglarlos satisface. El otro camino lleva a aprender: arreglarlo y luego preguntarse por qué ocurrió y qué lo evitaría la próxima vez. El segundo camino lleva unos minutos más. Es el único que mejora la operación.
El valor está en el porqué. Casi todos los errores tienen causas que están río arriba del fallo visible. El agente malinterpretó el encargo porque el encargo era ambiguo. El cambio rompió algo porque no había ningún test que cubriera ese camino. La revisión dejó pasar el problema porque ocurrió al final de un día largo. La entrega fue al sitio equivocado porque el proceso de despliegue tiene un paso confuso. Arregla solo el fallo visible y la causa de río arriba sigue ahí, lista para producir el siguiente error.
Un error arreglado es un problema resuelto. Un error entendido es una clase de problemas resuelta.
Colecciona los errores en algún sitio. Una sección del cuaderno, un registro sencillo o notas de incidente para los más significativos, que describe el capítulo siguiente. Con el tiempo, la colección revela patrones: el mismo tipo de encargo se malinterpreta una y otra vez, la misma zona del código se rompe una y otra vez, la misma hora del día produce errores una y otra vez. Los patrones son muchísimo más útiles que los errores sueltos, porque apuntan a arreglos sistémicos que evitan muchos errores futuros de una sola vez.
Los agentes también cometen errores, y merecen el mismo trato. Cuando un agente hace algo mal, resiste el impulso de echarle la culpa y seguir adelante. Pregúntate qué del encargo, de la memoria, de los permisos o de las comprobaciones permitió que ocurriera. Casi siempre hay algo, y arreglarlo mejora todas las ejecuciones futuras. El error de un agente suele ser tu sistema diciéndote dónde está incompleto.
Tus propios errores merecen la misma curiosidad, y aquí ayuda un poco de compasión hacia uno mismo. Los operadores que son duros consigo mismos tienden a ocultar sus errores, incluso de sus propios cuadernos, porque escribirlos parece regodearse en el fracaso. Pero el cuaderno no es un boletín de notas. Es una herramienta para mejorar. Un error anotado con calma y examinado es un regalo para tu yo futuro. Un error enterrado no es un regalo para nadie.
Esta semana, cada vez que algo salga mal, por pequeño que sea, escribe una línea: qué pasó y por qué crees que pasó. No intentes arreglar todavía las causas. Solo colecciona. En la revisión semanal, lee las líneas y busca un patrón. Si lo encuentras, arregla su causa. Habrás convertido una semana de fastidios en una mejora duradera, que es un negocio excelente.
Fig. 86 · Los errores son datos. Tras un arreglo, ocultar deja la causa; preguntar por qué lleva a un patrón y a un arreglo duradero.
Capítulo 87 · Parte IX
La nota de incidente
Cuando algo significativo sale mal, una entrega que rompió una funcionalidad, un dato perdido, un error que llegó a un cliente, una acción de un agente que no debería haber ocurrido, escribe una nota de incidente. No un informe extenso ni un análisis formal a posteriori, solo una nota breve y estructurada que recoja qué pasó, por qué y qué va a cambiar. Lleva quince minutos. Es la forma más eficaz que tiene un operador de asegurarse de que lo mismo no ocurra dos veces.
La nota responde a tres preguntas, en orden. Qué pasó: un relato de los hechos, con horas si importan. ¿Cuál fue el efecto, quién lo notó, cómo se resolvió? Que esta parte sea llana y concreta. Por qué pasó: las causas, tanto la inmediata como las de río arriba. La causa inmediata podría ser la migración borró las filas con nombres vacíos. Las causas de río arriba podrían ser el encargo no mencionaba los nombres vacíos, no había ningún test para ese caso y el cambio se fusionó solo porque estaba etiquetado como de riesgo bajo. Qué cambia: las acciones concretas que tomarás para evitar que se repita. Cada acción debería ser concreta y tener un plazo, aunque la única persona a quien asignarla seas tú.
La pregunta del medio es donde está el valor, y merece dedicarle la mayor parte de los quince minutos. Una técnica útil es seguir preguntando por qué hasta llegar a algo que puedas cambiar en el sistema y no en el momento. El agente borró las filas: ¿por qué? Porque el encargo no decía que no lo hiciera: ¿por qué? Porque yo no sabía que existían nombres vacíos: ¿por qué? Porque nunca se han perfilado los datos: eso es algo que puedes arreglar.
Un incidente sin nota es un incidente que has aceptado volver a tener.
La sección de qué cambia debería tener un número pequeño de acciones reales, no una larga lista de buenas intenciones. Añadir un test. Actualizar la receta. Cambiar las condiciones del automerge. Añadir una línea a la memoria del proyecto. Perfilar los datos. Cada una debería hacerse en días, no en semanas, y la nota debería actualizarse cuando se haga. Una nota de incidente cuyas acciones nunca se completan es el registro de una lección no aprendida.
Guarda las notas de incidente juntas, en una carpeta o un archivo, con un índice breve. Léelas en la revisión trimestral. Los patrones entre incidentes suelen revelar más que cualquier incidente suelto: siempre falta el mismo tipo de comprobación, siempre sale mal el mismo tipo de cambio, siempre es frágil la misma parte de la operación. Esos patrones apuntan a las mejoras que más importan.
Los agentes pueden ayudar a escribir notas de incidente. Dale a uno la cronología, los diffs relevantes y el encargo, y pídele que redacte las tres secciones. Su borrador a menudo identificará causas contribuyentes que no habías considerado. Pero revisa el borrador con cuidado, sobre todo el porqué, porque las causas más importantes suelen ser cosas que el agente no puede ver: tus suposiciones, tu presión de tiempo, tu conocimiento del cliente.
Esta semana, si algo significativo sale mal, escribe la nota: qué pasó, por qué, qué cambia. Si no sale nada mal, escribe una para el incidente más significativo del último mes. Luego ejecuta las acciones. La nota es solo la primera mitad. Los cambios son lo que importa.
Fig. 87 · La nota de incidente. Una nota de incidente en tres partes, con una escalera de porqués hasta una causa arreglable.
Capítulo 88 · Parte IX
Sin culpables, incluso a solas
Los equipos que gestionan bien los incidentes suelen adoptar un principio llamado cultura sin culpa: el propósito de revisar un incidente es entender y mejorar el sistema, no encontrar a quién culpar. La gente que teme la culpa oculta información, y la información oculta empeora el sistema. Podría parecer que este principio no se aplica a un operador en solitario, ya que no hay nadie a quien culpar salvo uno mismo. En realidad se aplica con una fuerza especial, porque la persona con más probabilidades de culparte eres tú.
Culparse a uno mismo es corrosivo de una forma concreta. Cuando algo sale mal y tu primera reacción es debería haberlo visto, qué torpe, lo probable es que hagas una de dos cosas. O lo arreglas deprisa y sigues adelante, evitando la incomodidad de mirar de cerca, lo que significa que nunca aprendes la causa. O te regodeas en ello, repasando el error una y otra vez, lo que drena energía y atención sin mejorar nada. Ninguna de las dos conduce al análisis tranquilo y curioso que de verdad evita que se repita.
La cultura sin culpa vive en la intersección entre la honestidad y la amabilidad. Honestidad, porque tienes que mirar con claridad lo que pasó, incluida tu parte, sin minimizarla ni excusarla. Amabilidad, porque te acercas a esa mirada clara con la misma buena voluntad que ofrecerías a un compañero que cometió el mismo error: la suposición de que hacía lo que podía con lo que sabía en ese momento, y la atención puesta en lo que le habría ayudado a hacerlo mejor.
Mira el sistema que lo permitió, no a la persona que estaba más cerca.
En la práctica, esto significa escribir las notas de incidente y los registros de errores con un tono concreto. No me olvidé por descuido de comprobar el caso vacío, sino el caso vacío no se comprobó; el encargo no lo mencionaba y no había ningún test. Las dos frases son ciertas. La segunda apunta a cosas que puedes cambiar. La primera solo apunta a un sentimiento. No se trata de eludir la responsabilidad. Sigues siendo el operador, y el nombre de la puerta sigue siendo el tuyo. Se trata de dirigir la responsabilidad hacia donde pueda hacer algún bien.
La cultura sin culpa se extiende también a los agentes, de una forma curiosa. Cuando un agente comete un error, es tentador tratarlo como culpa del agente y seguir adelante, o perder la confianza en los agentes en general. Un enfoque sin culpa se pregunta qué del sistema permitió el error: el encargo, los permisos, las comprobaciones, la memoria. Esa pregunta casi siempre tiene una respuesta útil. El agente se equivocó casi nunca la tiene, porque no puedes arreglar el carácter de un agente, solo las condiciones en que trabaja.
Hay un beneficio práctico más allá de aprender mejor: te sientes mejor, y un operador que se siente mejor toma mejores decisiones. Culparse a uno mismo es una forma de estrés, y el estrés estrecha la atención y degrada el juicio. Un operador que puede mirar un error con calma, aprender de él y seguir adelante está en mucha mejor forma para la siguiente decisión que uno que carga con el error durante días.
Esta semana, relee las últimas cosas que escribiste sobre tus propios errores, sean notas de incidente, entradas del cuaderno o simplemente lo que te dijiste a ti mismo. Fíjate en el tono. Si es duro, reescribe una sin culpa: qué pasó, qué del sistema lo permitió, qué va a cambiar. Mira si la versión reescrita apunta a un arreglo mejor. Normalmente lo hace.
Fig. 88 · Sin culpables, incluso a solas. La ausencia de culpa está donde la honestidad se une a la amabilidad, y reescribe notas hacia arreglos.
Capítulo 89 · Parte IX
Salvaguardas nacidas de cicatrices
Las mejores salvaguardas de cualquier operación no se diseñaron de antemano. Se aprendieron. Cada una es el poso de algo que salió mal: una cicatriz que se convirtió en lección y una lección que se convirtió en norma. Un operador que convierte sistemáticamente las cicatrices en salvaguardas acaba con una operación resistente justo a los errores a los que es más propensa, que es una protección muchísimo mejor que cualquier conjunto genérico de buenas prácticas.
La cadena es directa. Algo sale mal y deja una cicatriz: una entrega rota, una tarde perdida, un mensaje bochornoso a un cliente. La nota de incidente extrae la lección: por qué pasó, qué lo habría evitado. Luego la lección se convierte en salvaguarda: algo concreto en el sistema que hace el error más difícil o imposible la próxima vez. La salvaguarda es la recompensa. Sin ella, la lección es solo algo que esperas recordar, y la memoria, como este libro no deja de repetir, no es algo en lo que apoyarse.
Las salvaguardas tienen varias formas, de blandas a duras. Una línea en un archivo de memoria o en una receta que dice a los agentes que eviten algo o que comprueben siempre algo. Un paso en una lista de comprobación, como la orden de terminar o la nota de entrega. Un test que falla si el error se repite. Un permiso que impide la acción peligrosa. Una comprobación en la cadena de entregas que bloquea la fusión. Un hook o una regla automática que interviene en el momento de riesgo. Ajusta la dureza a la gravedad de la cicatriz.
Cada norma de una buena operación tiene una historia detrás. Asegúrate de que las tuyas la tengan.
Las salvaguardas blandas son baratas y fáciles de añadir, y son la opción correcta para los errores menores. Una línea en la memoria que diga comprueba siempre que las fechas estén en la zona horaria del usuario basta para un error que causó una pequeña confusión una vez. Las salvaguardas duras exigen más esfuerzo y son la opción correcta para errores graves o repetidos. Si una vez se subió un secreto, un escáner de secretos que bloquea los push es una salvaguarda dura que hace casi imposible que vuelva a ocurrir, y merece la pena configurarlo.
Guarda la historia junto a la salvaguarda. Cuando añadas una norma a un archivo de memoria, añade una nota breve del porqué: añadida tras el incidente de exportación de marzo. Cuando añadas una comprobación, remite a la nota del incidente. Esto importa por dos motivos. Te permite juzgar, más adelante, si la salvaguarda sigue haciendo falta; si la causa de fondo se ha arreglado, quizá pueda quitarse. Y evita que la salvaguarda parezca arbitraria, a ti o a cualquiera, lo que hace más probable que se respete.
Las salvaguardas también pueden acumularse hasta convertirse en desorden, como todo lo demás. Un archivo de memoria con cincuenta normas, cada una de una cicatriz distinta, puede volverse difícil de seguir para los agentes y difícil de mantener para ti. Poda las salvaguardas en la revisión trimestral igual que podas la memoria. Quita las que ya no tienen causa. Asciende las blandas que siguen haciendo falta a otras más duras que se impongan solas. Fusiona las que se solapan.
Esta semana, mira tus tres últimos incidentes o errores significativos. Para cada uno, comprueba si se añadió una salvaguarda. Si no, añade una, eligiendo la dureza según la gravedad. Guarda la historia con ella. Cicatriz a cicatriz, la operación va tomando la forma de su propia experiencia.
Fig. 89 · Salvaguardas nacidas de cicatrices. Las cicatrices se vuelven lecciones y luego salvaguardas cuya dureza se ajusta a la gravedad.
Capítulo 90 · Parte IX
El hábito del manual de operaciones
Un manual de operaciones es un procedimiento escrito para hacer algo: desplegar un proyecto, restaurar una copia de seguridad, rotar una credencial, dar de alta a un cliente nuevo, preparar una máquina desde cero. Las organizaciones grandes tienen manuales de operaciones porque mucha gente necesita realizar las mismas tareas de forma coherente. Un operador en solitario los necesita por otro motivo: la persona que hará la tarea la próxima vez eres tú, dentro de meses, habiendo olvidado cada detalle.
El hábito es sencillo. Si has hecho algo dos veces y esperas volver a hacerlo, escríbelo. No un documento pulido, solo los pasos en orden, una comprobación tras cada paso para confirmar que funcionó y cómo deshacerlo si algo sale mal. Eso es el manual. Guárdalo en texto plano, con el proyecto o junto a tus recetas.
El disparador, hecho dos veces, es importante. Escribir un manual tras hacer algo una sola vez tiende a capturar las particularidades de esa ocasión y no el procedimiento general. Escribirlo tras la segunda vez captura lo que tenían en común ambas, que es el procedimiento. Escribirlo tras la quinta significa que te pasaste la tercera, la cuarta y la quinta reconstruyendo lo que habías olvidado. Dos veces es el punto justo.
La persona que necesitará el manual eres tú, en un mal día, sin acordarte de nada.
La comprobación tras cada paso es lo que distingue un manual de operaciones de una lista de instrucciones. Las instrucciones te dicen qué hacer. Un manual te dice además cómo saber que funcionó: tras desplegar, abre la página de estado y confirma que muestra la versión nueva. Sin comprobaciones, un manual puede seguirse a la perfección y aun así producir un resultado roto, porque un paso falló en silencio y nada te avisó.
La sección de deshacer es lo que hace seguro seguir un manual bajo presión. Si un paso falla a medio camino, necesitas saber si continuar, reintentar o volver atrás y, en ese caso, cómo. Escribirlo de antemano, con calma, es muchísimo mejor que idearlo en el momento. Para muchos procedimientos rutinarios, deshacer es trivial. Para algunos, es la parte más importante del documento.
Los manuales de operaciones y las recetas son primos hermanos, y la frontera entre ellos es borrosa. Una receta es un encargo para un agente; un manual es un procedimiento, que puedes seguir tú o un agente. Muchos operadores descubren que sus manuales se van volviendo ejecutables por agentes: los pasos son lo bastante claros como para que un agente los siga, contigo revisando las comprobaciones. Es una buena dirección, siempre que el manual siga siendo legible por un humano el día en que el agente no esté disponible.
Prueba los manuales de vez en cuando. Un manual que no se ha seguido en seis meses puede referirse a pasos que han cambiado, herramientas que se han movido o ajustes que ya no existen. El calendario de mantenimiento es un buen sitio para programar un ensayo periódico de los más importantes: desplegar, restaurar, rotar. Arregla lo que esté desfasado.
Esta semana, busca un procedimiento que hayas hecho al menos dos veces y escribe su manual: pasos, comprobaciones, deshacer. Luego síguelo una vez, exactamente como está escrito, y arregla lo que encuentres. Te sorprenderá cuántos pequeños detalles rellenaba tu memoria sin decir nada. Ahora los guarda el manual, lo que significa que tu memoria ya no tiene que hacerlo.
Fig. 90 · El hábito del manual de operaciones. Escribe el manual a la segunda vez: pasos, una comprobación tras cada uno y un deshacer.
Parte X
Decidir, no hacer
El verdadero oficio del operador, dicho sin rodeos.
Capítulo 91 · Parte X
La cola de decisiones
Todo operador tiene una lista de tareas pendientes. Menos se dan cuenta de que también tienen una lista de decisiones pendientes, y de que esa segunda lista es la que de verdad limita la operación. Las tareas pueden delegarse; los agentes recorrerán encantados una lista larga de ellas. Las decisiones, no. Cada hilo que espera tu respuesta, cada proyecto que espera a que elijas una dirección, cada revisión que espera tu veredicto es una decisión en una cola, y la longitud de esa cola es la verdadera medida de cuánto está esperándote la operación.
Hacer visible la cola de decisiones es el primer paso. Casi todos los operadores la llevan en la cabeza, lo que significa que no pueden ver lo larga que es ni priorizar dentro de ella. Escríbela. Una lista, con una línea por cada decisión pendiente: qué hay que decidir, qué está bloqueando y para cuándo hay que decidirlo. Incluye las pequeñas además de las grandes, porque las decisiones pequeñas sin tomar bloquean hilos con la misma eficacia que las grandes.
No todo lo que parece una decisión lo es. Los agentes hacen muchísimas preguntas, y muchas pueden responderse con el encargo, la memoria o una política fija. Cada vez que te descubres respondiendo dos veces la misma pregunta, es señal de que su sitio es la memoria y no la cola. Cada vez que te descubres decidiendo algo que zanjaría una política clara, escribe la política. La cola debería estrecharse desde todo lo que preguntan los agentes, pasando por las decisiones reales que te necesitan, hasta las pocas que hay que tomar hoy.
Tu lista de tareas es problema de los agentes. Tu lista de decisiones es tuya.
Trabaja la cola deliberadamente. En la revisión de la mañana, mírala y elige las decisiones que más desbloquean. Tómalas primero, en tus mejores horas. Las decisiones que bloquean varios hilos valen muchísimo más que las que bloquean uno. Las que tienen plazo van antes que las que no. Y las fáciles deberían tomarse de inmediato, porque una decisión fácil que se queda en la cola cuesta tanta atención como una difícil, cada vez que la miras.
Muchas decisiones son lentas no porque sean difíciles sino porque son incómodas: decirle que no a alguien, terminar un proyecto, admitir que una dirección era errónea. Tienden a hundirse al fondo de la cola y quedarse ahí. Fíjate en ellas. Una decisión que lleva más de una semana en la cola casi siempre es de este tipo, y la incomodidad de tomarla casi siempre es menor que el coste de dejarla. Los capítulos siguientes tienen más que decir al respecto.
Esta semana, escribe tu cola de decisiones. Cada decisión pendiente, con lo que bloquea y para cuándo es. Luego, cada mañana, toma las tres que más desbloquean. Al final de la semana, compara la longitud de la cola con la de partida. Si es más corta, la operación habrá ido más deprisa, porque lo que más esperaba era a ti.
Fig. 91 · La cola de decisiones. Las preguntas de los agentes se reducen a decisiones reales, y luego a las tres que más desbloquean.
Capítulo 92 · Parte X
Puertas de solo ida y de ida y vuelta
Las decisiones se diferencian en lo fácil que es deshacerlas. Algunas son puertas de ida y vuelta: puedes cruzarlas, echar un vistazo y volver si no te gusta. Probar una maquetación nueva, ajustar una receta, elegir en qué proyecto trabajar esta semana, escoger una herramienta para una prueba. Otras son puertas de solo ida: una vez cruzadas, no es fácil volver. Borrar datos, firmar un contrato, publicar algo para un público amplio, comprometerse con un plazo público, terminar una relación con un cliente.
La distinción importa porque los dos tipos merecen un trato muy distinto. Las puertas de ida y vuelta deberían decidirse deprisa. El coste de una mala elección es pequeño, porque puedes revertirla, y el coste de decidir despacio es real, porque la operación espera. Reunir más información o deliberar más rara vez mejora una decisión de ida y vuelta lo suficiente como para justificar el retraso. Decide, observa qué pasa, ajusta.
Las puertas de solo ida merecen más cuidado. Aquí el coste de una mala elección puede ser grande y permanente, y merece la pena deliberar un poco. Reúne las pruebas que importan. Consúltalo con la almohada si puedes. Pide a un agente que defienda la postura contraria. Busca formas de hacer la decisión más reversible, como sugería el capítulo sobre entregar y pulir: un periodo de prueba, una entrega pequeña, una copia de seguridad, un compromiso escalonado.
Casi todas las decisiones son puertas de ida y vuelta disfrazadas de solo ida. Revisa las bisagras.
Piensa en las decisiones en dos ejes: lo reversibles que son y lo que está en juego. Las decisiones reversibles y con poco en juego son aquellas en las que deberías decidir deprisa y seguir adelante. Ese cuadrante contiene casi todas las decisiones de un operador, lo que significa que casi todas las decisiones deberían ser rápidas. El fallo habitual es tratarlas como si estuvieran en el rincón de lo irreversible y lo mucho en juego, y deliberar sobre elecciones que podrían simplemente probarse y revisarse.
El fallo contrario también ocurre, sobre todo con agentes. Como los agentes facilitan tanto la acción, es posible cruzar una puerta de solo ida a la velocidad de una de ida y vuelta. Un borrado ejecutado por un agente en segundos es tan irreversible como uno hecho a mano. Un correo enviado por una receta llega igualmente a todo el mundo. La política de permisos y el nivel de preguntar antes existen en gran parte para frenar las puertas de solo ida, para que reciban la deliberación que merecen.
Un hábito útil es etiquetar las decisiones según las añades a la cola de decisiones: solo ida o ida y vuelta. La etiqueta te dice cuánto tiempo dedicarle. Las de ida y vuelta reciben un minuto y una elección. Las de solo ida reciben atención como es debido, idealmente en tus mejores horas, con pruebas y una noche de sueño cuando sea posible. Con el tiempo notarás que la etiqueta de ida y vuelta se aplica muchísimo más a menudo de lo que te sugería el instinto.
Esta semana, etiqueta cada decisión de tu cola. Toma hoy todas las de ida y vuelta, deprisa, sin agonizar. Da a las de solo ida el tiempo que necesitan. Fíjate en cuánto se acorta la cola y en lo pocas de las decisiones rápidas de las que luego te arrepientes. Las que sí lamentes, puedes revertirlas. De eso se trataba.
Fig. 92 · Puertas de solo ida y de ida y vuelta. Decisiones clasificadas por reversibilidad y riesgo; las reversibles y de poco riesgo van rápido.
Capítulo 93 · Parte X
Decir no a las buenas ideas
Los agentes son generosos con las ideas. Pide a uno que revise un proyecto y te sugerirá mejoras. Pide a uno que investigue un mercado y detectará oportunidades. Pide a uno que arregle un fallo y bien puede mencionar otras tres cosas que merecería la pena hacer ya que está. Casi todas esas ideas son buenas. Precisamente ahí está el problema. Un operador que dice que sí a cada buena idea nunca terminará nada, porque siempre llegará otra buena idea más deprisa de lo que puede completarse la anterior.
La habilidad, entonces, no está en distinguir las buenas ideas de las malas. Las malas son fáciles de rechazar. La habilidad está en decir que no, o todavía no, a las buenas, porque no encajan en las prioridades actuales, porque no hay atención para ellas esta semana o porque terminar lo que ya está empezado vale más. Es más difícil de lo que parece, porque cada buena idea llega con su propio pequeño resplandor de posibilidad, y rechazarla se siente como una pérdida.
Ayuda recordar lo que de verdad cuesta decir que sí. Cada idea nueva que se convierte en proyecto ocupa un hueco en el registro, una parte de tu atención, hilos que encargar y revisar y, con el tiempo, decisiones sobre su futuro. El coste no es el tiempo del agente, que es barato. Es el tuyo, que no lo es. Un sí a una idea nueva es un no silencioso a otra cosa, normalmente a lo que se suponía que estabas terminando.
Los agentes generan opciones. El trabajo del operador es podarlas.
Decir que no no significa perder la idea. La cola existe precisamente para esto. Escribe la idea en una línea, anota de dónde salió y deja que compita en la próxima revisión semanal o trimestral con todo lo demás. Muchas buenas ideas, tras unas semanas en la cola, resultan menos atractivas de lo que parecían. Unas pocas resultan ser aún mejores, y se empiezan en un momento que eliges tú, con la atención debida, en lugar de meterlas con calzador en una semana que ya estaba llena.
A algunos operadores les ayuda una regla sencilla: ningún proyecto nuevo empieza hasta que uno existente termine o se aparque. Uno entra, uno sale. Obliga a la comparación que exige decir que no: ¿es esta idea nueva mejor que lo más flojo que tengo ahora en marcha? Si lo es, intercámbialos. Si no, la idea nueva espera. La regla convierte una incomodidad vaga en una decisión clara.
También conviene contarles a los agentes cuánto apetito tienes de ideas. Una línea en la memoria como anota otras mejoras al final de tu informe; no las implementes mantiene el flujo de ideas sin dejar que se filtren en el trabajo. Te beneficias de las sugerencias del agente sin pagar el coste de un alcance descontrolado.
Esta semana, lleva la cuenta de las buenas ideas que te llegan, de los agentes, de tus lecturas, de tu propia cabeza. Di que sí como mucho a una. Pon las demás en la cola. Al final de la semana, lee la cola. Fíjate en qué ideas siguen pareciendo emocionantes y cuáles se han desvanecido. Las desvanecidas son la atención que te ahorraste diciendo que no.
Fig. 93 · Decir no a las buenas ideas. Una idea nueva debe ganar a lo más flojo en marcha, o espera en la cola.
Capítulo 94 · Parte X
Decidir con pruebas parciales
Los capítulos anteriores insistían en las pruebas: pruebas antes que promesas, pruebas en cada revisión, pruebas antes de cada entrega. Sigue siendo cierto. Pero hay una trampa en el otro lado, y los operadores concienzudos caen en ella a menudo: esperar a tener pruebas completas antes de decidir. Las pruebas completas rara vez llegan. Casi todas las decisiones hay que tomarlas con lo que tienes, y la habilidad está en saber cuándo lo que tienes es suficiente.
Suficiente es donde se encuentran dos cosas: las pruebas que tienes y el tiempo que tienes. Más pruebas siempre vendrían bien. Más tiempo siempre vendría bien. Pero llega un punto en que el valor de más pruebas queda superado por el coste de esperarlas, y ese punto es donde deberías decidir. Llega antes para las puertas de ida y vuelta que para las de solo ida, antes para las decisiones con poco en juego que para las de mucho, y antes de lo que la mayoría de la gente cuidadosa siente instintivamente.
Los agentes hacen más fácil caer en esta trampa, porque abaratan muchísimo reunir pruebas. Siempre puedes pedir otro análisis, otra comparación, otra ronda de investigación. Cada uno es rápido y cada uno parece responsable. Pero cada uno también retrasa la decisión, y la operación espera. En algún momento, pedir más investigación se convierte en una forma de evitar la incomodidad de comprometerse, y la investigación ya no está al servicio de la decisión. La está sustituyendo.
La pregunta no es si sabes lo suficiente para estar seguro. Es si sabes lo suficiente para actuar.
Una prueba útil es preguntarse qué pruebas te harían cambiar de opinión. Si puedes nombrarlas y se pueden conseguir en un tiempo razonable, consíguelas. Si no puedes nombrar nada que te haría cambiar de opinión, ya has decidido y solo estás aplazando el anuncio. Si las pruebas que te harían cambiar de opinión son inalcanzables, o tardarían más en conseguirse de lo que puede esperar la decisión, decide ahora con lo que tienes.
Otra prueba es imaginar que la decisión sale mal y preguntarse si más pruebas lo habrían evitado. A veces sí: una comprobación rápida de los datos habría mostrado el problema. A menudo no: el resultado dependía de cosas que eran imposibles de saber de antemano. En el segundo caso, esperar no habría ayudado, y decidir con prontitud al menos te dio más tiempo para notarlo y ajustar.
Cuando decidas con pruebas parciales, dilo, en el registro de decisiones. Se decide seguir adelante con la versión pequeña; las pruebas sobre la demanda son escasas, pero esperar otro mes costaría más. Se revisará tras las dos primeras semanas de uso. Esto deja constancia honesta de la incertidumbre y fija un momento para comprobar si la decisión aguantó. También te protege, más adelante, del falso recuerdo de que estabas más seguro de lo que estabas.
Esta semana, mira la decisión más antigua de tu cola. Pregúntate qué pruebas te harían cambiar de opinión. Si puedes conseguirlas hoy, consíguelas. Si no, decide ahora, anota la incertidumbre y fija una fecha para revisarla. Fíjate en que el mundo no se acabó. Rara vez se acaba, y la operación vuelve a moverse.
Fig. 94 · Decidir con pruebas parciales. Decide donde el valor de más pruebas cae por debajo del coste creciente de esperar.
Capítulo 95 · Parte X
El precio de no decidir
No decidir parece mantener abiertas las opciones. No es así. No decidir es en sí mismo una decisión, normalmente mala, tomada por defecto y no por elección. Cuando dejas una decisión sin tomar, el mundo no espera. Las cosas van a la deriva, las circunstancias cambian y, al final, pasa algo que zanja el asunto por ti, rara vez de la forma que habrías elegido.
El patrón es fiable. Aplazas una decisión porque es incómoda, o porque quieres más información, o porque no parece urgente. Mientras está aplazada, la operación va a la deriva a su alrededor. Los hilos que dependen de ella se atascan o avanzan sobre suposiciones. Se toman otras decisiones que dan por hecha una respuesta u otra. Pasa el tiempo y las opciones se cierran en silencio. Al final gana la inercia: el proyecto muere de abandono, el cliente elige por ti, llega el plazo y obliga a lo que tengas más a mano. La decisión se tomó. Simplemente, no la tomaste tú.
Los costes de no decidir son casi todos invisibles, y por eso es tan fácil incurrir en ellos. Nadie te manda una factura por la semana que un proyecto se atascó esperándote. Nadie te señala que tres hilos avanzaron sobre una suposición errónea porque la decisión que necesitaban no estaba ahí. Pero estos costes son reales, y en una operación unipersonal recaen por completo sobre ti.
Si no decides tú, decidirá otra cosa. Y no velará por tus intereses.
Hay también un precio emocional. Los asuntos sin decidir se quedan en la mente y generan una ansiedad de bajo nivel. Resurgen en momentos raros, en la ducha, a las tres de la mañana, en mitad de un trabajo que no tiene nada que ver. Hacen que la cola de decisiones parezca más pesada de lo que es. Muchos operadores descubren que tomar una decisión largamente aplazada, aunque sea imperfecta, trae una sensación de alivio inmediata y desproporcionada. Ese alivio es el coste que llevaban pagando sin darse cuenta.
El remedio no es decidirlo todo al instante; algunas decisiones se benefician de verdad del tiempo. Es convertir también el aplazamiento en una decisión. Cuando elijas no decidir algo ahora, anota cuándo lo decidirás y qué estás esperando. Decidir el cambio de precios el día quince, tras la primera semana de datos de uso. Eso es un aplazamiento deliberado, y está bien. Lo que no está bien es el ya lo pensaré sin fecha, que es como las decisiones derivan hacia la inercia.
La revisión semanal es un buen sitio para cazar decisiones a la deriva. Busca en la cola de decisiones todo lo que lleve más de una semana sin fecha. Cada una es o bien un aplazamiento deliberado al que le falta la fecha, o bien una decisión a la deriva. Ponle fecha a las primeras. Toma ahora las segundas.
Esta semana, busca la decisión que llevas más tiempo evitando. Tómala, hoy, con las pruebas que tengas. Anota qué decidiste y por qué. Luego fíjate en el alivio, y en los hilos que vuelven a moverse. Ese es el precio de no decidir, reembolsado.
Fig. 95 · El precio de no decidir. Aplazar sin fecha deriva en lo de por defecto; un aplazamiento con fecha sigue siendo una decisión.
Capítulo 96 · Parte X
El criterio no se delega
A medida que los agentes se vuelven más capaces, la frontera de lo que pueden hacer no deja de moverse. Tareas que el año pasado necesitaban a una persona son rutina para un agente este año. Es natural preguntarse si la frontera acabará alcanzándolo todo, y si el papel del operador se reducirá a nada. No lo hará, y merece la pena entender bien por qué, porque te dice dónde invertir en tu propio desarrollo.
Piensa en el trabajo como una pila. En la base está cómo se fabrica: la escritura, la programación, el diseño, la investigación. Esta capa es cada vez más delegable, y los agentes se ocupan de más parte de ella cada mes. Encima está si se entrega: la revisión, el listón de calidad, la decisión de entregar. Los agentes pueden informar muchísimo esta capa, ejecutando comprobaciones, comparando opciones, señalando riesgos, pero la decisión lleva tu nombre. Encima está qué significa bueno: los estándares, el gusto, la definición de terminado para este trabajo en particular, para estas personas en particular. Y en la cima está por qué importa en absoluto: qué problemas merece la pena resolver, qué proyectos merece la pena llevar, para qué es la operación.
Las capas superiores se resisten a la delegación no porque los agentes sean incapaces de opinar sobre ellas. Los agentes pueden producir opiniones perfectamente sensatas sobre casi cualquier cosa. Se resisten porque dependen de cosas que solo tienes tú: tus relaciones, tus valores, tu conocimiento de tus propias circunstancias, tu disposición a responder del resultado. Un agente puede proponer por qué importa un proyecto. No puede importarle si importa, y no se le puede pedir cuentas si se equivocó.
Los agentes pueden decirte qué es posible. Solo tú puedes decir qué merece la pena.
Esto tiene consecuencias prácticas sobre cómo gastas tu propio tiempo de aprendizaje. La capa de abajo es donde los agentes mejoran más deprisa, e invertir mucho en tus propias habilidades ahí da rendimientos decrecientes. Las capas superiores son donde tu criterio es insustituible, y recompensan la inversión: entender mejor a tus usuarios, afinar el gusto, tener más claro qué intentas conseguir, aprender a decidir más deprisa y mejor. Son las habilidades que te hacen más valioso a medida que mejoran los agentes, no menos.
También tiene consecuencias sobre cómo usas a los agentes. Delega libremente la base de la pila. Usa mucho a los agentes para informar el medio, pidiéndoles opciones, pruebas y críticas. Úsalos con moderación y cuidado en la cima, como interlocutores y no como decisores. Un operador que pregunta a un agente qué proyectos llevar y luego simplemente los lleva no ha delegado el criterio. Lo ha abandonado.
Nada de esto es un consejo de desconfianza. Los agentes son colaboradores extraordinarios en todas las capas. La cuestión es solo que colaborar y delegar son cosas distintas. Puedes colaborar en el criterio. No puedes entregarlo, porque en el momento en que lo haces dejas de ser el operador. Eres un pasajero.
Esta semana, mira las decisiones que tomaste y pregúntate, de cada una, en qué capa de la pila estaba. Fíjate en dónde te apoyaste en los agentes y dónde no. Si descubres que estás delegando las capas superiores, recupéralas. Si descubres que sigues haciendo tú la capa de abajo, suéltala. La pila se ordena sola en cuanto puedes verla.
Fig. 96 · El criterio no se delega. Cuatro capas de trabajo, de cómo se hace a por qué importa, y el papel del agente.
Capítulo 97 · Parte X
Enseña lo que diriges
Hay una vieja observación según la cual no entiendes algo de verdad hasta que puedes enseñarlo. Para un operador, esto tiene un filo práctico. Poner por escrito cómo funciona tu operación, con la claridad suficiente para que otra persona pudiera seguirlo, es una de las mejores formas de descubrir qué haces en realidad, qué crees que haces y dónde están los huecos. Enseñar lo que diriges es una forma de dirigirlo mejor.
La forma evidente es la documentación para un colaborador. Si alguna vez incorporas a alguien a tu operación, aunque sea brevemente, tendrás que explicarle cómo funciona: el ritmo, el registro, las recetas, los estándares de revisión, el proceso de entrega. Escribir esa explicación obliga a una clase de claridad que la práctica diaria no exige. Descubres hábitos que nunca habías articulado, normas que aplicabas de forma incoherente y pasos que solo tenían sentido porque conocías la historia.
Pero no necesitas un colaborador para beneficiarte. Escribir para un recién llegado imaginario funciona casi igual de bien. También escribir para los agentes, que es, en cierto sentido, lo que ya son los archivos de memoria y las recetas: documentos de enseñanza para un alumno rapidísimo y muy literal que lo olvida todo cada noche. Un operador que escribe buenos archivos de memoria ya está enseñando, y puede extender el hábito a toda la operación.
Explicar tu sistema a otra persona es la forma más rápida de averiguar qué es.
Enseñar tiene varias formas, reunidas en torno al mismo centro. Escribirlo: poner la operación en palabras, en un manual propio. Explicarlo: describirlo en voz alta a alguien, lo que revela huecos distintos de los de la escritura. Compartirlo: publicar partes, lo que invita a preguntas que nunca te habrías hecho. Y pulirlo: usar lo aprendido al escribir, explicar y compartir para mejorar la propia operación. Cada forma alimenta a las demás.
Compartir, en particular, está infravalorado por los operadores en solitario, que tienden a pensar que sus métodos son demasiado personales para interesar a nadie. Normalmente se equivocan. Otras personas que llevan operaciones parecidas se enfrentan a problemas parecidos y suelen alegrarse de ver cómo los resolvió otro. Y el acto de preparar algo para que lo lean otros eleva tu propio listón: no publicarás una descripción de tu proceso de entrega sin asegurarte antes de que es un proceso de entrega del que estarías orgulloso.
Hay un beneficio más para un operador en solitario. Un relato escrito de cómo funciona tu operación es un seguro. Si estás enfermo, de vacaciones o simplemente fuera una temporada, el relato te permite a ti, o a quien te ayude, retomar los hilos. Es el manual de operaciones de la propia operación, al nivel más alto, y como cualquier manual solo sirve si se escribió antes de necesitarlo.
Esta semana, escribe una página que explique cómo funciona tu jornada operativa, para un recién llegado imaginario: la revisión, las sesiones, el cierre, el registro, tu forma de encargar y revisar. Sé concreto. Luego reléela y marca todo lo que te sorprendió, lo que contradice lo que haces en realidad o lo que te costó explicar. Esas marcas son tus próximas mejoras. Te propusiste enseñar y acabaste aprendiendo, que es como suele ir.
Fig. 97 · Enseña lo que diriges. Escribir, explicar y compartir tu operación retroalimenta su refinamiento.
Capítulo 98 · Parte X
El operador que viene
¿Hacia dónde va este oficio? Cualquier respuesta honesta empieza por la incertidumbre. Las herramientas cambian deprisa, las capacidades de los agentes se amplían de formas difíciles de prever, y cualquiera que asegure saber exactamente cómo será el día de un operador en solitario dentro de unos años está adivinando con aplomo. Pero la dirección es visible, y la dirección sugiere que el núcleo de este libro importará más, no menos.
La tendencia hasta ahora es hacia correas más largas. Los agentes trabajan más tiempo sin consultar, asumen trabajos más grandes, se coordinan entre sí, funcionan en segundo plano y de forma programada, y se ocupan de una parte mayor de los juicios rutinarios que antes requerían a una persona. Cada paso aleja más al operador del hacer y lo acerca a los bordes del trabajo: fijar la intención al principio y ejercer el juicio al final.
Esa forma es el protocolo que hay en el corazón del oficio de operador, y ya es visible hoy. El operador enuncia la intención: qué se quiere y por qué, con una definición de terminado. Los agentes devuelven trabajo y prueba: el resultado y la evidencia de que cumple la intención. Y el operador ejerce el juicio: si esto es bueno, si se entrega, qué viene después. A medida que los agentes mejoren, el centro de ese intercambio se hará más largo y más capaz. El principio y el final se quedan con el operador, y se convierten en una parte mayor de lo que hace.
Cuanto más hacen los agentes, menos hace el operador, y más importa lo que hace.
¿Qué significa esto para las habilidades que merece la pena cultivar? Intención clara: la capacidad de decir con precisión lo que quieres, que es el encargo, la definición de terminado, las restricciones. Juicio sólido: la capacidad de evaluar el trabajo y decidir qué hacer con él, que es la revisión, el gusto, la decisión de entregar. Y buen ritmo: la capacidad de estructurar tu propio tiempo y tu atención para que la intención y el juicio se ejerzan en su mejor momento, que es la jornada operativa, la revisión semanal, el presupuesto de energía. Cada parte de este libro trata de una de esas tres.
También significa que el oficio del operador se vuelve, en cierto modo, más humano. Cuando el hacer se delega, lo que queda es la parte que depende de ser una persona concreta con relaciones, valores y responsabilidades concretos. Entender lo que de verdad necesita un cliente. Decidir qué merece la pena construir. Responder del resultado. No son habilidades técnicas, y no se quedan obsoletas cuando mejora la tecnología. Se convierten en el oficio.
Habrá herramientas nuevas, prácticas nuevas y nombres nuevos para las cosas, y algunos detalles de este libro envejecerán. Trata los detalles como ejemplos y los principios como la sustancia. Los principios, encargos claros, pruebas antes que promesas, entregas pequeñas, registros honestos, ritmo sostenible, responder de los resultados, son más antiguos que los agentes y sobrevivirán a cualquier versión concreta de ellos.
Esta semana, pregúntate cuál de las tres, intención, juicio o ritmo, es la más débil en ti. Elige una práctica de este libro que la refuerce y adóptala durante un mes. El futuro del oficio recompensará al operador que mejoró en los bordes mientras se automatizaba el centro. Empieza ya. El centro ya se está moviendo.
Fig. 98 · El operador que viene. Sale la intención, vuelven trabajo y pruebas; el medio crece, los extremos siguen siendo tuyos.
Capítulo 99 · Parte X
El manual como hábito
Un manual no está pensado para leerse una vez. Está pensado para usarse: abrirse cuando surge un problema concreto, consultarse cuando un hábito se ha relajado, releerse cuando algo no funciona y no acabas de saber por qué. Este no es una excepción. Sus cien capítulos no son un curso que completar sino un conjunto de prácticas que adoptar, unas pocas cada vez, y a las que volver a medida que cambia tu operación.
El ciclo que convierte un manual en un hábito tiene tres pasos. Lee un capítulo, o una parte, cuando venga al caso. Practica lo que sugiere durante una semana o dos, deliberadamente, en tu trabajo real. Luego revisa: decide si la práctica te funciona tal como está escrita, si necesita adaptarse o si deberías abandonarla. Luego vuelve a leer cuando llegue el siguiente problema. Practicar es el paso que importa. Leer sin practicar es entretenimiento. Practicar sin revisar es rigidez. El ciclo necesita los tres.
No intentes adoptarlo todo a la vez. Un operador que empieza la revisión de la mañana, el cierre, el registro, el registro de decisiones, las notas de entrega, las notas de incidente y la revisión semanal en la misma semana no conservará ninguna. Elige una o dos prácticas, las que atacan tu mayor problema actual, y dales un mes. Cuando se hayan vuelto automáticas, añade otra. Los hábitos se acumulan como el interés compuesto, pero solo si sobreviven lo suficiente para convertirse en hábitos.
Léelo una vez por las ideas. Luego úsalo por la práctica.
Adapta con libertad. Este libro describe prácticas que funcionan para muchos operadores, pero tu operación es tuya. Quizá tu revisión funcione mejor a la hora de comer. Quizá tu registro funcione mejor como tabla. Quizá los tres de hoy deberían ser los dos de hoy. Los principios importan más que los detalles: decide a propósito, encarga con claridad, revisa con pruebas, entrega en pequeño, pon las cosas por escrito, descansa. Cómo los implementes te toca a ti averiguarlo, y el paso de revisar es donde lo haces.
Lleva tu propio manual junto a este. A medida que adaptes las prácticas, escribe tus versiones: tu lista de la revisión de la mañana, tu plantilla de encargo, tu formato de nota de entrega, tu calendario de mantenimiento. Con el tiempo, tu propio manual te será más útil que este, porque encajará exactamente con tu operación. Ese es el objetivo. Este libro es un punto de partida, y un buen punto de partida es uno que acabas dejando atrás.
Vuelve a él en la revisión trimestral. Hojea las partes. Pregúntate qué prácticas has adoptado, cuáles has dejado relajarse y cuáles no has probado nunca. Elige una o dos en las que trabajar el próximo trimestre. Esto mantiene el ciclo en marcha en la escala de tiempo más larga, y significa que cada trimestre tu operación es un poco más deliberada que el anterior.
Esta semana, elige el único capítulo de este libro que ataca tu mayor problema actual. Practícalo durante dos semanas. Luego revisa: conservar, adaptar o abandonar. Luego elige el siguiente. Dentro de un año habrás construido un sistema operativo hecho a tu medida. Y muy probablemente habrás dejado de necesitar leer sobre él, que es lo mejor que puede esperar un manual.
Fig. 99 · El manual como hábito. Leer, practicar y revisar en bucle, una o dos prácticas a la vez.
Capítulo 100 · Parte X
El oficio es decidir
Esta es la tesis del libro, dicha sin rodeos: el verdadero trabajo del operador es decidir, no hacer. Los agentes hacen, cada mes más, más deprisa y con más capacidad de lo que podría cualquier persona sola. Lo que no pueden hacer es decidir qué merece la pena hacer, qué aspecto tiene lo bueno, si el resultado es lo bastante bueno como para llevar tu nombre y qué debería pasar después. Esas decisiones son el oficio. Todo lo demás en este libro es maquinaria para tomarlas bien.
Delega el hacer, porque el hacer ya es delegable. Redactar, construir, investigar, probar, resumir, ordenar: entrégalo con un encargo claro, permisos sensatos y una definición de terminado. Aferrarse a ello por costumbre o por orgullo no es diligencia. Es gastar tu recurso más escaso, la atención, en el más abundante, el esfuerzo.
Revisa el trabajo, porque la revisión es donde tu juicio entra en él. Lee el diff, comprueba las pruebas, aplica primero las comprobaciones más baratas y las más profundas donde el riesgo lo exija. Pregúntate si la forma es correcta antes de pulir el detalle. Pregúntate si no es meramente correcto, sino tuyo. Revisar no es una actividad menor que fabricar. Es la actividad que hace fiable lo fabricado.
Y asume la decisión, porque responder de ella es lo que hace funcionar todo el engranaje. Entrégalo o devuélvelo. Empieza el proyecto o di que no. Apárcalo o termínalo. Decide con las pruebas que tengas, deprisa donde la puerta gira en los dos sentidos y con cuidado donde no. Anota por qué. Luego vive con el resultado, aprende de él si sale mal y vuelve a decidir. Eso es un operador.
Los agentes ponen el esfuerzo. Tú pones las decisiones. Ese es todo el oficio.
El resto del libro está al servicio de eso. La jornada operativa existe para dar a la decisión sus mejores horas. Los encargos existen para llevar las decisiones al trabajo. La memoria existe para que las decisiones no tengan que tomarse dos veces. El registro y la cola de decisiones existen para que puedas ver qué hay que decidir. La disciplina de entregas existe para que cada decisión de entregar sea pequeña y reversible. Las revisiones semanales y trimestrales existen para que decidas el rumbo en lugar de ir a la deriva hacia él. El descanso existe para que quien decide esté en condiciones de decidir. Hasta las notas de incidente tratan de decidir: decidir qué cambiar para que el error no se repita.
Es una buena noticia, aunque al principio quizá no lo parezca. Decidir es más difícil que hacer en algunos aspectos, menos tangible y menos inmediatamente satisfactorio. Pero también es más interesante, más humano y más duradero. El hacer seguirá automatizándose. El decidir seguirá necesitando a alguien. Si se te da bien, valdrás más cada año, no menos.
Así que mañana por la mañana, antes que nada, abre una página en blanco y escribe las tres decisiones que más harían avanzar tu operación. Luego tómalas. No las tareas: las decisiones. Deja que los agentes se ocupen del resto. Descubrirás, como tantos operadores, que el trabajo se vuelve más fácil y el oficio más interesante. No es una contradicción. Es el oficio, visto por fin con claridad. Siempre fue decidir. Los agentes simplemente se llevaron todo lo que lo tapaba.
Fig. 100 · El oficio es decidir. Delegar, revisar, asumir: cada parte de la operación existe para servir a la decisión.
El manual del operador · Primera edición, octubre de 2026