जब 92% के मायने अलग होते हैं
सादे टेक्स्ट इंटरफ़ेस में अपना संदर्भ खुद बताने वाली स्ट्रिंग्स पर एक UX राइटिंग केस स्टडी।
Sweepy टर्मिनल पर चलने वाला नौकरी खोजने का टूल है। इंटरफ़ेस बॉक्स-ड्रॉइंग अक्षरों और रंगीन टेक्स्ट से बनता है, और कीबोर्ड से इनपुट पढ़ता है। व्याख्या को टेक्स्ट के भीतर ही रहना पड़ता है, क्योंकि टूलटिप के दिखने की कोई जगह नहीं है। लॉन्चपैड अपनी स्टेटस लाइन को लपेटता नहीं, फ़्रेम के किनारे पर काट देता है। स्ट्रिंग या तो चौड़ाई के भीतर पूरी होती है या अपना अंत खो देती है।
इससे एक नियम निकला। हर स्ट्रिंग अपना संदर्भ खुद बताती है। स्कोर लेबल बताते हैं कि संख्या किसने लिखी। स्टेटस टेक्स्ट उसी अनुशासन का पालन करता है, लॉन्चपैड की निचली पंक्ति से लेकर हर प्रॉम्प्ट के फ़ॉर्मेट संकेत तक। स्कोर सबसे कठिन मामला है, क्योंकि प्रतिशत तब भी जानकारीपूर्ण दिखता है जब पाठक को पता न हो कि टूल ने उसे कैसे निकाला।
दो प्रतिशत, दो सवाल
Sweepy किसी नौकरी विज्ञापन को रिज़्यूमे के सामने दो अलग तरीकों से स्कोर करता है।
पहला नियतात्मक स्कोरर है, और हर स्वीप उसे चलाता है। sweepy लॉन्चपैड खोलता है, और START SWEEP स्वीप में मिलने वाले हर कार्ड को स्कोर करता है। sweepy --run विज़ार्ड खोले बिना पिछली सहेजी गई प्रोफ़ाइल दोहराता है। यह चरण दो दस्तावेज़ों की तुलना करता है। यह रिज़्यूमे और विज्ञापन के बीच साझा शब्द गिनता है, आवश्यकता के मेल को 60% और कीवर्ड के मेल को 40% पर मिलाता है, फिर परिणाम को resume.keywords_weight से बढ़ाता-घटाता है। कोई शब्द तभी गिना जाता है जब वह दोनों तरफ़ मौजूद हो। स्कोरर कभी यह नहीं सोचता कि पाठक वह काम कर सकता है या नहीं।
दूसरा एजेंट मूल्यांकन है, जो मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) से उपलब्ध है। एजेंट पार्स किए गए रिज़्यूमे और विज्ञापन को साथ पढ़ता है, फिर सोचता है कि पाठक उस भूमिका में कितना फ़िट है। वह अपना प्रतिशत submit_judgments से भेजता है।
साझा शब्दों की गिनती और एजेंट का निर्णय अलग-अलग सवालों के जवाब देते हैं। साझा शब्दों की गिनती मेल नापती है, फ़िट नहीं, इसलिए लेबल को लिखने वाले का नाम बताना पड़ता है। गिनती बताती है कि रिज़्यूमे और विज्ञापन में कितना टेक्स्ट साझा है। एजेंट तय करता है कि एक व्यक्ति एक नौकरी में कितना फ़िट है। रिज़्यूमे किसी विज्ञापन को शब्द-दर-शब्द दोहरा सकता है और फिर भी कमज़ोर फ़िट बता सकता है। दूसरी शब्दावली वाला रिज़्यूमे मज़बूत फ़िट बता सकता है। शब्द गिनती पहला मामला पकड़ती है और दूसरा चूक जाती है, जबकि एजेंट दोनों को तौल सकता है।
कार्ड एक ही स्कोर दिखाता है। सबसे हाल का लिखने वाला उसे तय करता है, और मूल्यांकन रिपोर्ट को नई संख्या के इर्द-गिर्द फिर से क्रम में लगाता है। निर्णय नियतात्मक स्कोर के बगल में बैठने के बजाय उसे बदल देता है। केवल प्रतिशत देखकर पता नहीं चलता कि पाठक के पास दोनों में से कौन-सा है।
टेक्स्ट को बैज पंक्ति के भीतर ही लिखने वाले का नाम बताना था, इससे पहले कि पाठक कोई विज्ञापन खोले। इंटरफ़ेस का बाक़ी हिस्सा उसी नियम का पालन करता है।
लॉन्चपैड से परिणाम तक
प्रवाह इस क्रम में चलता है: लॉन्चपैड → सेटअप विज़ार्ड → स्वीप → परिणाम। जब स्वीप क्लाइंट की टूल-कॉल सीमा से आगे निकल जाता है, तो वह ऐसी पोल-योग्य स्थिति को हाथ सौंप देता है जो रन पूरा होने तक जीवित रहती है।
कार्ड 3 से 8 इसी क्रम का पालन करते हैं। कार्ड 2 स्कोर को कवर करता है, जो स्वीप खत्म होने के बाद ही बनता है और जिसकी ओर पूरा पेज बढ़ता है। कार्ड 1 समस्या बताता है, और कार्ड 9 उस बाधा को बताता है जो बीच की हर स्ट्रिंग के पीछे है।
एक स्कोर स्लॉट, दो लेखक
एक स्कोर स्लॉट, दो संभावित लेखक। हर स्वीप नियतात्मक मेल गिनती से हर कार्ड को स्कोर करता है। लेकिन MCP मूल्यांकन उस संख्या को अपनी सोच से बदल देता है। लेबल में साफ़ अंतर के बिना पाठक नहीं जान पाता कि स्कोर किसने तय किया, और भरोसा नहीं तौल पाता। सामग्री की समस्या यह थी कि बैज पंक्ति के भीतर, कुछ शब्दों की जगह में, लिखने वाले को अलग पहचाना जाए।
गिनती और निर्णय में अंतर
एक ही प्रोफ़ाइल, एक ही संख्या, दो लेखक। पहला कार्ड एजेंट ने तय किया, इसलिए वह 92% MATCH दिखाता है। दूसरा कार्ड नियतात्मक स्कोरर ने तय किया, इसलिए वह 92% KEYWORD OVERLAP दिखाता है। लेबल लिखने वाले की पहचान कराता है। जो पाठक केवल 92% देखता है, उसके पास दोनों में फ़र्क़ करने का कोई तरीका नहीं है। मूल्यांकन उसी स्लॉट में मेल स्कोर को बदल देता है, क्योंकि गिनती और निर्णय अलग-अलग सवालों के जवाब देते हैं।
92% KEYWORD OVERLAPका अर्थ है साझा शब्दों की गिनती, जो रिज़्यूमे की विज्ञापन से तुलना करती है।92% MATCHका अर्थ है वह संख्या जिस तक एजेंट पाठक की भूमिका में फ़िट पर सोचकर पहुँचा।
स्वीप अपने बनाए हर कार्ड पर यह गिनती लिखता है, चाहे वह टर्मिनल में शुरू हो या MCP पर run_sweep से। केवल भेजा गया match_pct उसे MATCH से बदलता है।
PDF रैंक पंक्ति लेबल को कोष्ठक में दोहराती है: #1 // COMPANY | [92% MATCH] या [92% KEYWORD OVERLAP]। CSV match_value को match_kind के आगे लिखता है, जो पाठक को वही तथ्य मशीन-पठनीय रूप में देता है। मेल स्कोर के बगल में तीसरा स्कोर भी आ सकता है। [88% PORTFOLIO FIT] इसी कारण अपना अलग लेबल छापता है, क्योंकि आपके नमूने उस सवाल का जवाब देते हैं जो आपका रिज़्यूमे नहीं देता।
आवेदन बैज पहले टेक्स्ट में पढ़ा जाता है, रंग बाद में। [STANDARD / QUICK APPLY] मानक आवेदन दर्शाता है, और [EXTENDED RESPONSES REQUIRED] ऐसी भूमिका दर्शाता है जिसमें लेखन नमूने चाहिए। तीसरा कार्ड [EXTENDED RESPONSES REQUIRED] उस रैंक पंक्ति पर छापता है जिसमें रिज़्यूमे ट्रैक भी सूचीबद्ध होता है। दोनों लेबल रंग के बिना भी काम करते हैं, जो सुलभता और उन टर्मिनलों के लिए ज़रूरी है जो रंग नहीं दिखाते।
एक पंक्ति में पहचान, दायरा और तैयारी
Current profile: none loaded / build one to start एक ही पंक्ति में गायब स्थिति और अगला कदम बताता है। Current profile: Alex Rivera / 4 titles / Ready पहले स्लॉट में नाम और आख़िरी में तैयारी की पुष्टि करता है। हर स्लैश एक जवाब को अगले से अलग करता है, और पंक्ति लपेटने के बजाय फ़्रेम के किनारे पर कट जाती है। जब सहेजी गई प्रोफ़ाइल में रिज़्यूमे का पथ नहीं होता, तो Resume missing Ready की जगह आ जाता है।
टर्मिनल में स्टेटस लाइन ही एकमात्र स्थायी संदर्भ है। वह एक साथ शीर्षक और तैयारी का संकेतक दोनों पढ़ी जाती है।
क्रिया, फिर कर्म, फिर पाठक का लक्ष्य
START SWEEP का जोड़ीदार Run your job search now है। हर टाइल दो पंक्तियाँ छापती है: एक नाम, और एक उपशीर्षक जो Enter के काम को पाठक के शब्दों में दोहराता है। SWEEP SETTINGS पर Ranking, cards, tracking लिखा है। SWEEPY'S TOOLBOX पर Edit profile, logs, help लिखा है। EXIT SWEEPY पर Save changes and close लिखा है, जो आपका काम सहेजने का वादा करता है।
क्रिया टाइलें क्रिया और उसके कर्म से शुरू होती हैं। बाक़ी जगह या बाहर निकलने का नाम बताती हैं। उपशीर्षक किसी भी आंतरिक शब्द को सरल भाषा में समझाता है। दो अंकों की संख्याएँ ग्रिड का क्रम तय करने के बजाय हर टाइल की पहचान कराती हैं। ऊपरी पंक्ति 01 को 04 के साथ जोड़ती है। कोई टाइल ग्रिड में जुड़ती है और बाक़ी की संख्या नहीं बदलती। नेविगेशन ऐरो कुंजियों और Enter से चलता है।
प्रॉम्प्ट के भीतर फ़ॉर्मेट संकेत
प्रॉम्प्ट सवाल को एक पंक्ति में रखता है, और जब फ़ॉर्मेट मायने रखता है, तो नियम को उसके नीचे हाशिये के साथ रखता है:
What job titles are you looking for?
(Separate multiple titles with a comma)
वेतन वाला प्रॉम्प्ट छोड़ने का विकल्प सवाल के भीतर ही बताता है:
What is your minimum target salary? (Leave blank to skip):
नियम उसी पंक्ति में दिखता है जहाँ फ़ैसला होता है। पाठक उसी स्क्रीन पर बना रहता है। टर्मिनल के पास कोई टूलटिप नहीं होता जिस पर लौटा जा सके।
विज़ार्ड दोबारा चलाए बिना जवाब बदलें
विज़ार्ड पंद्रह चरण चलता है, और Esc हर दबाव पर एक सवाल पीछे ले जाता है। समीक्षा स्क्रीन ग्यारह प्रविष्टियाँ गिनाती है: ← Back, फिर Submit profile, फिर नौ क्रियाएँ। Edit an answer ठीक Submit profile के नीचे है। बदलाव भेजने से सिर्फ़ एक पंक्ति दूर है। जो पाठक जवाब बदलना चाहता है, उसे हर प्रॉम्प्ट दोबारा नहीं चलाना पड़ता।
पाँच चरणों के स्टेज लेबल
कमांड-लाइन रन पाँच क्रमांकित चरण छापता है, और हर चरण काम बताता है।
[1/5] Loading profile...
[2/5] Discovering roles...
[3/5] Validating URLs...
[4/5] Scoring against resume...
[5/5] Generating reports...
लॉग पंक्तियाँ स्टेज संख्या बताती हैं। MCP प्रगति पेलोड आइटम का नाम बताता है: चार नौकरी शीर्षकों में से पहले के लिए total 4 में से step 1, लेबल Discovering roles: Paralegal। Scoring roles स्कोरर के काम करते समय शॉर्टलिस्ट बताता है। पाठक देखता है कि रन कहाँ है और क्या बचा है। प्रगति पट्टी ऐसी अवधि का संकेत देती जिसे टूल जान ही नहीं सकता।
वह प्रतीक्षा जो जॉब आईडी लौटाती है
लाइव स्वीप एक मिनट या उससे ज़्यादा चल सकता है। MCP मोड में टूल कॉल पूरा स्वीप इंतज़ार करने के बजाय चल रही स्थिति लौटाता है। इससे कॉल क्लाइंट की समय-सीमा के भीतर रहता है और कॉलर को पता चलता है कि काम जारी है।
run_sweep डिफ़ॉल्ट रूप से 45 सेकंड इंतज़ार करता है। wait_seconds उस प्रतीक्षा को तय करता है, जो 0 से 600 तक सीमित है, और SWEEPY_MCP_WAIT_SECONDS कड़ी सीमाओं वाले होस्ट पर ऊपरी सीमा घटा देता है। चल रही स्थिति में job_id, एक progress ऑब्जेक्ट, एक elapsed_seconds मान और एक 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."
}
क्लाइंट job_id के साथ get_sweep_status को तब तक पोल करता है जब तक sweep_status "completed" न पढ़ा जाए। Sweepy इस हैंडऑफ़ के दौरान काम करता रहता है, चाहे क्लाइंट जुड़ा रहे या नहीं। टेक्स्ट को समय-सीमा के भीतर फ़िट होना चाहिए और बाद में दोबारा जुड़ने वाले क्लाइंट के लिए सही पढ़ा जाना चाहिए। यह एक चल रही स्थिति है जो प्रगति बताती है।
45 सेकंड उत्पाद का डिफ़ॉल्ट मान है, जिसे _DEFAULT_WAIT_SECONDS तय करता है और _MAX_WAIT_SECONDS सीमित करता है। progress और elapsed_seconds हर रन में बदलते हैं, और debug_log भी। message उन संख्याओं को दोहराने के बजाय अगला टूल कॉल बताता है जो कॉलर के पास पहले से हैं।
कमज़ोर टेक्स्ट छिपाने की कोई जगह नहीं
इंटरफ़ेस केवल टेक्स्ट पर टिका है, और फ़्रेम जो लंबा है उसे काट देता है। लेबल को खुद में पूरा होना चाहिए, क्योंकि स्क्रीन पर कोई और चीज़ उसे नहीं समझाती। स्टेटस संदेश बताते हैं कि पाठक कहाँ है, बिना किसी घूमते संकेतक के सहारे।
नामकरण का नियम वहीं से आता है। START SWEEP, LOAD PROFILE और BUILD PROFILE क्रिया से शुरू होते हैं। उनके उपशीर्षक उसे पाठक के लक्ष्य के रूप में दोहराते हैं, इसलिए किसी को यह जानने के लिए «प्रोफ़ाइल» का आंतरिक विचार नहीं चाहिए कि आगे क्या होगा। स्कोर लेबल वही नियम संख्या पर लगाता है। KEYWORD OVERLAP नियतात्मक गिनती को दर्शाता है, और MATCH एजेंट के निर्णय को।
फ़्रेम की चौड़ाई लंबी स्ट्रिंग्स को काटती है
टर्मिनल शर्तें तय करता है। टेक्स्ट ही एकमात्र परत है जो कुछ समझाती है, और फ़्रेम जो लंबा है उसे काट देता है। त्रुटि को समस्या और उपाय एक ही स्ट्रिंग में बताने पड़ते हैं। पाठक दूसरी पंक्ति पढ़ने के लिए इस पंक्ति को छोड़ नहीं सकता।
स्ट्रिंग्स अपने संदर्भ की क़ीमत खुद चुकाती हैं। Could not parse salary %r. Enter a number like 65000, 65,000, or 65k. बताता है कि क्या विफल हुआ और उसकी जगह क्या लिखना है, जिसमें %r को अस्वीकृत प्रविष्टि से बदला जाता है। Current profile: none loaded / build one to start गायब प्रोफ़ाइल के लिए वही करता है। GUI किसी भी वाक्य का दूसरा आधा हिस्सा टूलटिप में रख सकता है। यहाँ पंक्ति दोनों आधे हिस्से शामिल करती है।
एकमात्र व्याख्या के रूप में लेबल
स्कोर लेबल बताता है कि संख्या किसने लिखी। दस्तावेज़ इसे सीधे कहते हैं: «MATCH कार्ड निर्णय दर्शाता है। KEYWORD OVERLAP कार्ड साझा शब्द दर्शाता है।» एक कार्ड पर एक स्कोर के बगल में एक लेबल छपता है। पाठक विज्ञापन खोलने से पहले जान जाता है कि उसके पास कौन-सा दावा है।
हर शब्द यह भी बताता है कि किस तरह की तुलना ने वह संख्या निकाली। KEYWORD OVERLAP दो दस्तावेज़ों के बारे में बताता है। MATCH एक व्यक्ति और एक नौकरी के बारे में बताता है। जो पाठक दोनों संख्याओं के मेल की उम्मीद करता है, वह किसी एक को ग़लत पढ़ता है।
लेबल इंटरफ़ेस का नहीं, लिखने वाले का पीछा करता है। एजेंट बिना प्रतिशत के भी निर्णय भेज सकता है। वह कार्ड फिर भी KEYWORD OVERLAP दिखाता है, क्योंकि वह संख्या स्वीप ने लिखी थी। निष्पादन का रास्ता कार्ड के बाहर रहता है। रिपोर्ट के फ़ाइल नाम में MCP रन को mcp से चिह्नित किया जाता है, और लॉग हेडर निष्पादन की विधि छापता है।
टाइल का नामकरण उसी नियम का पालन करता है। BUILD PROFILE क्रिया बताता है, और उसका उपशीर्षक Set up your job search आंतरिक शब्द को हटाकर पाठक का लक्ष्य रखता है। LOAD PROFILE पर Open a search you saved लिखा है, जो बताता है कि टाइल क्या करती है।
मैंने क्या लिखा और कैसे जाँचा
भूमिका: इस केस स्टडी में उद्धृत उत्पाद स्ट्रिंग्स का एकमात्र लेखक। लॉन्चपैड के उपशीर्षक और विज़ार्ड के प्रॉम्प्ट लिखे, फिर प्रगति के संदेश और सत्यापन का टेक्स्ट। स्कोर की उत्पत्ति बताने वाले लेबल और क्लाइंट द्वारा आगे भेजा जाने वाला MCP हैंडऑफ़ message सबसे अंत में आए। रिपॉज़िटरी-स्तरीय एजेंट दिशानिर्देशों और CI गुणवत्ता गेट के तहत Copilot और Gemini के साथ बिल्ड का नेतृत्व किया। शब्दशः उत्पाद स्ट्रिंग्स को Sweepy के स्रोत कोड के सामने जाँचा।
भरोसा तौलें, फिर कार्रवाई करें
पाठक को स्कोर पर कार्रवाई करने से पहले भरोसा तौलना चाहिए और इंतज़ार के दौरान यह जानना चाहिए कि सिस्टम क्या कर रहा है। इंटरफ़ेस यह नहीं समझा सकता कि Sweepy ने संख्या कैसे निकाली या किसी प्रक्रिया में कितना समय लगता है। लेबल और स्टेटस स्ट्रिंग्स इसे सबसे कम शब्दों में बताते हैं, ऐसे रूप में जो दृश्य संकेतों के बिना भी काम करे।
पंद्रह प्रॉम्प्ट क्रम से
विज़ार्ड पंद्रह चरण चलाता है। पंद्रह शीर्ष-स्तरीय प्रॉम्प्ट क्रम से आते हैं, और हाँ-या-नहीं वाले सवाल हाँ/नहीं चयनकर्ता के रूप में दिखते हैं।
? 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)