Skip to content
Apothem
अभिशासन

स्थिति-निर्धारण

Apothem को पंद्रह मैंडेट, कैनोनिकल-चैनल इनपुट अनुशासन और सहायक-चालित कार्य के लिए संज्ञानात्मक-पहचान रचनात्मक वास्तुकला वाले आर्टिफ़ैक्ट-अनुसमर्थन शासन के रूप में समझें।

लक्षित पाठक: वे मूल्यांकनकर्ता जो तय कर रहे हैं कि उत्पादन-स्तर के सहायक-चालित कार्य के लिए apothem को अपनाएँ या नहीं। लंबाई: शुरू से अंत तक पढ़ने में ~12 मिनट। अनुभाग-दर-अनुभाग सरसरी तौर पर पढ़ा जा सकता है। उद्देश्य: यह स्पष्ट करना कि apothem वास्तव में क्या है, क्या नहीं है, और "यह परियोजना क्या वितरित करती है?" इस प्रश्न का उत्तर अधिकांश शासन-टूलिंग परियोजनाओं द्वारा दिए जाने वाले उत्तर से संरचनात्मक रूप से भिन्न क्यों है।


§1. थीसिस

apothem एक बाइनरी के रूप में पैकेज किया गया आर्टिफ़ैक्ट-अनुसमर्थन शासन है।

सहायक टूलिंग का परंपरागत ढाँचा प्रॉम्प्ट-ट्यूनिंग है: एक सिस्टम प्रॉम्प्ट, एक मॉडल का चयन, एक कॉन्टेक्स्ट-विंडो रणनीति, स्लैश-कमांडों का एक छोटा संग्रह, और प्रॉम्प्ट-इंजीनियरिंग की लोककथाओं का ढेर। उस ढाँचे में ऑपरेटर का लीवरेज बिंदु वह गद्य है जो वह मॉडल को सौंपता है। जब मॉडल गलत व्यवहार करता है, तो उपचार यह है कि गद्य संपादित किया जाए। परियोजना जो आर्टिफ़ैक्ट वितरित करती है, वह प्रॉम्प्ट का सेट है।

apothem उस ढाँचे को अस्वीकार करता है।

किसी वास्तविक परियोजना के विरुद्ध काम करने वाले सहायक का लीवरेज बिंदु वह गद्य नहीं है जो ऑपरेटर मॉडल को सौंपता है — वह आर्टिफ़ैक्ट है जिसे मॉडल उत्सर्जित करने वाला है। वह आर्टिफ़ैक्ट किसी वर्कस्पेस में उतरेगा, कमिट होगा, समीक्षित होगा, मर्ज होगा, परिनियोजित होगा, डाउनस्ट्रीम आर्टिफ़ैक्टों द्वारा उद्धृत होगा, और भावी योगदानकर्ताओं को विरासत में मिलेगा। उसकी गुणवत्ता एक डाउनस्ट्रीम-अपरिवर्तनीय गुण है जिसे प्रॉम्प्ट पूर्वव्यापी रूप से ठीक नहीं कर सकता। किसी विकृत कमिट के उतर जाने के बाद प्रॉम्प्ट संपादित करना ऑपरेटर पर लगा एक कर है, आर्टिफ़ैक्ट की पुनर्प्राप्ति नहीं।

यह परियोजना जिस अनुशासन को कूटबद्ध करती है, वह व्युत्क्रमण है: हर उत्सर्जन सहायक के हाथ से निकलने से पहले एक संरचित, सहमत, यांत्रिक रूप से जाँचे जाने वाले गेट से गुज़रता है। गेट पंद्रह मैंडेट लागू करता है, जो होस्ट-डिस्कवरी, प्रकटीकरण, दस गुणवत्ता आयाम, स्व-अनुप्रयोग, प्राधिकार स्वच्छता, विशेषज्ञता समावेशन, विकल्प-एनोटेशन, निश्चितता, दृश्य लीवरेज, द्विदिश आबंधन, एजाइल स्प्रिंट तंत्र, कैनोनिकल लेआउट, कोड शिल्प, प्रणालीगत सहभागिता और उत्पादन-तत्परता तक फैले हैं। हर मैंडेट एक नियम है, जिसका पथ-फ़िल्टर्ड दायरा होता है और एक मुख्य भाग होता है जो किसी विशिष्ट विफलता वर्ग को व्यवहार में लागू करता है। गेट की हर विफलता एक संरचनात्मक निष्कर्ष है जिसे सहायक सामने रखता है — कभी मौन गिरावट नहीं।

नियम-कॉर्पस ही उत्पाद है। बाइनरी apothem उसकी पैकेजिंग है — एक वितरण सतह जो कॉर्पस को हर ऑपरेटर के उपयोगकर्ता-कॉन्फ़िग रूट तक पहुँचाती है और उसे सहायक की संचालन-मुद्रा के रूप में पंजीकृत करती है। पैकेजिंग बदली जा सकती है; कॉर्पस लॉन्ग-टेल परिसंपत्ति है।

जो परियोजना apothem अपनाती है, वह कोई प्रॉम्प्ट नहीं अपनाती। वह एक शासन व्यवस्था अपनाती है। होस्ट रिपॉज़िटरी में सहायक जो भी आर्टिफ़ैक्ट उत्सर्जित करता है — कोड, टेस्ट, कॉन्फ़िगरेशन, स्कीमा, दस्तावेज़ीकरण, रनबुक, कमिट संदेश, ब्रांच नाम — वह पंद्रह-बार की उसी न्यूनतम सीमा को पूरा करता है। ऑपरेटर का लीवरेज बिंदु "मुझे सहायक से क्या कहना चाहिए?" से हटकर "कौन-से मैंडेट इस उत्सर्जन को बाँधते हैं, और गेट को किस साक्ष्य की आवश्यकता है?" पर आ जाता है। यह बदलाव संरचनात्मक है, शैलीगत नहीं।

यह दस्तावेज़ स्पष्ट करता है कि कॉर्पस ही भार-वहन करने वाली परिसंपत्ति क्यों है, पंद्रह मैंडेट को उनके नियम-फ़ाइल एंकरों के साथ क्रम से देखता है, और उन दो क्रॉस-कटिंग अनुशासनों (कैनोनिकल-चैनल इनपुट प्रबंधन और संज्ञानात्मक-पहचान रचनात्मक वास्तुकला) को सामने रखता है जो कॉर्पस को एक सुसंगत संपूर्ण में बाँधते हैं।


§2. तीन-स्तंभ वास्तुकला

कॉर्पस तीन स्तंभों पर टिका है। प्रत्येक स्तंभ अपनी कैनोनिकल विशिष्टता वाली, अलग की जा सकने वाली सतह है; प्रत्येक स्तंभ बाकी दो को सुदृढ़ करता है।

स्तंभ A — मैंडेट रजिस्ट्री (M1–M15 + CM-1..CM-28)

मैंडेट रजिस्ट्री बाह्य-अक्ष की शासन सतह है। M1–M15 सहायक द्वारा किसी होस्ट परियोजना में बनाए गए हर आर्टिफ़ैक्ट को नियंत्रित करते हैं: होस्ट-डिस्कवरी, प्रकटीकरण, दस गुणवत्ता आयाम, स्व-अनुप्रयोग, प्राधिकार, विशेषज्ञता, विकल्प एनोटेशन, निश्चितता, दृश्य लीवरेज, द्विदिश आबंधन, एजाइल स्प्रिंट, कैनोनिकल लेआउट, कोड शिल्प, प्रणालीगत सहभागिता और उत्पादन-तत्परता। रजिस्ट्री को पंद्रह-मैंडेट रजिस्ट्री के रूप में कैनोनिकल बनाया गया है और नीचे §3 में गिनाई गई नियम फ़ाइलों द्वारा व्यवहार में लागू किया गया है।

CM-1..CM-28 आंतरिक-अक्ष के समकक्ष हैं — संचालनात्मक मैंडेट जो सहायक के अंतःक्रिया अनुशासन को नियंत्रित करते हैं (आलोचनात्मक मूल्यांकन, शून्य धारणाएँ, लागू करने से पहले खोज, सर्वोत्तम-समाधान मूल्यांकन, निर्मम ईमानदारी, निर्णय गति, अड़चन-प्रथम फ़ोकस, सुसंगत उत्पाद, और योजना-स्थानीयता, संदर्भ प्रबंधन, सौंपे गए कार्य के ऑर्केस्ट्रेशन, बड़ी-फ़ाइल जनरेशन और स्मृति जीवनचक्र को कवर करने वाली बीस और प्रविष्टियाँ)। आंतरिक अक्ष operational-mandates नियम और site/content/docs/governance/cross-cutting-mandates.mdx में कैनोनिकल बनाया गया है।

