Aller au contenu principal

Quand 92 % veut dire deux choses

Une étude de cas de rédaction UX sur les chaînes qui énoncent leur propre contexte dans une interface en texte brut.

Sweepy est un outil de recherche d'emploi en terminal. L'interface se dessine avec des caractères de cadre et du texte en couleur, et elle lit les saisies au clavier. Une explication doit tenir dans le texte lui-même, car une infobulle n'a nulle part où apparaître. Le panneau de lancement tronque sa ligne d'état au bord du cadre au lieu de la renvoyer à la ligne. Une chaîne tient dans la largeur ou perd sa fin.

Une règle en est sortie. Chaque chaîne énonce son propre contexte. Les libellés de score indiquent qui a écrit le chiffre. Le texte d'état suit la même discipline, de la ligne du bas du panneau de lancement jusqu'à l'indication de format de chaque question. Le score est le cas difficile, car un pourcentage paraît informatif que le lecteur sache ou non comment l'outil l'a produit.

Deux pourcentages, deux questions​

Sweepy note une offre face à un CV de deux façons différentes.

La première est le moteur de score déterministe, et chaque analyse l'exécute. sweepy ouvre le panneau de lancement, et START SWEEP note chaque fiche que l'analyse trouve. sweepy --run rejoue le dernier profil enregistré sans ouvrir l'assistant. Cette passe compare deux documents. Elle compte les mots partagés entre le CV et l'offre, combine le recouvrement des exigences à 60 % avec le recouvrement des mots-clés à 40 %, puis met le résultat à l'échelle selon resume.keywords_weight. Un terme compte seulement lorsqu'il apparaît des deux côtés. Le moteur ne raisonne jamais sur la capacité du lecteur à faire le travail.

La seconde est une évaluation par agent, disponible via le Model Context Protocol (MCP). Un agent lit le CV analysé et l'offre ensemble, puis raisonne sur l'adéquation du lecteur au poste. Il soumet son propre pourcentage via submit_judgments.

Un décompte de mots partagés et le jugement d'un agent répondent à des questions différentes. Un décompte de mots partagés mesure un recouvrement, pas une adéquation : le libellé doit donc nommer l'auteur. Le décompte indique quelle part de texte le CV et l'offre ont en commun. L'agent juge à quel point une personne convient à un emploi. Un CV peut reprendre une offre mot pour mot et décrire malgré tout une adéquation faible. Un CV écrit dans un autre vocabulaire peut en décrire une forte. Le décompte repère le premier cas et manque le second, et l'agent peut peser les deux.

La fiche affiche un seul score. L'auteur le plus récent le fixe, et une évaluation reclasse le rapport autour de la nouvelle valeur. Le jugement remplace le score déterministe au lieu de s'ajouter à côté. Un pourcentage nu cache lequel des deux le lecteur a sous les yeux.

Le texte devait nommer l'auteur dans la ligne du badge, avant que le lecteur ouvre une offre. Le reste de l'interface suit la même règle.

Du panneau de lancement aux résultats​

Le parcours va du panneau de lancement → assistant de configuration → analyse → résultats. Quand une analyse dépasse la limite d'appel d'outil du client, elle passe à un état interrogeable qui reste actif jusqu'à la fin de l'exécution.

Les fiches 3 à 8 suivent cet ordre. La fiche 2 couvre le score, qui n'existe qu'une fois l'analyse terminée et vers lequel le reste de la page progresse. La fiche 1 pose le problème, et la fiche 9 énonce la contrainte derrière chaque chaîne intermédiaire.

La largeur du cadre tronque les chaînes longues​

Le terminal fixe les règles. Le texte est la seule couche qui explique quoi que ce soit, et le cadre tronque ce qui dépasse. Une erreur doit énoncer le problème et la solution dans la même chaîne. Le lecteur ne peut pas quitter la ligne pour en lire une autre.

Les chaînes paient leur propre contexte. Could not parse salary %r. Enter a number like 65000, 65,000, or 65k. indique ce qui a échoué et quoi saisir à la place, avec %r remplacé par la saisie rejetée. Current profile: none loaded / build one to start fait de même pour un profil absent. Une interface graphique pourrait placer la seconde moitié de l'une ou l'autre phrase dans une infobulle. Ici, la ligne contient les deux moitiés.

Le libellé comme seule explication​

Le libellé de score énonce qui a écrit le chiffre. La documentation le dit sans détour : « Une fiche MATCH reflète un jugement. Une fiche KEYWORD OVERLAP reflète des mots partagés. » Un libellé s'imprime sur une fiche à côté d'un score. Le lecteur sait quelle affirmation il tient avant d'ouvrir l'offre.

Chaque mot indique aussi au lecteur quel type de comparaison a produit le chiffre. KEYWORD OVERLAP porte sur deux documents. MATCH porte sur une personne et un emploi. Un lecteur qui attend que les deux chiffres concordent en lit mal un.

Le libellé suit l'auteur, pas l'interface. Un agent peut soumettre un jugement sans pourcentage. Cette fiche affiche toujours KEYWORD OVERLAP, car l'analyse a écrit ce chiffre. Le chemin d'exécution vit hors de la fiche. Le nom du fichier de rapport marque une exécution MCP avec mcp, et l'en-tête du journal imprime la méthode d'exécution.

Le nommage des tuiles suit la même règle. BUILD PROFILE énonce l'action, et son sous-titre, Set up your job search, écarte le terme interne au profit de l'objectif du lecteur. LOAD PROFILE affiche Open a search you saved, qui décrit ce que fait la tuile.

Ce que j'ai écrit et comment je l'ai vérifié​

Rôle : seul rédacteur des chaînes produit citées dans cette étude de cas. J'ai écrit les sous-titres du panneau de lancement et les questions de l'assistant, puis les messages de progression et le texte de validation. Les libellés de provenance du score et le message de passation MCP qu'un client relaie sont venus en dernier. J'ai dirigé la construction avec Copilot et Gemini, sous les directives d'agent du dépôt et un contrôle qualité en CI. J'ai vérifié les chaînes produit littérales dans le code source de Sweepy.

Calibrer la confiance, puis agir​

Le lecteur doit calibrer sa confiance avant d'agir sur un score et savoir ce que fait le système pendant qu'il attend. L'interface ne peut pas expliquer comment Sweepy a produit un chiffre ni combien de temps prend un processus. Le libellé et les chaînes d'état l'expliquent avec le moins de mots possible, sous une forme qui fonctionne sans repères visuels.

Les quinze questions dans l'ordre​

L'assistant compte quinze étapes. Les quinze questions de premier niveau apparaissent dans l'ordre, et les questions oui ou non s'affichent sous forme de sélecteur oui/non.

Questions de l'assistant
? 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)

Où vérifier les chaînes​