Idea principal

Un marco puesto alrededor de una producción de software se lee espontáneamente como una restricción: reglas, límites, cosas que no se pueden hacer. Sobre un asistente, esa lectura es falsa en la mayoría de los casos.

Dejado solo ante una base de código que no conoce, un asistente busca. Toma una API interna que no es la correcta, entra por un punto de entrada obsoleto, reconstruye un componente que ya existía, esquiva la arquitectura existente porque no la ha visto. Esos rodeos consumen tiempo, producen código para tirar y fabrican incoherencia — no porque el asistente sea malo, sino porque la información que le habría evitado el rodeo no estaba disponible en ninguna parte.

Un catálogo de API internas utilizables, una documentación funcional generada a partir del código, una correspondencia entre conceptos de negocio y puntos de entrada técnicos, ejemplos de consultas, componentes de interfaz reutilizables, convenciones, archivos de instrucciones y skills: cada uno de estos objetos elimina una búsqueda. El marco no reduce el espacio de soluciones, elimina el coste de entrar en él.

Por qué es importante

Esto invierte el argumento económico con el que se discute una inversión de plataforma. Mientras los raíles se presenten como una protección, se negocian contra el plazo y pierden. Presentados como la condición de velocidad de todo lo que se producirá después, cambian de categoría de gasto.

También dice qué distingue, para un asistente, una base de código acogedora de una base de código cerrada: no su belleza, sino la cantidad de información que pone a disposición sin que haya que adivinarla.

Matices y límites

El efecto supone que el marco esté al día. Un catálogo de API caducado es peor que no tener catálogo: orienta con aplomo hacia el camino equivocado, y nada en la salida señala el error.

Y el marco tiene un coste de fabricación y de mantenimiento, que solo se rentabiliza sobre una producción repetida. No se justifica para un objeto único.

Preguntas abiertas

• De entre esos raíles, ¿cuáles deben escribirse para humanos y cuáles para un asistente, cuando un mismo archivo no puede servir correctamente a ambas lecturas?