Construyendo Software para la Era Agéntica: Por Qué la Arquitectura Nunca fue Tan Importante

El panorama del desarrollo de software está cambiando frente a nuestros ojos. Hace apenas un año, la idea de una arquitectura "amigable para agentes" apenas aparecía en el radar de la mayoría de desarrolladores. ¿Hoy? Se está convirtiendo en conocimiento esencial.

A medida que los asistentes de IA para programación pasan de ser una novedad a una necesidad, estamos comprendiendo algo crucial: estos agentes son tan efectivos como el código base con el que trabajan. Dale a una IA un desastre entrelazado de servicios dispersos, dependencias circulares y convenciones de nomenclatura crípticas, y pasarás la mitad de tu día retrocediendo y aclarando instrucciones. Pero dale a una IA —o a un humano, para el caso— un código base bien organizado donde el contexto fluye naturalmente. Ahí es donde ocurre la magia.

Y es precisamente aquí donde entra una arquitectura que ha estado ganando terreno silenciosamente: Polylith. Y sinceramente, es uno de esos conceptos que parecen obvios una vez que los entiendes.

¿Qué es Polylith, Exactamente?

La versión rápida: Polylith se trata de obtener los beneficios de los microservicios con la simplicidad de un monorepo. Tienes la modularidad y el aislamiento de los microservicios, pero todo vive en un único repositorio ordenado.

La idea central es que tu código se compone de bloques de construcción —como piezas de LEGO. Algunos son pequeños y enfocados, otros son agregados más grandes, pero todos están diseñados para encajar limpiamente. En la terminología de Polylith, estos bloques se llaman bricks, y hay dos tipos:

• Components: La carne de tu aplicación. Aquí vive la lógica de negocio, las features, la funcionalidad real.
• Bases: Los puntos de entrada para tus apps y servicios. Idealmente deberían ser delgadas —delegando a los components en lugar de contener lógica ellas mismas.

Esta separación importa porque te obliga a pensar en los límites desde temprano. Una base no necesita conocer los detalles internos de un component; solo sabe cómo invocarlo. Limpio, predecible, y —lo más importante— fácil de navegar tanto para humanos como para agentes de IA.

Por Qué los Agentes se Preocupan por la Arquitectura

Aquí es donde las cosas se ponen interesantes desde la perspectiva del desarrollo con IA.

Las arquitecturas tradicionales de microservicios, aunque poderosas, introducen una complejidad que puede dejar varados incluso a los agentes más inteligentes:

• Código disperso entre múltiples repositorios
• Lógica duplicada en diferentes servicios
• Código compartido extraído en librerías (generando aún más repositorios)
• Incompatibilidades de versiones entre dependencias

Un agente que intenta entender o modificar un sistema así debe saltar entre repositorios, rastrear dónde vive la funcionalidad y desenredar dependencias —todo antes de escribir una sola línea de código útil. Eso es sobrecarga cognitiva que nobody wants.

Polylith resuelve esto manteniendo todo en un solo lugar. El contexto siempre está a tu alcance. Los agentes no necesitan navegar por un laberinto de repositorios interconectados; la imagen completa está disponible en un único workspace. Esto no solo es conveniente para los agentes —es transformador para su efectividad.

El Ángulo de las Herramientas

Lo que hace a Polylith particularmente atractivo es su ecosistema de tooling. Herramientas bien diseñadas hacen cumplir las reglas de la arquitectura de forma automática. Te avisan cuando se cruzan límites, detectan dependencias circulares, y en general mantienen tu código base honesto.

Para desarrolladores de Python específicamente, existe tooling que se integra con tus package managers favoritos —uv, poetry, pdm, pixi, el que sea que estés usando. Incluso hay soporte incorporado para agent skills, enseñando esencialmente a los asistentes de IA cómo trabajar dentro del framework de Polylith.

Esto es una victoria real para la eficiencia en prompts también. Cuando un agente de IA entiende las convenciones de la arquitectura a través del tooling, gastas menos tokens explicando contexto y más tokens generando valor.

Lo Que No Cambia

Aquí está la parte reconfortante: muchos principios de buena arquitectura de software permanecen constantes sin importar si un humano o una IA está leyendo el código.

Simple es mejor que complejo. Límites claros superan dependencias enredadas. El contexto importa. Estas verdades se sostenían antes de la era agéntica, y se sostendrán después. La diferencia ahora es que estamos más motivados a practicarlos porque los beneficios se extienden a nuestros asistentes de IA.

El Panorama Completo

Estamos entrando en una era donde el desarrollo ocurre en colaboración con IA. Eso cambia la ecuación para las decisiones de arquitectura. Ya no se trata solo de la experiencia del desarrollador —también se trata de la experiencia del agente.

Polylith no es la única respuesta a este desafío, pero es una interesante que aborda ambos lados con elegancia. Al priorizar la simplicidad y el contexto, crea un código base que es un placer navegar para humanos y, cada vez más, para agentes trabajar dentro de él.

Si estás iniciando nuevos proyectos o considerando reestructurar los existentes, vale la pena tener esta conversación en mente. Las herramientas que elegimos usar —y las decisiones de arquitectura que tomamos— van a moldear qué tan efectivamente nuestros asistentes de IA pueden ayudarnos a construir.

La era agéntica no está llegando; ya está aquí. La pregunta es si nuestras arquitecturas están listas para enfrentarla.

¿Qué patrones de arquitectura has encontrado que funcionan bien con asistentes de IA para código? Comparte tus pensamientos abajo —siempre curioso por saber cómo otros están navegando este cambio.