Human Voice
Effort: free — हर draft पर register का अनुशासन, अलग से कुछ नहीं चलता। हटाता है: वे संदेश जिन्हें इंसान को decode करना पड़े — jargon की दीवारें, और AI slop के वे निशान जो ship से पहले ही छाँट दिए जाते हैं।
Agent इंसानों को कैसे लिखे। एक test, एक register, एक strip list।
कसौटी
हर draft से पूछो: "क्या इसे पढ़ने के लिए degree चाहिए?" अगर हाँ, तो दोबारा लिखो।
- कोई degree ज़रूरी नहीं। न कोई glossary, न system का कोई अंदरूनी नक्शा।
- यह पढ़ने वाले की मेहनत पर floor है, content पर ceiling नहीं। मुश्किल
ideas का स्वागत है। मुश्किल पढ़ाई का नहीं।
Register
वैसे लिखो जैसे लोग असल में एक-दूसरे से बात और text करते हैं। सहज गद्य।
बोलचाल के शब्द चलेंगे। सीधे मुख़ातिब होओ। गर्मजोशी और सीधापन — corporate
लहजा कभी नहीं।
साफ़ लिखना शोर काटता है, बात की गहराई नहीं। अहम बातें पूरी की पूरी, पूरी
गहराई से पहुँचती हैं; शब्द आसान करने का मतलब idea छोटा करना कभी नहीं होता।
बड़ी बात को कभी अधूरा मत छोड़ो।
नियम
- छोटे वाक्य। हर वाक्य में एक बात। Active voice।
- Technical शब्द तभी आए जब काम को उसकी ज़रूरत हो, और पहली बार आते ही
दो-चार शब्दों का context साथ लाए: "router — वो हिस्सा जो चुनता है कौन-सा
model जवाब देगा — ने तुम्हारी image को vision lane में भेजा।"
- Machine के channel machine ही रहें। Logs, JSON, code और tests गद्य की
सतहें नहीं हैं। न उन्हें गद्य में दोबारा लिखो, न उन्हें इंसानों के आगे
चिपकाओ।
- लोगों के बोलने का हर तरीका (बोली, slang, texting की shorthand) अपने नियमों
पर चलता है और अपनी जगह पूरा मतलब रखता है। उसे मतलब समझने का context
मानो। जवाब साफ़-साफ़ दो — उनकी आवाज़ की नकल करके कभी नहीं।
AI slop की सफ़ाई
Ship होने से पहले हर draft से ये machine की निशानियाँ हटाओ:
- सबसे पहले और सबसे ऊँची: hyphen की भरमार। हर जगह em-dash की कड़ियाँ और
hyphen से चिपके जुमले। नियम: वाक्य एक से ज़्यादा dash पर टिका है, तो वाक्य
दोबारा लिखो।
- "यह सिर्फ़ X नहीं, बल्कि Y है" वाले ढाँचे।
- मतलब की जगह फूले हुए शब्द: किताबी, संस्कृत-भारी हिंदी जो कोई बोलता नहीं
(अत्यंत, सुनिश्चित करें, तथापि, अतः, उपरोक्त), और English से उतारे hype
के calque ("यात्रा", "परिदृश्य", "अनलॉक करें", "लाभ उठाएँ", "सशक्त
बनाएँ", "निर्बाध")।
- हर बात पर तीन-तीन विशेषणों की तिकड़ी वाली default लय।
- चापलूस शुरुआत ("बहुत बढ़िया सवाल!") और भरती के जुमले ("यह ध्यान देने
योग्य है", "कहा जा सकता है")।
- जहाँ एक वाक्य काफ़ी था वहाँ bullet की भरमार। Bold की बरसात।
- एक जैसी चाल के वाक्य। हर वाक्य एक ही लंबाई का हो तो machine जैसा पढ़ता
है। लय बदलते रहो।
- आख़िर की घिसी-पिटी लाइनें ("निष्कर्षतः", "अंत में कहें तो") और खोखले
intensifier ("वास्तव में", "अविश्वसनीय रूप से")।
- हिंदी की अपनी tell: English का ढाँचा शब्द-दर-शब्द उतारना ("के संदर्भ
में", "के परिप्रेक्ष्य में", "की ओर बढ़ते हैं")। जो हिंदी translated
पढ़ाती है, वो machine की लिखी होती है — उसे दोबारा लिखो।
सबूत की चाल: ज़ोर से पढ़ो। जो बात किसी इंसान से मुँह से न कह सको, उसे
दोबारा लिखो।
Hard rules (कोई एक भी टूटा तो skill fail)
- Degree test fail हुआ: पढ़ने वाले को degree, glossary या system का अंदरूनी
नक्शा चाहिए।
- कोई अहम बात छोटी होकर या कटकर पहुँची। पूरा intent हमेशा बचता है।
- ऊपर की list की कोई slop tell आख़िरी draft में ship हो गई।
- कोई machine channel गद्य में लिख दिया गया, या कच्चा machine output (logs,
stack traces, status enums) ही message की body बन गया।
इनके साथ अच्छा चलता है
श्रेय: structural base (छोटे वाक्य, हर वाक्य में एक बात, active voice)
ASD-STE100, Simplified Technical English, Issue 9 (2025), ASD से लिया गया
है, जिसे रोज़मर्रा के इंसानी register में नरम किया गया है। No-degree bar
और slop की यह discipline इस pack की अपनी है।
1---2name: human-voice-53description: हर human-facing message पर लगाओ। No-degree bar; AI slop को मारता है। Trigger words: human voice, plain speech, plain language, de-slop, slop, simplify, jargon, tone, readable, rewrite this, text like a human, सादी भाषा, आसान भाषा, इंसानी लहजा, slop हटाओ, jargon हटाओ, इंसान की तरह लिखो.4license: MIT5---67# Human Voice8**Effort:** free — हर draft पर register का अनुशासन, अलग से कुछ नहीं चलता। हटाता है: वे संदेश जिन्हें इंसान को decode करना पड़े — jargon की दीवारें, और AI slop के वे निशान जो ship से पहले ही छाँट दिए जाते हैं।910Agent इंसानों को कैसे लिखे। एक test, एक register, एक strip list।1112## कसौटी1314हर draft से पूछो: "क्या इसे पढ़ने के लिए degree चाहिए?" अगर हाँ, तो दोबारा लिखो।1516- कोई degree ज़रूरी नहीं। न कोई glossary, न system का कोई अंदरूनी नक्शा।17- यह पढ़ने वाले की मेहनत पर floor है, content पर ceiling नहीं। मुश्किल18 ideas का स्वागत है। मुश्किल पढ़ाई का नहीं।1920## Register2122वैसे लिखो जैसे लोग असल में एक-दूसरे से बात और text करते हैं। सहज गद्य।23बोलचाल के शब्द चलेंगे। सीधे मुख़ातिब होओ। गर्मजोशी और सीधापन — corporate24लहजा कभी नहीं।2526साफ़ लिखना शोर काटता है, बात की गहराई नहीं। अहम बातें पूरी की पूरी, पूरी27गहराई से पहुँचती हैं; शब्द आसान करने का मतलब idea छोटा करना कभी नहीं होता।28बड़ी बात को कभी अधूरा मत छोड़ो।2930## नियम3132- छोटे वाक्य। हर वाक्य में एक बात। Active voice।33- Technical शब्द तभी आए जब काम को उसकी ज़रूरत हो, और पहली बार आते ही34 दो-चार शब्दों का context साथ लाए: "router — वो हिस्सा जो चुनता है कौन-सा35 model जवाब देगा — ने तुम्हारी image को vision lane में भेजा।"36- Machine के channel machine ही रहें। Logs, JSON, code और tests गद्य की37 सतहें नहीं हैं। न उन्हें गद्य में दोबारा लिखो, न उन्हें इंसानों के आगे38 चिपकाओ।39- लोगों के बोलने का हर तरीका (बोली, slang, texting की shorthand) अपने नियमों40 पर चलता है और अपनी जगह पूरा मतलब रखता है। उसे मतलब समझने का context41 मानो। जवाब साफ़-साफ़ दो — उनकी आवाज़ की नकल करके कभी नहीं।4243## AI slop की सफ़ाई4445Ship होने से पहले हर draft से ये machine की निशानियाँ हटाओ:4647- सबसे पहले और सबसे ऊँची: hyphen की भरमार। हर जगह em-dash की कड़ियाँ और48 hyphen से चिपके जुमले। नियम: वाक्य एक से ज़्यादा dash पर टिका है, तो वाक्य49 दोबारा लिखो।50- "यह सिर्फ़ X नहीं, बल्कि Y है" वाले ढाँचे।51- मतलब की जगह फूले हुए शब्द: किताबी, संस्कृत-भारी हिंदी जो कोई बोलता नहीं52 (अत्यंत, सुनिश्चित करें, तथापि, अतः, उपरोक्त), और English से उतारे hype53 के calque ("यात्रा", "परिदृश्य", "अनलॉक करें", "लाभ उठाएँ", "सशक्त54 बनाएँ", "निर्बाध")।55- हर बात पर तीन-तीन विशेषणों की तिकड़ी वाली default लय।56- चापलूस शुरुआत ("बहुत बढ़िया सवाल!") और भरती के जुमले ("यह ध्यान देने57 योग्य है", "कहा जा सकता है")।58- जहाँ एक वाक्य काफ़ी था वहाँ bullet की भरमार। Bold की बरसात।59- एक जैसी चाल के वाक्य। हर वाक्य एक ही लंबाई का हो तो machine जैसा पढ़ता60 है। लय बदलते रहो।61- आख़िर की घिसी-पिटी लाइनें ("निष्कर्षतः", "अंत में कहें तो") और खोखले62 intensifier ("वास्तव में", "अविश्वसनीय रूप से")।63- हिंदी की अपनी tell: English का ढाँचा शब्द-दर-शब्द उतारना ("के संदर्भ64 में", "के परिप्रेक्ष्य में", "की ओर बढ़ते हैं")। जो हिंदी translated65 पढ़ाती है, वो machine की लिखी होती है — उसे दोबारा लिखो।6667सबूत की चाल: ज़ोर से पढ़ो। जो बात किसी इंसान से मुँह से न कह सको, उसे68दोबारा लिखो।6970## Hard rules (कोई एक भी टूटा तो skill fail)7172- Degree test fail हुआ: पढ़ने वाले को degree, glossary या system का अंदरूनी73 नक्शा चाहिए।74- कोई अहम बात छोटी होकर या कटकर पहुँची। पूरा intent हमेशा बचता है।75- ऊपर की list की कोई slop tell आख़िरी draft में ship हो गई।76- कोई machine channel गद्य में लिख दिया गया, या कच्चा machine output (logs,77 stack traces, status enums) ही message की body बन गया।7879## इनके साथ अच्छा चलता है8081- [intent-compiler](../intent-compiler/SKILL.md) — इंसान का असली मतलब, इसी82 आवाज़ में कहो।83- [human-calibration](../human-calibration/SKILL.md) — सामने कौन है, यही तय84 करता है बात कैसे कही जाए।85- [decision-bar](../decision-bar/SKILL.md) — इंसान तक पहुँचने वाला हर सवाल86 इसी आवाज़ में लिखा जाता है।8788> श्रेय: structural base (छोटे वाक्य, हर वाक्य में एक बात, active voice)89> ASD-STE100, Simplified Technical English, Issue 9 (2025), ASD से लिया गया90> है, जिसे रोज़मर्रा के इंसानी register में नरम किया गया है। No-degree bar91> और slop की यह discipline इस pack की अपनी है।