"No basta con resolver, la solución tiene que encajar"
Imagina que estamos vendiendo muebles.
Para hacer una silla:
- alguien hace el asiento
- otro el respaldo
- tú y yo hacemos dos patas cada uno
Cuando vamos a ensamblar la silla, todo encaja perfectamente y funciona. Pero mis patas son de aluminio, mientras que el resto de la silla es de fina madera; la silla no se tambalea ni queda dispareja, funciona perfectamente, pero algo no cuadra. Quizá podríamos dejarlo pasar.
Pero si hacemos 10 sillas más y 3 mesas, eso deja de ser un detalle.
Hace poco recordé algo que me habían dicho cuando empezaba mis primeros proyectos colaborativos:
Puedes resolver un problema y aun así no solucionarlo.
No me malentiendas, yo soy fiel creyente de: "Primero hazlo funcionar, luego hazlo bonito". Si necesitas una silla urgentemente, cualquier solución es buena, pero si tienes una tienda de muebles, todos debemos encajar.
Todos podemos resolver tickets y generar código, pero eso no significa que estés aportando bien al proyecto.
Te dejo algunos tips para cuando realices tus aportaciones; esto te va a ahorrar muchos problemas (y a tu equipo también):
a) Revisa la documentación del proyecto
Antes de escribir código, entiende:
- qué arquitectura usan
- qué librerías
- qué patrones
- qué ve el usuario
Te toma minutos…
y te ahorra días de correcciones.
b) El código generado por IA no es malo, lo malo es no saber pedirlo
- En un mundo con código generado por IA, podemos crear cualquier función necesaria.
- El problema viene con la falta de contexto.
- Tu agente necesita saber cómo debe conectarse al resto del proyecto.
c) Utiliza herramientas como MCP (Model Context Protocol) para darle contexto a los agentes
No es solo generar código, es generar código que:
- respete el proyecto
- siga sus reglas
- y encaje con lo que ya existe
Si tienes más experiencia, quizá me puedes decir que es algo obvio o que en la práctica cada quien lo soluciona como le gusta o como puede. Pero al final, todos buscamos lo mismo:
Que el sistema funcione,
que la gente lo use,
y que no se rompa un viernes por la tarde.
Pero también siempre será una buena idea mantener buenas prácticas de programación y arquitectura de software. No queremos sillas con tres tipos de patas, cada una con diferentes necesidades de mantenimiento.
En un mundo donde el vibe coding ya es parte del día a día, no se trata de evitarlo.
Se trata de usarlo bien.
Pero ese es tema para otro día.