प्रत्येक उत्सर्जन दोनों अक्षों से गुज़रता है। src/apothem/rules/pre-emission-gate.md पर गेट प्रति उत्सर्जन पंद्रह यांत्रिक और तर्क-आधारित बार चलाता है और आर्टिफ़ैक्ट के कार्य-निशान में एक सत्यापन ब्लॉक दर्ज करता है।

स्तंभ B — कैनोनिकल-चैनल अनुशासन

कैनोनिकल-चैनल अनुशासन यह बाँधता है कि सहायक ऑपरेटर से इनपुट कैसे माँगता है। फ़्री-फ़ॉर्म प्रॉम्प्ट पूरे इकोसिस्टम में बंद कर दिए गए हैं; हर चुनाव संरचित-पूछताछ चैनल से होकर जाता है, जिसमें एक संरचित विकल्प-एनोटेशन स्कीमा (प्रति विकल्प rationale + recommendation + default-pointer), एक बंद अनुशंसा वर्गीकरण, प्रति-फ़ाइल विनाशकारी-ऑपरेशन पुष्टि की न्यूनतम सीमा, और एक ह्यूरिस्टिक स्वीप है जो हर शासित सतह पर वार्तालापीय-प्रॉम्प्ट विचलन को पकड़ता है। पूर्ण विशिष्टता src/apothem/rules/interactive-questions.md पर है, जिसकी गहराई पथ-फ़िल्टर्ड सहचर फ़ाइलों src/apothem/rules/interactive-questions-canonical-shapes.md और src/apothem/rules/interactive-questions-sweep-matchers.md में है।

अनुशासन का लीवरेज निर्णय की अंकेक्षणीयता है। ऑपरेटर-इच्छाधीन हर चुनाव वह साक्ष्य साथ रखता है जिस पर सहायक ने विचार किया, वह अनुशंसा जो सहायक ने जारी की, और ठोस चालकों पर आधारित तर्क। चुनाव के छह महीने बाद, प्रकटीकरण लेजर पढ़ने वाला अंकेक्षक ऑपरेटर की स्मृति से पूछे बिना निर्णय की सीमा का पुनर्निर्माण कर सकता है।

स्तंभ C — संज्ञानात्मक-पहचान वर्गीकरण

संज्ञानात्मक-पहचान वर्गीकरण यह बाँधता है कि सहायक कैसे सोचता है। पाँच क्रमिक संज्ञानात्मक फ़िल्टर (स्पष्ट का परिशोधन, डोमेन निर्वासन, व्युत्क्रमण दबाव, संयोजनात्मक विस्फोट, सौंदर्यात्मक माँग) एक रचनात्मक लय बनाते हैं। पहला और अंतिम फ़िल्टर हर सारवान आउटपुट पर लागू होते हैं; बीच के तीन फ़िल्टर गैर-तुच्छ निर्णयों पर लागू होते हैं। छह विचार-निर्माण तकनीकें (ऐतिहासिक तोड़फोड़कर्ता, बाधा विरोधाभास, सजीव तंत्र दृष्टि, द्वितीय-क्रम कथा, खलनायक फ़्रेम, 100-वर्ष ज़ूम) तब पहचान-संकेतों पर सक्रिय होती हैं जब मानक उपागम ने असंतोषजनक परिणाम दिया हो। विस्तार के सात अक्ष (आर्किटेक्चर, समवर्तीता, प्रदर्शन, सुरक्षा, परीक्षण, टूलिंग, अवलोकनीयता) वह गहराई सतह बनाते हैं जिसके विरुद्ध हर गैर-तुच्छ निर्णय प्रमाणित होता है। पूर्ण विशिष्टता src/apothem/rules/cognitive-identity.md पर है, जिसकी गहराई पथ-फ़िल्टर्ड सहचर फ़ाइल src/apothem/rules/cognitive-identity-techniques.md में है।

वर्गीकरण का लीवरेज संरचनात्मक नवीनता है। स्पष्ट का परिशोधन फ़िल्टर उस पहले-विचार वाले उत्तर को त्याग देता है जिस तक हर कोई पहुँचता है; व्युत्क्रमण दबाव माँग करता है कि कम से कम एक उलटी धारणा अंतिम आउटपुट तक बची रहे; सौंदर्यात्मक माँग कार्यात्मक पर यादगार न बन पाने वाले रूपों को अस्वीकार करती है। परिणाम एक ऐसा सहायक है जो ऐसे आउटपुट बनाता है जिन्हें ऑपरेटर रुककर दोबारा पढ़ते हैं — इसलिए नहीं कि गद्य सजाया गया है, बल्कि इसलिए कि संरचनात्मक चुनाव इस तरह अप्रत्याशित है कि एक बार दिख जाने पर अपरिहार्य लगता है।

स्तंभ एक-दूसरे को कैसे सुदृढ़ करते हैं

तीनों स्तंभ परस्पर भार-वहन करने वाले हैं। मैंडेट रजिस्ट्री (स्तंभ A) परिभाषित करती है कि आर्टिफ़ैक्ट को क्या संतुष्ट करना चाहिए। कैनोनिकल-चैनल अनुशासन (स्तंभ B) परिभाषित करता है कि ऑपरेटर का इनपुट उस निर्णय सतह में कैसे प्रवेश करता है जो आर्टिफ़ैक्ट को जन्म देती है। संज्ञानात्मक-पहचान वर्गीकरण (स्तंभ C) उस रचनात्मक लय को परिभाषित करता है जो आर्टिफ़ैक्ट को उसका आकार देती है। किसी एक स्तंभ को हटाने से बाकी दो ढह जाते हैं: कैनोनिकल चैनल के बिना रजिस्ट्री ऐसे आर्टिफ़ैक्ट देती है जो मौन रूप से डिफ़ॉल्ट किए गए होते हैं, अनुरूप दिखते हैं पर संरचनात्मक निर्णयों को छिपाते हैं; संज्ञानात्मक गहराई के बिना कैनोनिकल चैनल सही मार्ग से आए पर सामान्य आकार के आउटपुट देता है; रजिस्ट्री के बिना संज्ञानात्मक लय सौंदर्य की दृष्टि से सुघड़ आर्टिफ़ैक्ट देती है जो होस्ट परियोजना में एकीकृत होने में विफल रहते हैं।


§3. मैंडेट रजिस्ट्री वॉकथ्रू

पंद्रह-मैंडेट रजिस्ट्री कैनोनिकल बाह्य-अक्ष शासन सतह है। नीचे का प्रत्येक उपअनुभाग मैंडेट, उसके संचालन दायरे और उस नियम फ़ाइल का नाम देता है जो कैनोनिकल विशिष्टता रखती है। प्रत्येक नियम फ़ाइल उन आर्टिफ़ैक्ट वर्गों तक पथ-फ़िल्टर्ड है जिन्हें वह नियंत्रित करती है, और जब वे वर्ग छुए जाते हैं तब सहायक के संचालन संदर्भ में माँग पर लोड होती है।

M1 — होस्ट-परियोजना अज्ञेयता एवं परिपाटी डिस्कवरी

दायरा। सहायक होस्ट परियोजना में जो कुछ भी बनाता है, वह इससे आकार लेता है कि होस्ट परियोजना पहले से क्या है — उसका स्टैक, भाषा, फ़्रेमवर्क, टूलचेन, फ़ॉर्मैटर, लिंटर, टेस्ट फ़्रेमवर्क, दस्तावेज़ीकरण जनरेटर, ब्रांच रणनीति, कमिट-संदेश परिपाटी, लेआउट, नामकरण, निर्भरता-पिनिंग नीति। इनमें से हर एक होस्ट के आधिकारिक सत्य-स्रोत (मैनिफ़ेस्ट, लॉक फ़ाइलें, समान प्रकार की सहोदर फ़ाइलें, रिपॉज़िटरी-स्तरीय परिपाटी दस्तावेज़) से खोजा जाता है और उसका सम्मान किया जाता है। जहाँ होस्ट ऐसी परिपाटी पर मौन है जिसे सहायक को अपनाना ही है, वहाँ वह मौन M5 के अंतर्गत आधिकारिक पूछताछ के रूप में सामने आता है — किसी आंतरिक डिफ़ॉल्ट को चुपचाप चुनकर कभी हल नहीं किया जाता।

