Recursos
Resumen
El principio de una sola responsabilidad es la clave para escribir funciones limpias y escalables, incluso cuando trabajas con inteligencia artificial. Si programas con asistentes de IA y quieres que tu código crezca sin volverse un caos, esto te interesa.
Todo parte de una idea simple y poderosa: divide y vencerás. Cuando tienes una tarea enorme, como construir un e-commerce, no la atacas de golpe. La partes en pedazos manejables: diseñar la base de datos, definir las políticas de cupones, calcular subtotales, renderizar páginas. Esa subdivisión no solo te ayuda a resolver mejor, también eleva tu sensación de progreso y tu productividad.
Qué es el principio de una sola responsabilidad en programación
En el desarrollo de software existe un patrón que lleva esa lógica al detalle: cada función debería tener una sola responsabilidad. Ni más, ni menos.
¿Cómo sabes si una función se está pasando de responsabilidades? Hay un truco muy sencillo. Describe en voz alta lo que hace. Si al leerla aparecen las palabras además y también, tienes un problema [01:20].
¿Qué es el principio de una sola responsabilidad? Es una buena práctica donde cada función hace una sola cosa. Si describes la función y dices "calcula el total y además renderiza y también valida", tiene demasiadas responsabilidades y debes dividirla.
Por ejemplo, una función que además de calcular muestra el render de las páginas, también calcula el subtotal y también aplica el descuento, es una función sobrecargada. Ese es exactamente el tipo de código que conviene dividir en funciones más pequeñas.
Por qué el código generado por IA tiende a romper este patrón
El código vibecodeado suele entregar funciones gigantes, sin este principio aplicado [03:20]. Nacen bloques que leen datos, calculan totales, vuelven a calcular lo que ya existía en otra función (repitiendo código) y encima renderizan, todo en el mismo lugar.
Y aquí viene lo interesante: este desorden no solo te afecta a ti como humano.
Por qué sigue importando leer código sano en la era de la IA
Podrías pensar que ya no necesitas preocuparte por esto. Al final, leer código es un problema que la IA resuelve, y como humanos cada vez leemos menos y pedimos más modificaciones a un agente [05:20].
Pero el patrón sigue siendo crítico, sobre todo para la propia inteligencia artificial.
Cuando un agente lee tu código actual y detecta malas prácticas, simplemente las replica. Aprende del repositorio existente y concluye algo peligroso: aquí está permitido el código espagueti, aquí están permitidas las funciones gigantes.
Eso tiene consecuencias concretas a medida que escalas:
- El proyecto deja de escalar bien con el tiempo.
- Debuguear un error se vuelve muy difícil por el código replicado.
- Las funciones con responsabilidades enormes complican cada cambio.
¿La IA escribe mejor código si el proyecto está bien estructurado? Sí. Si tus funciones cumplen una sola responsabilidad, el agente puede debuguear, resolver problemas y escalar tu producto de forma mucho más efectiva sin descontrolarse.
Cómo refactorizar una función con muchas responsabilidades usando un prompt
La estrategia para arreglarlo es directa y la puedes replicar hoy mismo. En lugar de pedirle a la IA que reescriba de inmediato, primero le pides un plan.
El prompt que funciona tiene esta estructura:
- Declara el problema: "Esta función tiene muchas responsabilidades".
- Pega el bloque de código completo.
- Pide el plan: "Sin modificar, dame un plan para partirlo en funciones más pequeñas con una sola responsabilidad" [04:00].
Al ejecutarlo, la IA describe los pasos lógicos antes de tocar nada. En el ejemplo de finalizar una compra, propuso esta secuencia: leer el DOM, validar, sumar, calcular, construir el HTML y luego escribir el DOM [04:30].
Cada paso se convierte en una función candidata con su propia responsabilidad clara.
Cómo queda el código después de aplicar la refactorización
Una vez apruebas el plan con un "estoy de acuerdo, aplica esa solución", el resultado transforma por completo el archivo pagina.js.
La función principal finalizarCompra dejó de hacer todo. Ahora solo orquesta: según el tamaño del carrito muestra o no el resumen, lee los datos, calcula los totales y muestra el resumen [06:30].
javascript function finalizarCompra() { if (carritoVacio()) { renderVacio(); return; } const datos = leerDatos(); const totales = calcularTotales(datos); renderResumenPedido(totales); }
Y cada función pequeña cumple exactamente un propósito:
leerDatosanaliza los datos del DOM y los devuelve.calcularTotalescalcula el descuento, el envío y entrega todo listo.renderResumenPedidosolo muestra el resumen del pedido, nada más.
Fíjate en algo importante: algunas funciones no tienen un return, y eso es totalmente normal. Su responsabilidad es llamar a otras funciones en orden para resolver el problema [04:50].
Ahora sí puedes señalar la responsabilidad de cada una sin dudar. La de renderResumenPedido es mostrar el resumen del pedido. Punto. No le puedes agregar un "y además calcula los totales", porque violaría el principio.
Este módulo de funciones te mostró cómo abstraer bloques de código reutilizables, cuándo hacer un return y cuándo no, y cuándo dividir para mantener tu proyecto sano. ¿Ya identificaste alguna función en tu proyecto que use demasiados "además" y "también"? Cuéntame cómo la dividirías.