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.
Un emplacement de score, deux auteurs
Un emplacement de score, deux auteurs possibles. Chaque analyse note chaque fiche avec le décompte déterministe des recouvrements. Mais une évaluation MCP écrase ce chiffre avec son propre raisonnement. Sans une différence de libellé claire, le lecteur ne peut pas savoir quel auteur a fixé le score et ne peut pas calibrer sa confiance. Le problème de contenu consistait à distinguer l'auteur dans la ligne du badge, en quelques mots.
Distinguer un décompte d'un jugement
Même profil, même chiffre, deux auteurs. Un agent a fixé la première fiche, qui affiche donc 92% MATCH. Le moteur déterministe a fixé la seconde, qui affiche donc 92% KEYWORD OVERLAP. Le libellé identifie l'auteur. Un lecteur qui ne voit que 92 % n'a aucun moyen de distinguer les deux. L'évaluation écrase le score de recouvrement dans le même emplacement, car le décompte et le jugement répondent à des questions différentes.
92% KEYWORD OVERLAPdésigne le décompte de mots partagés, qui compare le CV à l'offre.92% MATCHdésigne le chiffre auquel un agent est parvenu en raisonnant sur l'adéquation du lecteur au poste.
Une analyse écrit le décompte sur chaque fiche qu'elle produit, qu'elle démarre dans le terminal ou via run_sweep en MCP. Seul un match_pct soumis le remplace par MATCH.
La ligne de classement du PDF répète le libellé entre crochets : #1 // COMPANY | [92% MATCH] ou [92% KEYWORD OVERLAP]. Le CSV écrit match_value à côté de match_kind, ce qui donne au lecteur le même fait sous forme lisible par machine. Un troisième score peut apparaître à côté du score de correspondance. [88% PORTFOLIO FIT] imprime son propre libellé pour la même raison, car vos échantillons répondent à une autre question que votre CV.
Le badge de candidature se lit d'abord dans le texte, ensuite dans la couleur. [STANDARD / QUICK APPLY] marque un envoi standard, et [EXTENDED RESPONSES REQUIRED] marque un poste qui exige des échantillons de rédaction. La troisième fiche imprime [EXTENDED RESPONSES REQUIRED] sur une ligne de classement qui liste aussi la piste de CV. Les deux libellés fonctionnent sans couleur, ce qui compte pour l'accessibilité et pour les terminaux qui ne l'affichent pas.
Identité, périmètre et disponibilité sur une ligne
Current profile: none loaded / build one to start énonce l'état manquant et l'action suivante sur une seule ligne. Current profile: Alex Rivera / 4 titles / Ready confirme le nom dans le premier emplacement et la disponibilité dans le dernier. Chaque barre oblique sépare une réponse de la suivante, et la ligne se tronque au bord du cadre au lieu de passer à la ligne. Resume missing remplace Ready quand le profil enregistré n'a pas de chemin vers un CV.
Dans un terminal, la ligne d'état est le seul contexte permanent. Elle se lit à la fois comme un en-tête et comme un indicateur de disponibilité.
Verbe, objet, puis l'objectif du lecteur
START SWEEP s'associe à Run your job search now. Chaque tuile imprime deux lignes : un nom et un sous-titre qui reformule ce que fait la touche Entrée avec les mots du lecteur. SWEEP SETTINGS affiche Ranking, cards, tracking. SWEEPY'S TOOLBOX affiche Edit profile, logs, help. EXIT SWEEPY affiche Save changes and close, qui promet de conserver votre travail.
Les tuiles d'action commencent par un verbe et son objet. Les autres nomment un endroit ou une sortie. Un sous-titre glose tout terme interne en langage clair. Les nombres à deux chiffres identifient chaque tuile plutôt que d'ordonner la grille. La rangée du haut associe 01 à 04. Une tuile rejoint la grille sans renuméroter les autres. La navigation fonctionne avec les flèches et la touche Entrée.
Des indications de format dans la question
Une question garde l'interrogation sur une ligne et, quand le format compte, place la règle en dessous, en retrait :
What job titles are you looking for?
(Separate multiple titles with a comma)
La question sur le salaire énonce l'option de passer dans la question elle-même :
What is your minimum target salary? (Leave blank to skip):
La règle apparaît sur la ligne où la décision se prend. Le lecteur reste sur l'écran. Un terminal n'a aucune infobulle où se rabattre.
Modifier une réponse sans relancer l'assistant
L'assistant compte quinze étapes, et Échap remonte d'une question à la fois. L'écran de révision liste onze entrées : ← Back, puis Submit profile, puis neuf actions. Edit an answer se trouve juste sous Submit profile. La révision est à une rangée de l'envoi. Un lecteur qui veut changer une réponse ne rejoue pas toutes les questions.
Des libellés d'étape pour les cinq phases
Une exécution en ligne de commande inscrit cinq étapes numérotées, chacune énonçant le travail.
[1/5] Loading profile...
[2/5] Discovering roles...
[3/5] Validating URLs...
[4/5] Scoring against resume...
[5/5] Generating reports...
Les lignes de journal énoncent le numéro d'étape. La charge de progression MCP nomme l'élément : step 1 sur total 4 pour le premier de quatre intitulés de poste, avec le libellé Discovering roles: Paralegal. Scoring roles rend compte de la présélection pendant que le moteur travaille. Le lecteur voit où en est l'exécution et ce qu'il reste. Une barre de progression laisserait entendre une durée que l'outil ne peut pas connaître.
L'attente qui renvoie un identifiant de tâche
Une analyse en direct peut durer une minute ou plus. En mode MCP, l'appel d'outil renvoie un état en cours au lieu d'attendre toute l'analyse. Cela garde l'appel dans le délai d'attente d'un client et indique à l'appelant que le travail continue.
run_sweep attend 45 secondes par défaut. wait_seconds fixe cette attente, bornée de 0 à 600, et SWEEPY_MCP_WAIT_SECONDS abaisse le plafond sur les hôtes aux limites plus strictes. L'état en cours inclut un job_id, un objet progress, une valeur elapsed_seconds et un message :
{
"status": "ok",
"sweep_status": "running",
"job_id": "<job id>",
"progress": { "step": 3, "total": 5, "label": "Validating URLs" },
"elapsed_seconds": 41.2,
"debug_log": "<path>",
"message": "The sweep is still running. Call get_sweep_status to wait for it, then continue with get_jobs."
}
Le client interroge get_sweep_status avec le job_id jusqu'à ce que sweep_status indique "completed". Sweepy continue de travailler pendant la passation, que le client reste connecté ou non. Le texte doit tenir dans le délai d'attente et rester lisible pour un client qui se reconnecte plus tard. C'est un état en cours qui rend compte de la progression.
Les 45 secondes sont une valeur par défaut du produit, fixée par _DEFAULT_WAIT_SECONDS et plafonnée par _MAX_WAIT_SECONDS. progress et elapsed_seconds changent à chaque exécution, tout comme debug_log. Le message nomme l'appel d'outil suivant au lieu de répéter des chiffres que l'appelant possède déjà.
Nulle part où cacher un texte faible
L'interface repose sur le texte seul, et le cadre tronque ce qui dépasse. Un libellé doit se suffire, car rien d'autre à l'écran ne l'explique. Les messages d'état énoncent où se trouve le lecteur, sans indicateur rotatif sur lequel s'appuyer.
La règle de nommage en découle. START SWEEP, LOAD PROFILE et BUILD PROFILE commencent par l'action. Leurs sous-titres la reformulent comme l'objectif du lecteur, donc personne n'a besoin de l'idée interne de « profil » pour savoir ce qui suit. Le libellé de score applique la même règle à un chiffre. KEYWORD OVERLAP marque le décompte déterministe, et MATCH marque le jugement d'un agent.
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.
? 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)