कैनोनिकल विशिष्टता। src/apothem/rules/host-discovery.md (प्रति-भाषा मैनिफ़ेस्ट सूची src/apothem/rules/host-discovery-manifests.md पर)।

यह क्यों मायने रखता है। सहायक का उत्सर्जन उससे अप्रभेद्य है जो होस्ट परियोजना का कोई लंबे कार्यकाल वाला योगदानकर्ता लिखता। परिपाटी विचलन एक संरचनात्मक विफलता है, शैलीगत वरीयता नहीं।

M2 — संपादकीय अनुशासन एवं प्रकट संशोधन

दायरा। सार्थक दायरे वाला प्रत्येक परिवर्तन एक स्पष्ट प्रकटीकरण लेजर रखता है — क्या माँगा गया, क्या संशोधित हुआ, क्या विस्तारित हुआ, क्या परिष्कृत हुआ, क्या स्थगित हुआ। मौन अति-अनुपालन ("जो माँगा गया ठीक वही किया, भले ही वह गलत था") और मौन अति-विस्तार ("बिना बताए परिवर्तन का दायरा बढ़ा दिया") दोनों विफलताएँ हैं। प्रत्येक संशोधन विद्वत्तापूर्ण / तकनीकी स्तर का तर्क रखता है (उद्धृत संदर्भ, RFC, वेंडर दस्तावेज़, सहोदर-फ़ाइल की मिसाल, साहित्य से लिया गया नामित पैटर्न)।

कैनोनिकल विशिष्टता। src/apothem/rules/disclosure-ledger.md (मार्कर-वर्ग सूची src/apothem/rules/disclosure-ledger-markers.md पर)।

यह क्यों मायने रखता है। कोई diff जो माँगे गए परिवर्तन को लागू करते हुए चुपचाप किसी आसन्न बग को भी ठीक कर देता है, वह अप्रकट संशोधन है। छह महीने बाद कोई समीक्षक जानबूझकर किए गए सुधार को विचलन से अलग नहीं कर सकता। लेजर अंकेक्षण-और-पुनर्प्राप्ति सतह है।

M3 — दस गुणवत्ता आयाम

दायरा। प्रत्येक आर्टिफ़ैक्ट उत्सर्जन से पहले दस गुणवत्ता आयामों के विरुद्ध मूल्यांकित होता है: वैज्ञानिक कठोरता, संगति / सुसंगति / एकीकरण / वैधता, कॉन्फ़िगर-योग्यता / अनावश्यकता-रहितता / समेकन, पठनीयता / सहज-बोधगम्यता / स्वच्छता, अनाथता / बासीपन, संरचनात्मकता / प्रणालीगतता / एकरूपता / व्यापकता, आर्किटेक्चर, नामकरण एकरूपता, विद्वत्तापूर्ण / तकनीकी संदर्भण, और उदाहरण / टेस्ट / डॉकस्ट्रिंग / दस्तावेज़ीकरण। एक ही आर्टिफ़ैक्ट का कई आयामों में विफल होना गुणनात्मक है, योगात्मक नहीं — जो आर्टिफ़ैक्ट बासी भी है, अनाथ भी, असंगत रूप से नामित भी और अदस्तावेज़ी भी, वह वापस लिए जाने का उम्मीदवार है, मरम्मत का नहीं।

कैनोनिकल विशिष्टता। src/apothem/rules/ten-dimension-check.md (प्रति-आयाम मुख्य भाग src/apothem/rules/ten-dimension-check-dimensions.md पर)।

यह क्यों मायने रखता है। गुणवत्ता को घटकों में बाँटा जा सकता है। दस आयामों को नाम देने से हर एक को अलग से अंकेक्षित और सामने रखा जा सकता है; अस्पष्ट "यह कमज़ोर लगता है" जैसे निष्कर्ष विशिष्ट "आयाम 5 बासीपन: पंक्ति 42 का संदर्भ स्थानांतरित की गई फ़ाइल की ओर इशारा करता है" बन जाते हैं।

M4 — स्व-अनुप्रयोग — प्री-एमिशन गेट

