El conocimiento de tu software vive en tres cabezas. Un asistente de IA te obliga a sacarlo

01Lo esencial

• Un cambio de código correcto no basta: tiene que seguir los patrones que tu equipo ya usa.
• Un asistente de programación se adapta por cuatro vías: instrucciones, habilidades, agentes especializados y conexiones a otros sistemas.
• Escribir las reglas es gobierno del conocimiento, y sirve igual para personas, proveedores y asistentes.

Pídele a un asistente de IA que agregue un tamaño de página personalizado a una aplicación. El cambio funciona. Y aun así puede estar mal: ignoró cómo se nombran las cosas, cómo se prueban y dónde se coloca cada componente.

Ese es el caso que usa una guía reciente para explicar algo que cualquier director de tecnología reconoce: el código que compila no es el código que se parece al tuyo. La diferencia está en reglas que casi nunca se escribieron.

02El costo de repetirte

Todo proyecto de software tiene reglas de la casa: estructura de componentes, scripts que se corren, convenciones por tipo de archivo. Si viven en la memoria de dos o tres personas, cada tarea nueva arranca con la misma explicación. Con un asistente pasa igual, solo que más rápido y más veces al día.

03Primera vía: instrucciones en el repositorio

Un archivo de instrucciones guardado junto al código fija lo que debe influir en cualquier tarea: arquitectura preferida, nombres, expectativas de pruebas y validación. También puedes crear archivos que solo apliquen a ciertas rutas, de modo que el frontend y el backend no compartan el mismo reglamento.

04Segunda y tercera: habilidades y agentes especializados

Algunas guías no son estándares, son procedimientos que se repiten. Para eso existen las habilidades: paquetes de pasos que el asistente usa cuando la tarea lo pide. Los agentes personalizados van un nivel arriba y aportan criterio especializado en trabajos grandes, como una revisión de seguridad o una migración.

05Cuarta: conexiones al resto de tus sistemas

Los servidores de conexión permiten que el asistente consulte una base de datos, un sistema de tickets o la documentación interna. Aquí el tema deja de ser productividad de desarrollo y entra al terreno de la integración: qué puede ver, qué puede tocar y con qué permisos.

06Lo que esto cambia para la dirección

Escribir reglas se ve como tarea de desarrolladores. Es una decisión de gobierno. Cuando el conocimiento está documentado, cambiar de proveedor, de equipo o de herramienta cuesta menos tiempo y menos riesgo. Cuando no, cada relevo se lleva una parte del sistema.

Es el mismo principio con el que se ordena una marca a escala: lo que no está escrito no se puede replicar, auditar ni delegar.

07Cómo empezar sin frenar al equipo

No hace falta un proyecto de gestión del conocimiento. Hace falta un orden de operación, corto y mantenido. Cinco decisiones bastan para arrancar:

• Reglas de estructura: dónde va cada tipo de componente y cómo se nombra.
• Pruebas y validación: qué debe pasar antes de aceptar un cambio.
• Prohibiciones: lo que nunca se toca sin autorización explícita.
• Procedimientos repetibles: lanzar versión, migrar datos, revisar seguridad.
• Responsable: una persona que mantiene el archivo vivo cada trimestre.

El orden importa. Primero las reglas, después los procedimientos y al final las conexiones. Un asistente conectado a la base de datos sin reglas escritas es el escenario más caro de los tres.

Un asistente sin reglas te entrega código que funciona. Con tus reglas te entrega código que parece escrito por tu equipo.

08Errores que conviene evitar

• Explicar lo mismo en cada tarea en lugar de dejarlo escrito una vez.
• Dejar las reglas solo en la cabeza de quien más sabe del proyecto.
• Escribir instrucciones tan largas que nadie las actualiza.
• Conectar el asistente a sistemas internos sin acotar permisos.
• Aceptar cambios generados sin pasar por revisión.

09Y en México

si tu desarrollo lo llevan proveedores externos o equipos en distintas ciudades, pide que las reglas del proyecto queden en el repositorio como entregable, no como favor. Así, si cambias de proveedor o de herramienta, el siguiente equipo, humano o asistente, arranca con el mismo contexto y no desde cero.

10Checklist para aplicarlo

• Anota las cinco reglas que más repites al pedirle algo a una IA.
• Guárdalas en el repositorio, no en un documento aparte.
• Convierte una tarea repetida en un procedimiento escrito.
• Pide al asistente que indique qué regla aplicó en cada cambio.

11Para aplicar hoy

Reúne a tu equipo técnico quince minutos y pide que escriban en una página las reglas que más repiten. Esa página es el primer insumo de cualquier asistente que conectes después.