Saltar al contenido principal

Cuando el 92 % significa cosas diferentes

Un estudio de caso de redacción UX sobre cadenas de texto que definen su propio contexto en una interfaz de texto sin formato.

Sweepy es una herramienta de búsqueda de empleo basada en terminal. La interfaz se dibuja con caracteres de dibujo de cuadros y texto en color, y lee la entrada del teclado. La explicación debe estar presente en el propio texto, ya que no hay espacio para que aparezca una descripción emergente. El panel de inicio recorta su línea de estado en el borde del marco en lugar de ajustar el texto. Una cadena o bien termina dentro del ancho disponible o bien pierde su final.

De ahí surgió una regla: Cada cadena indica su propio contexto. Las etiquetas de puntuación indican quién ha introducido el número. El texto de estado sigue la misma disciplina, desde la línea inferior del lanzador hasta la sugerencia de formato de cada solicitud. La puntuación es el caso más complicado, porque un porcentaje parece informativo independientemente de si el lector sabe cómo lo ha calculado la herramienta.

Dos porcentajes, dos preguntas​

Sweepy puntúa una publicación en comparación con un currículum de dos formas diferentes.

La primera es el sistema de puntuación determinista, y cada barrido lo ejecuta. sweepy abre el Launchpad y START SWEEP puntúa cada ficha que encuentra el barrido. sweepy --run repite el último perfil guardado sin abrir el asistente. Esta pasada compara dos documentos. Cuenta las palabras compartidas entre el currículum y la oferta de empleo, combinando la coincidencia de requisitos en un 60 % con la coincidencia de palabras clave en un 40 %, y luego escala el resultado por resume.keywords_weight. Un término solo cuenta cuando aparece en ambos documentos. El evaluador nunca razona sobre si el lector podría desempeñar el puesto.

La segunda es una evaluación por parte de un agente, disponible a través del Protocolo de Contexto del Modelo (MCP). Un agente lee conjuntamente el currículum analizado y la oferta de empleo, y luego razona sobre en qué medida el lector se ajusta al puesto. Envía su propio porcentaje a través de submit_judgments.

El recuento de palabras compartidas y el juicio del agente responden a preguntas diferentes. El recuento de palabras compartidas mide la coincidencia, no la adecuación, por lo que la etiqueta debe identificar al autor. El recuento indica cuánto texto comparten el currículum y la oferta de empleo. El agente evalúa en qué medida una persona se adapta a un puesto de trabajo. Un currículum puede repetir palabra por palabra el texto de la oferta de empleo y, aun así, indicar una escasa adecuación. Un currículum redactado con otro vocabulario puede indicar una gran adecuación. El recuento de palabras detecta el primer caso y pasa por alto el segundo, mientras que el agente puede sopesar ambos.

La ficha muestra una puntuación. El autor más reciente la establece, y una evaluación vuelve a clasificar el informe en función del nuevo valor. La valoración sustituye a la puntuación determinista en lugar de aparecer junto a ella. Un simple porcentaje oculta cuál de las dos opciones tiene el lector.

El texto debía indicar el autor dentro de la línea de la insignia, antes de que el lector abriera una ficha. El resto de la interfaz sigue la misma regla.

De la plataforma de lanzamiento a los resultados​

El flujo sigue el orden: plataforma de lanzamiento → asistente de configuración → barrido → resultados. Cuando un barrido supera el límite de llamadas a herramientas del cliente, pasa a un estado consultable que permanece activo hasta que finaliza la ejecución.

Las tarjetas 3 a 8 siguen ese orden. La tarjeta 2 muestra la puntuación, que solo aparece una vez finalizado el barrido y es el objetivo hacia el que se dirige el resto de la página. La tarjeta 1 expone el problema, y la tarjeta 9 describe la restricción que subyace a cada cadena de caracteres entre ambas.

El ancho del marco recorta las cadenas largas​

El terminal marca las reglas. El texto es la única capa que explica algo, y el marco recorta todo lo que se sale de su ancho. Un error debe indicar el problema y la solución en la misma cadena. El lector no puede salir de la línea para leer otra.

