Mientras el asistente trabaja, el chat muestra tarjetas de actividad: lo que hizo, en una línea. Durante un tiempo, esas líneas se llenaron de cosas que el usuario no pidió leer: parámetros, rutas, identificadores y bloques de JSON. El síntoma siempre aparecía por casos («with for», «current», una ruta temporal), y arreglar caso por caso era una trampa: la siguiente herramienta nueva volvía a abrir la puerta.
La regla
La decisión fue de producto, no de formato: el usuario nunca lee el interior del sistema. Ninguna tarjeta puede contener nada que haya que parsear. La narración es humana y en un solo idioma, venga de donde venga la herramienta: backend, terminal, código, web, navegador, memoria, sesiones, habilidades, complementos, lienzos, archivos o tareas.
El método
- Tabla curada. Las 36 herramientas del catálogo recibieron su frase humana: «Mostró un lienzo», «Consultó la web: <consulta>», «Guardó un archivo: <nombre>», «Consultó la sesión actual».
- Purga de adornos. Fuera los «with …», los parámetros colgantes y los JSON en burbujas, también en los desplegables, no solo en la línea colapsada.
- Desenlaces con nombre. Una tarea que falla dice «Error» o «Interrumpido», nunca un volcado crudo.
- Pruebas de barrido. Dos suites recorren el catálogo completo y fallan si cualquier herramienta nueva devuelve texto crudo. La puerta quedó cerrada de raíz.
| Antes de la tabla | Ahora |
|---|---|
web_search with for "clima cdmx" (top 5) |
Consultó la web: clima cdmx |
session current |
Consultó la sesión actual |
write /tmp/Make_report.py |
Guardó un archivo: Make_report.py |
| JSON del navegador en el desplegable | Abrió una página: dominio |
Por qué importa
Porque la confianza se construye en lo pequeño. Si el chat te obliga a interpretar jerga para saber qué está pasando, dejas de creerle. Si te lo cuenta en una frase, sabes qué ocurre sin traducir nada. Esa es toda la diferencia entre una herramienta y un producto.
La lección de ingeniería
Los errores de idioma no se arreglan corrigiendo frases: se arreglan con una fuente única de verdad (la tabla), una regla de estilo (nada que parsear) y una prueba que barra el catálogo entero. Cuando el estándar vive en las pruebas, ningún caso vuelve a colarse por la puerta.