दायरा। प्रत्येक आर्टिफ़ैक्ट उत्सर्जन से पहले पंद्रह-बार प्री-एमिशन गेट से गुज़रता है। यांत्रिक बार (M5, M7, M8, M10, M13) src/apothem/conformity/gate.py द्वारा व्यवस्थित src/apothem/conformity/*-grep.py पर निष्पादन-योग्य मैचर रखते हैं। बार M3, M9, M12, M14 और M15 आंशिक रूप से यांत्रिक हैं: निष्पादन-योग्य मैचर हर बार के एक हिस्से को कवर करते हैं और शेष का मूल्यांकन कार्यरत सहायक करता है। तर्क-आधारित बार (M1, M2, M4, M6, M11) का कोई मैचर नहीं है; उनका मूल्यांकन कार्यरत सहायक करता है और सत्यापन ब्लॉक में दर्ज किया जाता है। स्वयं बार M4 जाँचता है कि सत्यापन ब्लॉक आर्टिफ़ैक्ट के कार्य-निशान में मौजूद है। किसी एक बार की विफलता उत्सर्जन को अवरुद्ध करती है; हर बार के उत्तीर्ण होने तक पुनरावृत्ति जारी रहती है।

कैनोनिकल विशिष्टता। src/apothem/rules/pre-emission-gate.md (पूर्ण बार तालिका src/apothem/rules/pre-emission-gate-bars.md पर)।

यह क्यों मायने रखता है। गुणवत्ता प्री-एमिशन का सरोकार है, डाउनस्ट्रीम के "उपयोगकर्ता संशोधित कर सकता है" वाले सरोकार का नहीं। गेट उस दृढ़ विश्वास का यांत्रिक प्रवर्तन में संरचनात्मक अनुवाद है।

M5 — प्राधिकार सिद्धांत (पूछें, आविष्कार न करें)

दायरा। नाम, ईमेल, हैंडल, होस्टनेम, संगठन, टेनेंट, एंडपॉइंट, क्रेडेंशियल, दायरे की दिशा, होस्ट द्वारा अभी तय न किए गए नामकरण विकल्प, प्रतिधारण नीतियाँ, होस्ट-परिवर्तनीय सतहों पर संस्करण पिन, और वे अवसंरचना निर्णय जो उपयोगकर्ता ने घोषित नहीं किए — इनमें से कुछ भी गढ़ा नहीं जाता। हर एक या तो होस्ट में किसी आधिकारिक सत्य-स्रोत से खोजा जाता है (M1 का डिस्कवरी अर्ध) या उपयोगकर्ता से पूछा जाता है (M5 का पूछताछ अर्ध) — कभी किसी विश्वसनीय-से दिखने वाले अनुमान से ढका नहीं जाता।

कैनोनिकल विशिष्टता। src/apothem/rules/authority-inquiry.md (सात-श्रेणी सूची src/apothem/rules/authority-inquiry-categories.md पर)।

यह क्यों मायने रखता है। पहचान, सुरक्षा, दायरे की दिशा और सार्वजनिक-सतह के नामकरण का कानूनी और अंकेक्षण-संबंधी वज़न होता है। अनुमान से लिखा गया संपर्क पता, गढ़ा गया CODEOWNERS हैंडल, या आविष्कृत रिलीज़-हस्ताक्षर एंडपॉइंट डाउनस्ट्रीम में ऐसी सफ़ाई का काम पैदा करता है जिसकी लागत पूछताछ की लागत से परिमाण के कई क्रम अधिक होती है।

M6 — विशेषज्ञता समावेशन

दायरा। प्रत्येक सार्थक-दायरे वाला आर्टिफ़ैक्ट शाब्दिक पाठ से पहले उपयोगकर्ता के आशय को पढ़ता है, जब शाब्दिक अनुरोध एक ज्ञात दोष छोड़ देता हो तब सक्रिय रूप से संशोधन करता है, आसन्न अंतरालों पर विस्तार करता है, उद्धृत तर्क के साथ परिष्कृत करता है, द्वितीय-क्रम परिणामों का पूर्वानुमान करता है, कार्य के अनुसार गहराई को समायोजित करता है, और आसन्न डोमेन से सबक लाता है — हर संशोधन को M2 लेजर के माध्यम से प्रकट करते हुए।

कैनोनिकल विशिष्टता। src/apothem/rules/expertise-posture.md (सात उप-तत्वों + अंशांकन सीढ़ी के साथ src/apothem/rules/expertise-posture-elements.md पर)।

यह क्यों मायने रखता है। प्रकटीकरण के बिना विशेषज्ञता मौन ओवरराइड है। प्रकटीकरण के साथ विशेषज्ञता लीवरेज है — ऑपरेटर संशोधन देखता है, तर्क का मूल्यांकन करता है, और या तो उसका अनुसमर्थन करता है या उसे पलट देता है। सहायक एक वरिष्ठ योगदानकर्ता की तरह काम करता है जिसका निर्णय अंकेक्षणीय है, ऑपरेटर के आशय के किसी अपारदर्शी विकल्प की तरह नहीं।

M7 — विकल्प-एनोटेशन अनुशासन

दायरा। सहायक द्वारा सामने रखा गया हर बहु-विकल्प चयन — गद्य उत्तरों, ADR, README अनुभागों, PR विवरणों, डिज़ाइन दस्तावेज़ों, रनबुक चरणों, कोड टिप्पणियों, कमिट-संदेश मुख्य भागों, RFC में — अनुशंसित विकल्प पर कैनोनिकल अनुशंसित-चिह्न और सिद्धांत से जुड़ा तर्क रखता है। आधिकारिक क्षेत्र में मौन चयन और एनोटेशन-रहित विकल्प सूचियाँ निषिद्ध हैं।

कैनोनिकल विशिष्टता। src/apothem/rules/option-annotation.md (गद्य-और-दस्तावेज़ रूप src/apothem/rules/option-annotation-form.md पर)।

यह क्यों मायने रखता है। हर रचा गया विकल्प सेट एक अंकेक्षण सतह है। पाठक केवल चयन नहीं, बल्कि विकल्पों का दायरा, अनुशंसा और उसके पीछे का ठोस चालक भी देखता है। वही अनुशासन सहायक के संरचित-पूछताछ आह्वानों और स्थायी आर्टिफ़ैक्टों में लिखे गद्य, दोनों को बाँधता है।

M8 — निश्चितता, अभेद्यता, और कठोर-प्रणाली गुणों का परिवार

दायरा। प्रत्येक कथन निश्चित है (जहाँ बाध्यकारी निर्देश संभव है वहाँ कोई हेजिंग नहीं) और अभेद्य है (घोषित डोमेन में कोई अंतराल नहीं, कोई ऐसी खामी नहीं जहाँ शाब्दिक पालन आशय का उल्लंघन कर दे, कोई अकथित धारणा नहीं, कोई वरीयता-टाई नहीं, कोई मौन फ़ॉलबैक नहीं)। हेजिंग-शब्दावली की सूची गेट पर यांत्रिक रूप से पहचानी जाती है; निर्देशात्मक गद्य में हर घटना तीन में से एक मार्ग पर हल होती है — शर्तों के नाम के साथ बिना शर्त में पदोन्नत करें, शाखाओं की गणना के साथ स्पष्ट सशर्त में पदावनत करें, या हटाएँ और चयन को पूछताछ सतह पर भेजें।

कैनोनिकल विशिष्टता। src/apothem/rules/definitiveness.md (सात-गुण सूची src/apothem/rules/definitiveness-virtues.md पर)।

यह क्यों मायने रखता है। हेजिंग-युक्त निर्देशात्मक गद्य हर पाठक पर कर है। पाठक नहीं बता सकता कि हेज किसी वास्तविक शर्त को मान रहा है या लेखक की अनिश्चितता का संकेत दे रहा है। अनुशासन लेखक को शर्त का नाम बताने या निर्देश हटाने के लिए बाध्य करता है — पाठक को दोनों स्थितियों में एक बाध्यकारी कथन मिलता है।

M9 — दृश्य लीवरेज

दायरा। जहाँ विषय-वस्तु संरचनात्मक है — आर्किटेक्चर, नियंत्रण प्रवाह, डेटा प्रवाह, निर्भरता ग्राफ़, स्टेट मशीन, अनुक्रम, निर्णय वृक्ष, पदानुक्रम, वरीयता स्टैक, जीवनचक्र, अनुमति मैट्रिक्स — वहाँ आर्टिफ़ैक्ट गद्य के साथ एक डायग्राम भी रखता है। Markdown-केंद्रित कॉर्पस के लिए Mermaid अनुशंसित डिफ़ॉल्ट है; M1 डिस्कवरी के अनुसार होस्ट का मौजूदा संकेतन माना जाता है। हर डायग्राम प्रोवेनेंस, सत्यापन तिथि, और उस आर्टिफ़ैक्ट से वापस एक आबंधन रखता है जिसका वह सार प्रस्तुत करता है।

कैनोनिकल विशिष्टता। src/apothem/rules/visual-leverage.md।

यह क्यों मायने रखता है। बिना किसी डायग्राम के दो-हज़ार-शब्दों का आर्किटेक्चर वर्णन माध्यम का व्यवस्थित अल्प-उपयोग और आर्टिफ़ैक्ट की संरचनात्मक विफलता है, शैलीगत वरीयता नहीं। स्थानिक संबंध रैखिक गद्य में पढ़े नहीं जा सकते; डायग्राम समान-स्तरीय प्रथम-श्रेणी आउटपुट है, सजावट नहीं।

M10 — द्विदिश आबंधन एवं चरण-निष्पादन थ्रेडिंग

दायरा। प्रत्येक सारवान संरचनात्मक तत्व कैनोनिकल पाँच-दिशा संकेतन में अपने समकक्षों के प्रति पारस्परिक आबंधन रखता है: Drives → / Driven by ← / Satisfies → / Established by ↑ / Cross-bound with ↔। एक दिशा में घोषित हर आबंधन के दूसरे सिरे पर पारस्परिक बैक-पॉइंटर होता है; अर्ध-किनारे संरचनात्मक विफलताएँ हैं, सौंदर्य-संबंधी वरीयताएँ नहीं। src/apothem/conformity/binding_reciprocity_grep.py पर एक यांत्रिक पारस्परिकता-grep गेट पर इस अपरिवर्तनीय शर्त को लागू करता है।

कैनोनिकल विशिष्टता। src/apothem/rules/bidirectional-binding.md।

यह क्यों मायने रखता है। पारस्परिक आबंधन कॉर्पस को एक नौगम्य ग्राफ़ में बदल देते हैं। किसी भी नियम की Cross-bound with ↔ पंक्ति उस हर समकक्ष की ओर इशारा करती है जो उसे उद्धृत करता है, और हर उद्धृत समकक्ष वापस इशारा करता है। कॉर्पस का पुनर्गठन यांत्रिक हो जाता है — किसी नियम का नाम बदलें, तो पारस्परिकता-grep उसी चेंज-सेट में हर बासी उद्धरण को चिह्नित कर देता है।

M11 — एजाइल स्प्रिंट एवं अनुभवजन्य प्रक्रिया नियंत्रण

दायरा। गैर-तुच्छ बहु-चरण कार्य अनुशासित एजाइल स्प्रिंट के रूप में चलता है, जिसमें सात कैनोनिकल तत्व होते हैं: स्प्रिंट लक्ष्य (परिणाम-आधारित, परीक्षण-योग्य), स्प्रिंट बैकलॉग (INVEST-आकार का, प्राथमिकता-क्रमित), तत्परता की परिभाषा (स्प्रिंट-प्रवेश गेट), पूर्णता की परिभाषा (स्प्रिंट-निकास गेट), स्प्रिंट रिव्यू (प्रति आइटम स्वीकृत / अस्वीकृत / आगे बढ़ाया गया), स्प्रिंट रेट्रोस्पेक्टिव (जारी रखें / रोकें / शुरू करें), वेलॉसिटी ट्रैकिंग (संकेत, कभी लक्ष्य नहीं)। अनुभवजन्य प्रक्रिया नियंत्रण के तीन स्तंभ — पारदर्शिता, निरीक्षण, अनुकूलन — पूरे समय संचालित रहते हैं।

कैनोनिकल विशिष्टता। src/apothem/rules/agile-sprints.md (तत्व मुख्य भाग src/apothem/rules/agile-sprints-elements.md पर)।

यह क्यों मायने रखता है। बिना स्प्रिंट संरचना का थोक बहु-दिवसीय diff समीक्षा के लिए अपारदर्शी होता है। यह तंत्र हर वृद्धि, हर स्वीकृति मानदंड और हर अस्वीकृति को उसी क्षण सामने ला देता है जब वह घटित होती है — किसी ऐसे रेट्रोस्पेक्टिव तक टाला नहीं जाता जो संरचनात्मक निर्णय के अपरिवर्तनीय हो जाने के बहुत बाद आता है।

M12 — रिपोर्टिंग स्तर एवं उत्पन्न आउटपुट का कैनोनिकल लेआउट

दायरा। गैर-तुच्छ बहु-चरण कार्य दो-स्तरीय रिपोर्टिंग उत्सर्जित करता है: कार्य स्तर पर प्रति-उप-चरण रिपोर्ट और समीक्षा स्तर पर चरण-स्तरीय रोलअप, जो सीधे जोड़ने की बजाय समुच्चयित करता है — उप-चरणों में एकसमान टेम्पलेट, समुच्चयित मेट्रिक्स, सामने लाए गए पैटर्न, चरण-स्तरीय स्व-जाँच, बाह्य घोषणाएँ। उत्पन्न आउटपुट पूर्वानुमेय, होस्ट द्वारा खोजे गए कैनोनिकल स्थानों पर प्रोवेनेंस और पारस्परिक क्रॉस-रेफ़रेंस के साथ रखे जाते हैं। अनाथ आउटपुट (वे आर्टिफ़ैक्ट जिनका कोई उपभोक्ता / कोई इंडेक्स प्रविष्टि / कोई उत्पादक-उल्लेख नहीं) संरचनात्मक विफलताएँ हैं।

कैनोनिकल विशिष्टता। src/apothem/rules/canonical-layout.md (रिपोर्टिंग-स्तर मुख्य भाग src/apothem/rules/canonical-layout-reporting-tiers.md पर)।

यह क्यों मायने रखता है। एड-हॉक स्थानों पर report1.md / report2.md की सपाट सूची छह सप्ताह बाद पढ़ने लायक नहीं रहती। दो-स्तरीय अनुशासन और होस्ट-कैनोनिकल लेआउट का अर्थ है कि हर आउटपुट खोजा जा सकता है, हर उपभोक्ता का नाम दर्ज है, और हर उत्पादक की पहचान की जा सकती है।

M13 — कोड शिल्प परिपाटियाँ

दायरा। प्रत्येक कोड आर्टिफ़ैक्ट ग्यारह उप-तत्व पूरे करता है: क्यों-न-कि-क्या टिप्पणी, आशय प्रकट करने वाला नामकरण, विशिष्ट-अपवाद हैंडलिंग, एकल-उत्तरदायित्व की ओर झुकाव के साथ फ़ंक्शन और मॉड्यूल डिज़ाइन, सुविचारित लॉगिंग स्तर, व्यवहार का वर्णन करने वाले परीक्षण, फ़ॉर्मैटर / लिंटर / टाइप-चेकर का साफ़ उत्तीर्ण होना, सुरक्षा-सचेत कोड (कोई हार्डकोडेड सीक्रेट नहीं, कोई शेल इंजेक्शन नहीं, कोई असुरक्षित डीसीरियलाइज़ेशन नहीं), समवर्तीता अनुशासन, अव्याख्यायित संख्यात्मक लिटरल का नामित-स्थिरांक द्वारा उन्मूलन, और दस्तावेज़ीकरण सतह का कवरेज। प्रति-भाषा सहोदर नियम भाषा-विशिष्ट मूर्त रूप देते हैं।

कैनोनिकल विशिष्टता। src/apothem/rules/code-craft-conventions.md (सार्वभौमिक-प्रत्यायोजन स्टब) तथा प्रति-भाषा सहोदर नियम src/apothem/rules/code-craft-python.md, src/apothem/rules/code-craft-shell.md, और src/apothem/rules/code-craft-markdown.md।

यह क्यों मायने रखता है। कोड-शिल्प का विचलन संचित होता है। एक अकेला नंगा अपवाद हैंडलर वह मिसाल बन जाता है जिसे अगला योगदानकर्ता उद्धृत करता है; एक हार्डकोडेड सीक्रेट वह परिपाटी बन जाता है जिसे टीम स्वीकार कर लेती है; एक अव्याख्यायित लिटरल एक दर्जन बन जाता है। ग्यारह उप-तत्व विफलता वर्गों को नाम देते हैं और गेट उन्हें प्रति उत्सर्जन लागू करता है।

M14 — होस्ट परियोजना में इकोसिस्टम प्रणालीगतता

दायरा। प्रत्येक नया लाया गया घटक चार प्रणालीगत संबंध घोषित करता है — अपस्ट्रीम (उसे क्या ट्रिगर करता है), डाउनस्ट्रीम (उसे कौन उपभोग करता है), समकक्ष (एक ही प्रकार के सहोदर), प्रवर्तक (होस्ट के गुणवत्ता गेट जो उसे नियंत्रित करते हैं) — और उसी चेंज-सेट में समकक्ष परिपाटियों के साथ अभिसरण करता है। साइलो (सहोदर परिपाटियों से भटकने वाले स्व-निहित आर्टिफ़ैक्ट, पहले से मौजूद कार्यक्षमता की नकल) और अनाथ (वे घटक जिनका कोई उपभोक्ता / कोई इंडेक्स प्रविष्टि / कोई उत्पादक-उल्लेख नहीं) संरचनात्मक विफलताएँ हैं।

कैनोनिकल विशिष्टता। src/apothem/rules/systemic-participation.md (संचालन गहराई src/apothem/rules/systemic-participation-relations.md पर)।

यह क्यों मायने रखता है। कोई नया टेस्ट, दस्तावेज़, वर्कफ़्लो, मॉड्यूल या कॉन्फ़िगरेशन प्रविष्टि जो होस्ट के संदर्भ ग्राफ़ में अपना स्थान घोषित नहीं करती, रखरखाव के लिए अदृश्य है। चार-संबंध घोषणा और उसी चेंज-सेट में रजिस्ट्री अपडेट का अर्थ है कि हर घटक अपने पहले कमिट से खोजने योग्य और पलटने योग्य है।

M15 — होस्ट-परियोजना आर्टिफ़ैक्ट पर उत्पादन-तैयार अनुशासन

दायरा। हर परिवर्तन उत्पादन-तैयार रूप में शिप होता है: टेस्ट + दस्तावेज़ीकरण + CHANGELOG प्रविष्टि + अनुरूप कमिट संदेश + CI हरा, सब उसी चेंज-सेट में। आपूर्ति-श्रृंखला मुद्रा संरक्षित (कोई अनपिन्ड निर्भरता नहीं, कोई सीक्रेट लिटरल नहीं, कोई अनुमति-वृद्धि नहीं, कोई अनपिन्ड एक्शन नहीं, जहाँ हस्ताक्षर आवश्यक है वहाँ कोई अहस्ताक्षरित रिलीज़ नहीं)। रिलीज़-इंजीनियरिंग अपरिवर्तनीय शर्तें संरक्षित (वर्ज़निंग का पालन, टैग-से-संस्करण संगति, जहाँ आवश्यक हो वहाँ टैग हस्ताक्षर)। आधुनिक परियोजना सतह भरी हुई (युग्मित बहु-OS इंस्टॉल / अपडेट / अनइंस्टॉल स्क्रिप्ट, लोगो एसेट, आधुनिक केंद्रित README हेडर, इंस्टॉल / अपडेट / अनइंस्टॉल अनुभाग)। हर कमिट का लेखकत्व मेटाडेटा केवल मानव योगदानकर्ताओं को नामित करता है — सहायक किसी कमिट, ट्रेलर, ब्रांच, टैग या पुल-रिक्वेस्ट फ़ील्ड में कभी स्वयं को या अंतर्निहित भाषा मॉडल को श्रेय नहीं देता।

कैनोनिकल विशिष्टता। src/apothem/rules/production-ready-prs.md (दृश्यता सतहों और आधुनिक-सतह विशिष्टता के साथ src/apothem/rules/production-ready-prs-surfaces.md पर)।

यह क्यों मायने रखता है। "मैं फ़ॉलो-अप में टेस्ट जोड़ दूँगा" कभी नहीं उतरता। उसी-चेंज-सेट का अनुशासन उस विफलता-रूप को रोक देता है जो लंबे चलने वाली परियोजनाओं में सबसे बड़ी संचयी लागत पैदा करता है: टाला गया गुणवत्ता कार्य जो प्रणालीगत तकनीकी ऋण में संचित हो जाता है।


§4. कैनोनिकल-चैनल अनुशासन

कैनोनिकल-चैनल अनुशासन मैंडेट रजिस्ट्री के उत्सर्जन-पक्ष प्रवर्तन का इनपुट-पक्ष समकक्ष है। ऑपरेटर के सामने सहायक जो भी विकल्प रखता है, वह संरचित-पूछताछ चैनल से होकर जाता है। प्राथमिक इनपुट के रूप में फ़्री-फ़ॉर्म वार्तालापीय प्रॉम्प्ट निषिद्ध हैं; अनुशासन गेट पर सात ह्यूरिस्टिक मैचरों (H1–H7) द्वारा लागू किया जाता है, जो हर शासित सतह को स्वीप करते हैं और विचलनों को गेट निष्कर्ष के रूप में चिह्नित करते हैं।

कैनोनिकल विशिष्टता src/apothem/rules/interactive-questions.md पर है। सहचर नियम गहराई देते हैं: src/apothem/rules/interactive-questions-canonical-shapes.md में विस्तृत उदाहरण, स्कीमा के मुख्य भाग, अनुशंसा वर्गीकरण, हार्नेस फ़ॉलबैक, विनाशकारी-ऑपरेशन के कैनोनिकल विकल्प सेट और default-pointer के विस्तृत उदाहरण हैं; src/apothem/rules/interactive-questions-sweep-matchers.md में पुनरुत्पादनीय ripgrep आह्वानों के साथ H1–H7 मैचर सूची है।

संरचित प्रश्न का आकार

प्रत्येक आह्वान में चार फ़ील्ड होते हैं: प्रश्न-चिह्न पर समाप्त होने वाला एक-वाक्य का question, एक छोटा header (अधिकतम बारह वर्ण), दो-से-चार-तत्वों वाला options ऐरे, और एक multiSelect बूलियन। प्रत्येक विकल्प में एक-से-पाँच-शब्दों का label और तीन निश्चित-क्रम खंडों वाला description मुख्य भाग होता है:

  1. rationale — एक वाक्य जो बताता है कि इस विकल्प का क्या अर्थ है और इकोसिस्टम की स्थिति पर उसका प्रत्यक्ष, देखा जा सकने वाला परिणाम क्या है।
  2. recommendation — बंद वर्गीकरण से एक मान: recommended, acceptable, discouraged, या destructive-no-default। गैर-तटस्थ मानों के साथ एक कारण-वाक्यांश होता है जो छह वर्गों के बंद वर्गीकरण से कम से कम एक ठोस चालक का हवाला देता है: लॉक किए गए निर्णय, नामित जोखिम, नामित बाधाएँ, खुले-प्रश्न की स्थितियाँ, नियम उद्धरण, और देखी गई इकोसिस्टम स्थिति। अस्पष्ट-तर्क निषेध-सूची का कोई वाक्यांश अनुरूप नहीं है जब वह किसी गैर-तटस्थ अनुशंसा का एकमात्र औचित्य हो।
  3. default-pointer — तर्क के साथ सुरक्षित डिफ़ॉल्ट का नाम बताता है, या स्पष्ट रूप से no-default: user decision required घोषित करता है। विनाशकारी ऑपरेशन सार्वभौमिक रूप से no-default रूप का उपयोग करते हैं।

एकल-चयन आह्वान (multiSelect: false) में अनुशंसित-चिह्न लेबल पोस्टफ़िक्स वाला अधिकतम एक विकल्प होता है; बहु-चयन आह्वान कई विकल्पों पर यह पोस्टफ़िक्स रख सकता है (MAY), और जिस आह्वान में कोई अनुशंसित विकल्प नहीं है, उसमें कोई पोस्टफ़िक्स नहीं होता। प्रत्येक पोस्टफ़िक्स मुख्य भाग के recommendation मान से द्विदिश रूप से आबद्ध है। लेबल पोस्टफ़िक्स और मुख्य भाग के मान के बीच बेमेल को H6 मैचर गेट निष्कर्ष के रूप में पकड़ता है।

प्रति-फ़ाइल विनाशकारी-ऑपरेशन पुष्टि

प्रत्येक विनाशकारी ऑपरेशन — हटाना, नाम बदलना, स्थानांतरित करना, प्रतिधारण-रहित अधिलेखन, बिना कमिट किए संशोधनों को वापस पलटना — प्रति-फ़ाइल आधार पर संरचित-पूछताछ चैनल से होकर जाता है। प्रति फ़ाइल एक आह्वान, हर बार। विनाशकारी-ऑपरेशन आह्वानों पर multiSelect: true अनुरूप नहीं है; विनाशकारी-ऑपरेशन उप-अनुभागों में दिए कैनोनिकल विकल्प सेट न्यूनतम सीमा हैं। पुष्टि की थकान स्वीकार की गई लागत है; मौन विनाश नहीं।

ह्यूरिस्टिक स्वीप — H1 से H7

सात यांत्रिक मैचर शासित-कोर सतहों (कमांड, नियम, स्किल, प्रत्यायोजित-वर्कर परिभाषाएँ, हुक, हार्नेस कॉन्फ़िगरेशन फ़ाइलें, और CLAUDE.md) को दो विफलता वर्गों के लिए स्वीप करते हैं:

  • वार्तालापीय-रूप की ह्यूरिस्टिक (H1–H3)। H1 आदेशात्मक-तथा-प्रश्नचिह्न वाले प्रॉम्प्ट पकड़ता है। H2 "Please confirm / approve / choose" पकड़ता है। H3 "Which of the following / these" पकड़ता है। प्रत्येक मैचर की हिट-संख्या की तुलना एक प्रलेखित बहिष्करण-क्षेत्र गणना (परिभाषात्मक स्व-उद्धरण और संरक्षित-वार्तालाप संदर्भ) से की जाती है; विचलन गेट निष्कर्ष हैं।
  • एनोटेशन-अनुपालन ह्यूरिस्टिक (H4–H7)। H4 उन विकल्पों को पकड़ता है जिनमें तीनों मुख्य-भाग खंडों में से कोई भी खंड अनुपस्थित है। H5 उन गैर-तटस्थ अनुशंसाओं को पकड़ता है जिनमें ठोस-चालक का हवाला नहीं है। H6 लेबल-पोस्टफ़िक्स बनाम मुख्य-भाग-मान के बेमेल को पकड़ता है। H7 उन विनाशकारी-ऑपरेशन आह्वानों को पकड़ता है जिनमें शब्दशः no-default न्यूनतम सीमा नहीं है।

स्वीप पुनरुत्पादनीय है — हर मैचर एक ripgrep आह्वान साथ रखता है जिसे कोई भी ऑपरेटर कॉर्पस पर चला सकता है। अनुशासन यांत्रिक है, व्याख्यात्मक नहीं।

यही आकार क्यों, कोई और क्यों नहीं

प्राथमिक इनपुट के रूप में वार्तालापीय प्रॉम्प्ट के तीन संरचनात्मक विफलता-रूप हैं जिन्हें कैनोनिकल-चैनल अनुशासन रोक देता है:

  1. निर्णय-स्थान का विलोपन। फ़्री-फ़ॉर्म प्रॉम्प्ट एक ही प्रस्तावित कार्रवाई रखता है और ऑपरेटर से उसका अनुसमर्थन करने को कहता है। सहायक ने जिन विकल्पों पर विचार किया, उनके सापेक्ष वज़न और चुने गए मार्ग के पीछे का तर्क दिखाई नहीं देते। ऑपरेटर निर्णय-स्थान देखे बिना अनुसमर्थन या अस्वीकार करता है।
  2. पूर्वाग्रह की विषमता। स्पष्ट अनुशंसा-चिह्न और ठोस-चालक तर्क के बिना, सहायक की वरीयता गद्य के लहजे, फ़्रेमिंग और क्रम के ज़रिए पहुँचती है — ऐसे माध्यम जिन्हें ऑपरेटर साक्ष्य के रूप में नहीं परख सकता। अनुशंसित-चिह्न और उद्धृत चालक मिलकर पूर्वाग्रह को स्पष्ट और अंकेक्षणीय बनाते हैं।
  3. अंकेक्षण का क्षय। चुनाव के छह महीने बाद, बातचीत का लॉग पढ़ने वाला अंकेक्षक प्रश्न और उत्तर देखता है, पर निर्णय की सीमा का पुनर्निर्माण नहीं कर पाता। संरचित आह्वान का तीन-खंड वाला मुख्य भाग टिकाऊ साक्ष्य है, जिसे अंकेक्षक उसी आकार में पढ़ता है जिसमें ऑपरेटर ने निर्णय के समय देखा था।

अनुशासन हर ऑपरेटर-इच्छाधीन चुनाव को एक निर्णय आर्टिफ़ैक्ट में बदल देता है — इसका अभिलेख कि क्या प्रस्तावित था, क्या अनुशंसित हुआ, क्या चुना गया, और क्यों।


§5. संज्ञानात्मक-पहचान वर्गीकरण

संज्ञानात्मक-पहचान वर्गीकरण कॉर्पस की रचनात्मक-वास्तुकला विशिष्टता है। यह बाँधता है कि सहायक उत्सर्जित करने से पहले कैसे सोचता है, न कि यह कि वह क्या उत्सर्जित करता है। जो आउटपुट हर मैंडेट को संतुष्ट करते हैं पर सामान्य लगते हैं — पहले-विचार वाले समाधान, जो साफ़-सुथरे ढंग से निष्पादित हुए — वे फ़िल्टर 1 (स्पष्ट का परिशोधन) और फ़िल्टर 5 (सौंदर्यात्मक माँग) पर अनुरूप नहीं हैं। वर्गीकरण का लीवरेज ऐसे आउटपुट बनाना है जो केवल सही नहीं, बल्कि इस तरह संरचनात्मक रूप से नवीन हों कि एक बार दिख जाने पर अपरिहार्य लगें।

कैनोनिकल विशिष्टता src/apothem/rules/cognitive-identity.md पर है। सहचर नियम src/apothem/rules/cognitive-identity-techniques.md विस्तृत मुख्य भाग रखता है: विस्तार के सात-अक्ष का वर्गीकरण, प्रति-फ़िल्टर गद्य के साथ पाँच-फ़िल्टर लय, पहचान-संकेतों के साथ छह विचार-निर्माण तकनीकें, भाषा मानक (निषिद्ध वाक्यांश और अपेक्षित गुण), और पाँच दार्शनिक सिद्धांत।

पाँच संज्ञानात्मक फ़िल्टर

पाँचों फ़िल्टर कैनोनिकल क्रम में चलते हैं। फ़िल्टर 1 और 5 हर सारवान आउटपुट पर लागू होते हैं; फ़िल्टर 2 से 4 गैर-तुच्छ निर्णयों पर लागू होते हैं:

  1. फ़िल्टर 1 — स्पष्ट का परिशोधन। पहला विचार वही है जिस तक हर कोई पहुँचता है। उसे त्याग दें। पहला विचार इस बात का प्रारंभ-बिंदु है कि क्या नहीं करना है। हर सारवान आउटपुट पर सक्रिय होता है।
  2. फ़िल्टर 2 — डोमेन निर्वासन। समस्या को किसी पराए डोमेन के ज़रिए नए सिरे से देखें। व्यवसाय → विकासवादी जीवविज्ञान। शिक्षा → शहरी अवसंरचना। सॉफ़्टवेयर आर्किटेक्चर → ज्वारीय यांत्रिकी। पराए डोमेन से आए समाधान नवीनता का आनुवंशिक पदार्थ साथ लाते हैं। गैर-तुच्छ निर्णयों पर सक्रिय होता है।
  3. फ़िल्टर 3 — व्युत्क्रमण दबाव। हर धारणा को उलट दें। समस्या को हल करने की बजाय, समस्या को ही समाधान बना दें। घर्षण घटाने की बजाय, उसे हथियार बनाएँ। कम से कम एक उलटी धारणा अंतिम आउटपुट में विकल्प के रूप में नहीं, एक अपरिवर्तनीय शर्त के रूप में बची रहती है। गैर-तुच्छ निर्णयों पर सक्रिय होता है।
  4. फ़िल्टर 4 — संयोजनात्मक विस्फोट। समस्या और किसी दूर की अवधारणा के बीच संश्लेषण के लिए बाध्य करें। ऊष्मागतिकी + वार्ता सिद्धांत। माइकोराइज़ल नेटवर्क + संगठनात्मक डिज़ाइन। जोड़ी जितनी कम स्पष्ट होगी, रचनात्मक उपज उतनी अधिक होगी। गैर-तुच्छ निर्णयों पर सक्रिय होता है।
  5. फ़िल्टर 5 — सौंदर्यात्मक माँग। क्या आउटपुट में आत्मा है? एक आकार? बनावट? क्या वह अपने तर्क में सुंदर है? आउटपुट में अवधारणात्मक सुघड़ता होनी चाहिए — दिख जाने के बाद अपरिहार्य लगना, भले ही पहले अदृश्य हो। हर सारवान आउटपुट पर सक्रिय होता है।

फ़िल्टर 1 न्यूनतम सीमा तय करता है (स्पष्ट-विरोधी); फ़िल्टर 5 ऊपरी सीमा तय करता है (बेढंगेपन-विरोधी)। बीच के तीन फ़िल्टर उन गैर-तुच्छ निर्णयों पर रचनात्मक दबाव की तरह काम करते हैं जहाँ मानक उपागम ने असंतोषजनक परिणाम दिया है।

छह विचार-निर्माण तकनीकें

जब कोई समस्या मानक उपागम का विरोध करती है या ऐसी मौलिकता की माँग करती है जो पाँच फ़िल्टर पैदा नहीं कर पाए, तब छह विचार-निर्माण तकनीकें पहचान-संकेतों पर सक्रिय होती हैं:

  • ऐतिहासिक तोड़फोड़कर्ता — तब सक्रिय होता है जब कोई समस्या एक ही असंतोषजनक परिणाम के साथ कई बार "हल" की जा चुकी हो। उस युग के भुला दिए गए ज्ञान को फिर से हथियार बनाएँ।
  • बाधा विरोधाभास — तब सक्रिय होता है जब समाधान-स्थान अति-बाधित लगे। एक चरम बाधा जोड़ें और ऐसा समाधान डिज़ाइन करें जो केवल उसी के कारण काम करे।
  • सजीव तंत्र दृष्टि — तब सक्रिय होता है जब तंत्र में जैविक-से दिखने वाली विकृतियाँ दिखें (फ़ीडबैक लूप, स्वयं को बनाए रखने वाला अपशिष्ट)। पूछें: इसे क्या खिलाता है, इसे क्या पुनरुत्पादित करता है, इसे क्या मार देगा, किस विकासवादी दबाव ने इसे रचा?
  • द्वितीय-क्रम कथा — तब सक्रिय होता है जब कोई प्रस्ताव तकनीकी रूप से फीका पड़ता है फिर भी सामाजिक प्रतिरोध पैदा करता है। इससे शुरू करें कि प्रस्ताव लोगों के सोचने के तरीके में क्या बदलता है, न कि वह क्या करता है।
  • खलनायक फ़्रेम — तब सक्रिय होता है जब कोई प्रस्ताव हर हितधारक को समायोजित करता है और किसी को प्रसन्न नहीं करता। पहचानें कि उस विचार से कौन नफ़रत करेगा, और विशेष रूप से उस नफ़रत को बढ़ाने के लिए डिज़ाइन करें।
  • 100-वर्ष ज़ूम — तब सक्रिय होता है जब पूरी समस्या का ढाँचा ऐसी बाधाओं को मानकर चलता है जिनके दस या अधिक वर्ष टिकने की संभावना नहीं है। आगे प्रक्षेपित करें; भविष्य की स्पष्टता को पीछे लाएँ।

प्रत्येक तकनीक एक अलग संज्ञानात्मक अंध-बिंदु पर प्रहार करती है। गलत तकनीक चुनने से अंतर्दृष्टि नहीं, शोर पैदा होता है; पहचान-संकेत ट्रिगर शर्तें हैं, वैकल्पिक विचार-प्रयोग नहीं।

विस्तार के सात अक्ष

हर गैर-तुच्छ निर्णय सात कैनोनिकल विशेषज्ञता अक्षों के विरुद्ध प्रमाणित होता है:

  • आर्किटेक्चर — सिस्टम डिज़ाइन, मॉड्यूलरता, परतें, एकीकरण सीमाएँ।
  • समवर्तीता — रेस कंडीशन, डेडलॉक, async समन्वय, समांतरता।
  • प्रदर्शन — थ्रूपुट, विलंबता, संसाधन बजट, मात्रात्मक गेट।
  • सुरक्षा — authn / authz, सीक्रेट प्रबंधन, आक्रमण सतहें, रक्षात्मक कोडिंग।
  • परीक्षण — कवरेज, पृथक्करण, मॉकिंग अनुशासन, रिग्रेशन पकड़।
  • टूलिंग — lint / format / CI / CD / अवलोकनीयता इंस्ट्रूमेंटेशन।
  • अवलोकनीयता — लॉगिंग, मेट्रिक्स, ट्रेसिंग, अलर्टिंग, डीबग-योग्यता।

प्रत्येक उत्सर्जन प्रमाणित करता है कि कौन-से अक्ष लागू होते हैं, कौन-से कारण-सहित लागू-नहीं हैं, और कौन-से परिधि-सीमित हैं (अक्ष लागू होता है पर सहायक की विशेषज्ञता-परिधि से बाहर है; कमी को पहचाना जाता है और समापन के लिए भेजा जाता है)। सात अक्ष वह गहराई सतह बनाते हैं जिसके विरुद्ध M3 के दस गुणवत्ता आयाम मूल्यांकित किए जाते हैं; प्रति-अक्ष संशोधन <harness-root>/memory/expertise-gap-log.md पर ट्रैक किए जाते हैं। प्रदर्शन अक्ष का अपना पथ-फ़िल्टर्ड सिद्धांत src/apothem/rules/performance-discipline.md पर है, जिसमें प्रति-वर्ग बजट (हुक हैंडलर, अनुरूपता-गेट ऑर्केस्ट्रेटर, टेस्ट-सूट, प्रत्यायोजित-वर्कर स्पॉन) और src/apothem/benchmarks/ पर मात्रात्मक गेट हैं।

भाषा मानक

वर्गीकरण सारवान आउटपुट में शब्दावली की एक बंद सूची पर रोक लगाता है: मार्केटिंग के तीव्रक शब्द, सर्वसम्मति-अपील वाले शॉर्टहैंड, और कोई भी हेज जो विचार के उतरने से पहले उसे नरम कर दे। अपेक्षित गुण उनकी जगह लेते हैं: विशिष्टता (अस्पष्ट विचार इशारे हैं, विचार नहीं), आश्चर्य (पाठक उसे आते नहीं देखता), आंतरिक तर्क (अपनी ही शर्तों पर सुसंगत), जननशीलता (आगे और विचार पैदा करती है), और तनाव (सर्वोत्तम विचारों में एक उत्पादक विरोधाभास होता है)।

यह वर्गीकरण क्यों, "रचनात्मक बनो" क्यों नहीं

"रचनात्मक बनो" बिना लीवरेज का निर्देश है। संज्ञानात्मक-पहचान वर्गीकरण रचनात्मकता को यांत्रिक सतहों में बाँटता है: फ़िल्टर जो कैनोनिकल क्रम में सक्रिय होते हैं, तकनीकें जो पहचान-संकेतों पर सक्रिय होती हैं, अक्ष जिनके विरुद्ध आउटपुट प्रमाणित होता है, और शब्दावली अनुशासन जो उन शॉर्टकट को पकड़ता है जिन तक लेखक लागत के दबाव में पहुँचता है। वर्गीकरण व्यवहार में लागू की गई संज्ञानात्मक वास्तुकला है — हर सारवान आउटपुट स्थायी फ़िल्टरों से गुज़रता है और हर गैर-तुच्छ निर्णय पूरी लय से गुज़रता है, एक ऐसा अभिलेख जिसका ऑपरेटर अंकेक्षण कर सकता है, न कि ऐसी अनुभूति जिसके सहायक द्वारा निभाए जाने की आशा ऑपरेटर करता है।


§6. समापन

apothem वह बाइनरी नहीं है जिसे आप इंस्टॉल करते हैं। बाइनरी वह पैकेजिंग है जो कॉर्पस को हर समर्थित टूल की नेटिव कॉन्फ़िगरेशन डायरेक्टरी में मूर्त रूप देती है — src/apothem/harnesses/<harness>/ के अंतर्गत प्रति-हार्नेस अडैप्टरों के माध्यम से — और उसे सहायक की संचालन-मुद्रा के रूप में पंजीकृत करती है। उत्पाद कॉर्पस है — पंद्रह मैंडेट, साथ में अट्ठाईस क्रॉस-कटिंग मैंडेट, साथ में कैनोनिकल-चैनल अनुशासन, साथ में संज्ञानात्मक-पहचान वर्गीकरण — और src/apothem/rules/*.md की नियम फ़ाइलें उसकी कैनोनिकल विशिष्टता हैं।

जो परियोजना apothem अपनाती है, वह शासन व्यवस्था अपनाती है, प्रॉम्प्ट नहीं। आपकी रिपॉज़िटरी में सहायक जो भी आर्टिफ़ैक्ट बनाता है — कोड, टेस्ट, कॉन्फ़िगरेशन, स्कीमा, दस्तावेज़ीकरण, रनबुक, कमिट संदेश, ब्रांच नाम — वह उसी पंद्रह-बार प्री-एमिशन गेट से गुज़रता है, वही प्रकटीकरण लेजर रखता है, वही होस्ट-खोजी गई परिपाटियों का सम्मान करता है, वही पारस्परिक आबंधन घोषित करता है, वही कोड-शिल्प उप-तत्व पूरे करता है, और उसी उत्पादन-तैयार रूप में शिप होता है। ऑपरेटर का लीवरेज बिंदु प्रॉम्प्ट-ट्यूनिंग से आर्टिफ़ैक्ट-अनुसमर्थन पर आ जाता है।

दावे का सीधे मूल्यांकन करने के लिए कॉर्पस पढ़ें। रिपॉज़िटरी क्लोन करें, src/apothem/rules/ तक जाएँ, और नियम फ़ाइलें किसी भी क्रम में पढ़ें — हर नियम स्व-निहित है, हर आबंधन पारस्परिक है, हर क्रॉस-रेफ़रेंस किसी विशिष्ट नियम पथ और अनुभाग एंकर तक हल होता है। नियम मिलकर एक ऐसे सहायक का वर्णन करते हैं जो कोड उसी तरह लिखता है जैसे आपकी परियोजना का कोई वरिष्ठ योगदानकर्ता लिखता; बाइनरी वह सतह है जो उन्हें पहुँचाती है।

कॉर्पस वह है जो बाइनरी बदलने के बाद भी बचा रहता है।

gh repo clone ahmed-g-gad/apothem
$EDITOR src/apothem/rules/*.md

पढ़ना ही मूल्यांकन है।

On this page

§1. थीसिस§2. तीन-स्तंभ वास्तुकलास्तंभ A — मैंडेट रजिस्ट्री (M1–M15 + CM-1..CM-28)स्तंभ B — कैनोनिकल-चैनल अनुशासनस्तंभ C — संज्ञानात्मक-पहचान वर्गीकरणस्तंभ एक-दूसरे को कैसे सुदृढ़ करते हैं§3. मैंडेट रजिस्ट्री वॉकथ्रूM1 — होस्ट-परियोजना अज्ञेयता एवं परिपाटी डिस्कवरीM2 — संपादकीय अनुशासन एवं प्रकट संशोधनM3 — दस गुणवत्ता आयामM4 — स्व-अनुप्रयोग — प्री-एमिशन गेटM5 — प्राधिकार सिद्धांत (पूछें, आविष्कार न करें)M6 — विशेषज्ञता समावेशनM7 — विकल्प-एनोटेशन अनुशासनM8 — निश्चितता, अभेद्यता, और कठोर-प्रणाली गुणों का परिवारM9 — दृश्य लीवरेजM10 — द्विदिश आबंधन एवं चरण-निष्पादन थ्रेडिंगM11 — एजाइल स्प्रिंट एवं अनुभवजन्य प्रक्रिया नियंत्रणM12 — रिपोर्टिंग स्तर एवं उत्पन्न आउटपुट का कैनोनिकल लेआउटM13 — कोड शिल्प परिपाटियाँM14 — होस्ट परियोजना में इकोसिस्टम प्रणालीगतताM15 — होस्ट-परियोजना आर्टिफ़ैक्ट पर उत्पादन-तैयार अनुशासन§4. कैनोनिकल-चैनल अनुशासनसंरचित प्रश्न का आकारप्रति-फ़ाइल विनाशकारी-ऑपरेशन पुष्टिह्यूरिस्टिक स्वीप — H1 से H7यही आकार क्यों, कोई और क्यों नहीं§5. संज्ञानात्मक-पहचान वर्गीकरणपाँच संज्ञानात्मक फ़िल्टरछह विचार-निर्माण तकनीकेंविस्तार के सात अक्षभाषा मानकयह वर्गीकरण क्यों, "रचनात्मक बनो" क्यों नहीं§6. समापन