Las cadenas proporcionan su propio contexto. Could not parse salary %r. Enter a number like 65000, 65,000, or 65k. informa de lo que ha fallado y de lo que hay que escribir en su lugar, sustituyendo %r por la entrada rechazada. Current profile: none loaded / build one to start hace lo mismo en caso de que falte un perfil. Una interfaz gráfica de usuario podría mostrar la segunda mitad de cualquiera de las dos frases en una información sobre herramientas. Aquí, la línea incluye ambas mitades.

La etiqueta como única explicación​

La etiqueta de puntuación indica quién ha introducido el número. La documentación lo explica claramente: «Una tarjeta MATCH refleja un juicio. Una tarjeta KEYWORD OVERLAP refleja palabras compartidas». En cada tarjeta aparece una etiqueta junto a una puntuación. El lector sabe de qué afirmación se trata antes de abrir la lista.

Cada palabra también indica al lector qué tipo de comparación ha generado la cifra. KEYWORD OVERLAP se refiere a dos documentos. MATCH se refiere a una persona y un puesto de trabajo. Un lector que espere que las dos cifras coincidan interpretará mal una de ellas.

La etiqueta hace referencia al autor, no a la interfaz. Un agente puede enviar un juicio sin porcentaje. Esa tarjeta seguirá indicando KEYWORD OVERLAP, porque fue el autor quien escribió ese número. La ruta de ejecución se encuentra fuera de la tarjeta. El nombre del archivo de informe identifica una ejecución de MCP con mcp, y el encabezado del registro muestra el método de ejecución.

La denominación de los mosaicos sigue la misma regla. BUILD PROFILE indica la acción, y su subtítulo, Set up your job search, omite el término interno para referirse al objetivo del lector. LOAD PROFILE dice Open a search you saved, lo que describe lo que hace el mosaico.

Lo que escribí y cómo lo revisé​

Función: único redactor de las cadenas de texto del producto que cita este caso práctico. Redacté los subtítulos de Launchpad y las indicaciones del asistente, y posteriormente los mensajes de progreso y el texto de validación. Las etiquetas de procedencia de la puntuación y el message de traspaso de MCP que transmite un cliente fueron lo último en redactarse. Dirigí la compilación con Copilot y Gemini, siguiendo las directrices de los agentes a nivel de repositorio y un control de calidad de CI. Verifiqué las cadenas de texto literales del producto cotejándolas con el código fuente de Sweepy.

Calibrar la confianza y luego actuar​

El lector debe calibrar la confianza antes de actuar en función de una puntuación y saber qué está haciendo el sistema mientras espera. La interfaz no puede explicar cómo Sweepy ha generado una cifra ni cuánto tiempo tarda un proceso. Las cadenas de etiquetas y estado lo explican con el menor número de palabras posible, de una forma que funciona sin recursos visuales.

Las quince indicaciones en orden​

El asistente ejecuta quince pasos. Las quince indicaciones de nivel superior aparecen en orden, y las preguntas de sí o no se muestran como un selector de sí/no.

Indicaciones del asistente
? What is your name?
>

? What job titles are you looking for?
(Separate multiple titles with a comma)
>

? Where do you want to work? (City, State):
>

? Do you want to see remote-only roles? (Y/n)

? Do you want to include hybrid roles? (Y/n)

? What is the path to your resume PDF?
>

? What is your minimum target salary? (Leave blank to skip):
>

? Which boards do you want to search? Pick from any engine; downloaded engines are labeled.

? Do you want to add custom platforms or ATS domains? (Y/n)

? Enter must-have skills or keywords to prioritize
(comma-separated, leave blank to extract from resume):
>

? What export formats do you want?
[x] PDF Report
[x] CSV Spreadsheet
[ ] JSON Data

? Add job-tracking columns to the CSV? (date applied, status, interview stage,
offer, follow-up date, contact, notes) (Y/n)

? Do you want to configure multiple resume tracks
(e.g. Tech Writer vs UX Writer)? (Y/n)

? Do you have a portfolio, writing samples, or case studies to submit
with applications? (Y/n)

? Enable debug logging? (Logs are saved under logs/ in the application
directory): (Y/n)

Dónde verificar las cadenas​