Más contexto no es mejor contexto

Le di a un agente acceso completo al repositorio para que arreglara una función de tres líneas.

Leyó veinte archivos y me devolvió una solución impecable, ordenada, bien explicada, que respetaba al pie de la letra una convención que habíamos abandonado meses antes, en un archivo que ya nadie tocaba y que nadie se había acordado de borrar.

No falló por falta de información. Falló porque le di demasiada.

”Si se equivocó, es que le faltó contexto”

Esa es la intuición, y es la misma que aplicamos con las personas nuevas: si no entendió, le mando otro documento, le comparto otra carpeta, lo agrego a otro canal.

Con agentes es medible, y el resultado es incómodo: cuanto más metes en la ventana, más compite cada instrucción con todas las demás, y un archivo obsoleto que sigue en el repositorio no se ve obsoleto desde adentro, se ve como una fuente más, con exactamente el mismo peso que la buena.

El contexto no funciona como un almacén, funciona como un presupuesto, y todo lo que entra desplaza algo.

Estas son las cuatro reglas que escribí para administrarlo. Están en producción en mi sistema y cada una nació de un fallo concreto.

1. Carga por dominio, no por si acaso

Mi sistema tiene ocho consejos de decisión: estrategia, negociación, liderazgo, marketing, arquitectura, inversión, relaciones y startup. La regla dice que ante una solicitud se clasifica el dominio y se carga solo el consejo que corresponde.

Suena a optimización de costo y no lo es.

El fallo que previene: cargados los ocho, una pregunta de arquitectura recibe una respuesta contaminada por marcos de negociación. No es que el agente mienta, es que responde con lo que tiene a mano, y le pusiste a mano cosas que nadie pidió.

La versión humana la conoces: la reunión donde invitaste a todos por si acaso, y ahora opina todo el mundo sobre algo que entienden dos personas.

2. Una fuente canónica por dato

Los números financieros viven en un solo archivo y ningún otro documento los repite, los enlaza.

Cuesta disciplina, porque duplicar un dato siempre es más cómodo que ir a buscarlo.

El fallo que previene: el mismo número en dos lugares con dos valores distintos. El agente no tiene forma de saber cuál está vigente, así que elige uno, normalmente el que leyó último, y construye todo el razonamiento encima sin avisarte.

Un dato duplicado no es redundancia, es una bomba de tiempo con dos respuestas correctas.

3. Marca el estado de lo que sabes

Cada afirmación relevante lleva una etiqueta: HECHO, INFERENCIA, SUPUESTO o EVIDENCIA PENDIENTE.

Cuatro palabras. Es la regla más barata de todas y la que más me ha ahorrado.

El fallo que previene: que una suposición de hace tres semanas se lea hoy como un hecho establecido. El texto plano no distingue entre lo que comprobaste y lo que asumiste un martes con prisa, así que sin las etiquetas tu sistema acumula certezas que nunca verificó y el agente las hereda todas con la misma confianza.

4. Una sola cosa mutable, y que se sepa cuál

En mis documentos operativos hay exactamente una sección que se reescribe, la de pendientes abiertos. Todo lo demás se agrega y nunca se edita, y la historia vive en un archivo aparte donde solo se añade al final.

El fallo que previene: dos, en realidad. Que el estado actual haya que reconstruirlo leyendo diez entradas viejas en orden, y que corregir el estado actual reescriba en silencio lo que creías la semana pasada, que es justo la información que necesitas para saber si estás mejorando o solo cambiando de opinión.

Separar lo que cambia de lo que se acumula es probablemente la decisión de diseño que más rinde en un sistema con agentes.

Lo que en realidad estaba resolviendo

Escribí estas reglas para agentes. Después noté que llevaba años necesitándolas para personas.

El onboarding que entrega cuarenta documentos el primer día no está transfiriendo conocimiento, está transfiriendo el problema: la persona nueva tiene que averiguar cuál de esos cuarenta sigue vigente y no tiene ninguna forma de saberlo, igual que el agente.

La diferencia es que la persona nueva no te lo va a decir. Va a asumir que el problema es suyo.

Con el agente el fallo aparece en cuatro minutos, es reproducible y te obliga a escribir la regla. Esa es la parte que no esperaba de trabajar con ellos: te hacen explícito lo que en un equipo humano puedes dejar ambiguo durante años sin que nadie proteste.

El contexto nunca fue el recurso abundante. Lo que pasaba es que con personas nadie te manda el error.