Skip to content
Apothem
अभिशासन

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

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

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


§1. थीसिस

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

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

apothem उस रूपरेखा को अस्वीकार करता है।

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

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

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

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

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


§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 पर रहती है, जिसकी गहराई path-filtered सहचरों src/apothem/rules/interactive-questions-canonical-shapes.md और src/apothem/rules/interactive-questions-sweep-matchers.md पर वहन की गई है।

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

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

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

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

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

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


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

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

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

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

कैनोनिकल विशिष्टता. 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 — दस गुणवत्ता आयाम

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

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

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

M4 — स्व-अनुप्रयोग — उत्सर्जन-पूर्व गेट

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

कैनोनिकल विशिष्टता. 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 — विकल्प-व्याख्या अनुशासन

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

कैनोनिकल विशिष्टता. 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

यह क्यों मायने रखता है. पारस्परिक आबंधन कॉर्पस को एक नौगम्य ग्राफ़ में बदल देते हैं। किसी भी rule की Cross-bound with ↔ पंक्ति उस हर सहयोगी की ओर इंगित करती है जो उसे उद्धृत करता है, और प्रत्येक उद्धृत सहयोगी वापस इंगित करता है। कॉर्पस की पुनर्संरचना यांत्रिक हो जाती है — किसी rule का नाम बदलें, पारस्परिकता-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 — कोड शिल्प परिपाटियाँ

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

कैनोनिकल विशिष्टता. src/apothem/rules/code-craft-conventions.md (सार्वभौमिक-प्रत्यायोजन स्टब) साथ ही प्रति-भाषा सहोदर rules 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 पर)।

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

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

क्षेत्र. प्रत्येक परिवर्तन उत्पादन-तैयार रूप में शिप होता है: टेस्ट + दस्तावेज़ीकरण + CHANGELOG प्रविष्टि + अनुरूप कमिट संदेश + CI हरा एक ही परिवर्तन-सेट में। आपूर्ति-शृंखला मुद्रा संरक्षित (कोई अनपिन्ड निर्भरता नहीं, कोई रहस्य शब्दशः नहीं, कोई अनुमति-वृद्धि नहीं, कोई अनपिन्ड actions नहीं, जहाँ हस्ताक्षर अपेक्षित है वहाँ कोई अहस्ताक्षरित रिलीज़ नहीं)। रिलीज़-इंजीनियरिंग अपरिवर्तनीय संरक्षित (संस्करणन सम्मानित, टैग-से-संस्करण संगति, जहाँ अपेक्षित है वहाँ टैग हस्ताक्षर)। आधुनिक परियोजना सतह आबाद (युग्मित बहु-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 पर रहती है। सहचर rules गहराई वहन करते हैं: src/apothem/rules/interactive-questions-canonical-shapes.md कार्य-उदाहरण, स्कीमा मुख्य भाग, अनुशंसा वर्गीकरण, harness फ़ॉलबैक, विनाशकारी-संक्रिया कैनोनिकल विकल्प सेट, और 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। ग़ैर-तटस्थ मान एक बंद छह-वर्ग वर्गीकरण से कम से कम एक ठोस चालक उद्धृत करने वाला एक क्यों-वाक्यांश वहन करते हैं: locked निर्णय, नामित जोखिम, नामित बाधाएँ, खुले-प्रश्न मुद्राएँ, rule उद्धरण, और अवलोकित इकोसिस्टम स्थिति। अस्पष्ट-तर्क निषेध सूची किसी ग़ैर-तटस्थ अनुशंसा के एकमात्र औचित्य के रूप में खड़ी होने पर अनुरूप नहीं है।
  3. default-pointer — तर्क के साथ सुरक्षित डिफ़ॉल्ट को नामित करता है, या स्पष्ट रूप से no-default: user decision required घोषित करता है। विनाशकारी संक्रियाएँ सार्वभौमिक रूप से no-default रूप का उपयोग करती हैं।

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

प्रति-फ़ाइल विनाशकारी-संक्रिया पुष्टि

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

अनुमानात्मक स्वीप — H1 से H7

सात यांत्रिक मैचर शासित-कोर सतहों (commands, rules, skills, प्रत्यायोजित-कार्यकर्ता परिभाषाएँ, hooks, harness कॉन्फ़िगरेशन फ़ाइलें, और 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 पर रहती है। सहचर rule src/apothem/rules/cognitive-identity-techniques.md विस्तृत मुख्य भाग वहन करता है: विस्तार-के-सात-अक्ष वर्गीकरण, प्रति-फ़िल्टर गद्य के साथ पाँच-फ़िल्टर लय, पता-लगाव संकेतों के साथ छह विचार-निर्माण तकनीकें, भाषा मानक (निषिद्ध वाक्यांश और अपेक्षित गुण), और पाँच दार्शनिक सिद्धांत।

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

प्रत्येक सारवान आउटपुट कैनोनिकल क्रम में एक पाँच-फ़िल्टर लय से गुज़रता है:

  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 पर ट्रैक किए जाते हैं। निष्पादन अक्ष अपना स्वयं का path-filtered सिद्धांत src/apothem/rules/performance-discipline.md पर प्रति-वर्ग बजट (hook हैंडलर, conformity-gate ऑर्केस्ट्रेटर, टेस्ट-सूट, प्रत्यायोजित-कार्यकर्ता spawn) और src/apothem/benchmarks/ पर मात्रात्मक गेट के साथ वहन करता है।

भाषा मानक

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

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

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


§6. समापन

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

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

दावे का सीधे मूल्यांकन करने के लिए, कॉर्पस पढ़ें। रिपॉज़िटरी क्लोन करें, src/apothem/rules/ तक चलें, और rule फ़ाइलें किसी भी क्रम में पढ़ें — प्रत्येक rule स्व-निहित है, प्रत्येक आबंधन पारस्परिक है, प्रत्येक क्रॉस-रेफ़रेंस एक विशिष्ट rule पथ और अनुभाग एंकर तक हल होता है। 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. समापन