डिज़ाइन-सिस्टम ऐडऑन

एक उपयोगकर्ता-उन्मुख इंटरफ़ेस सतह वाली रिपॉज़िटरी को एक DESIGN.md दें — एक Markdown डिज़ाइन-सिस्टम फ़ाइल जिसे कोई भी कोडिंग एजेंट रिपॉज़िटरी की अपनी परिपाटियों के अनुरूप इंटरफ़ेस आउटपुट बनाने के लिए पढ़ता है, बजाय उन बिना-शैली वाले, सांख्यिकीय रूप से सामान्य डिफ़ॉल्ट के जिन पर एक एजेंट बिना किसी मार्गदर्शन के टिक जाता है। यह चौथा ऑप्ट-इन Deep Work Plan ऐडऑन है।

एक “इंटरफ़ेस सतह” बहुरूपी है: एक रेंडर किया गया विज़ुअल UI, शैलीबद्ध CLI आउटपुट, और एक संवादात्मक सतह (उत्पाद चैट या ईमेल पर बात करता है) — हर एक गिना जाता है। ऐडऑन हर एक का स्वतंत्र रूप से एक प्रोफ़ाइल के रूप में पता लगाता है, और स्वीकृत प्रोफ़ाइल उसी एकल DESIGN.md में परत-दर-परत जुड़ते हैं।

यह क्या जोड़ता है

docs/DESIGN.md पर एक DESIGN.md (रिपॉज़िटरी के अन्य स्पेक्स के साथ; रिपॉज़िटरी रूट केवल तब जब कोई docs/ वृक्ष न हो), जो AGENTS.md से संदर्भित होती है ताकि एजेंट इसे बाकी दस्तावेज़ों की तरह खोज लें। एक रिपॉज़िटरी, एक फ़ाइल — कभी प्रति-सतह अलग फ़ाइलें नहीं।
visual-ui प्रोफ़ाइल — विहित विज़ुअल खंड: अवलोकन/वातावरण, रंग पैलेट और भूमिकाएँ (लाइट + डार्क), टाइपोग्राफ़ी, लेआउट और स्पेसिंग, ऊँचाई और गहराई, आकृतियाँ, कंपोनेंट्स, रिस्पॉन्सिव व्यवहार, करने और न करने योग्य बातें (रिपॉज़िटरी के सुलभता नियमों सहित)।
cli-output प्रोफ़ाइल — शैलीबद्ध टर्मिनल इंटरफ़ेस: आउटपुट की आवाज़, सिमेंटिक रंग और शैलियाँ (success/error/warning/info/dim वास्तविक थीम से मैप किए हुए), आउटपुट कंपोनेंट्स (पैनल, तालिकाएँ, स्पिनर, इंटरैक्टिव प्रॉम्प्ट — रिपॉज़िटरी के वास्तविक हेल्परों के नाम पर), लेआउट परिपाटियाँ, और डिग्रेडेशन नियम (TTY बनाम पाइप, NO_COLOR, stdout/stderr अनुशासन, एग्ज़िट कोड)।
conversational प्रोफ़ाइल — उत्पाद की संदेश-सतह: आवाज़ और रजिस्टर (लहजा, संक्षिप्तता, ब्रांड-नामकरण नियम), संदेश-संरचना (DM, चैनल पोस्ट, थ्रेड उत्तर, एडिट-इन-प्लेस), और प्रति-प्लेटफ़ॉर्म रेंडरिंग (Slack mrkdwn, Discord markdown, Teams अडैप्टिव कार्ड, ईमेल) सादे-टेक्स्ट फ़ॉलबैक के साथ।
एक साझा एजेंट प्रॉम्प्ट मार्गदर्शिका, साथ ही एक सत्यापन चरण जो हर प्रोफ़ाइल की अखंडता जाँचता है: प्रलेखित टेक्स्ट कंट्रास्ट WCAG AA पर खरा उतरता है (विज़ुअल), रंग कभी अर्थ का एकमात्र वाहक नहीं होता (CLI), समृद्ध रेंडरिंग सादे-टेक्स्ट फ़ॉलबैक नोट करती हैं (संवादात्मक), और टोकन संदर्भ हल होते हैं।

व्यवहार

तर्क करें, कॉपी न करें। हर मान रिपॉज़िटरी के वास्तविक डिज़ाइन स्रोत से व्युत्पन्न होता है — उसकी स्टाइलशीट, CSS कस्टम प्रॉपर्टीज़, Tailwind कॉन्फ़िग, टोकन फ़ाइलें, कंपोनेंट शैलियाँ, उसका CLI डिस्प्ले/थीम मॉड्यूल, या उसके संदेश-रचना हेल्पर। यह कभी किसी तृतीय-पक्ष ब्रांड की DESIGN.md चिपकाता नहीं और न ही किसी अन्य उत्पाद की परिपाटियाँ थोक में आयात करता है; संदर्भ कैटलॉग संरचना के लिए प्रेरणा हैं, कभी सामग्री के लिए नहीं।
समाधान करें, मिटाएँ नहीं। एक मौजूदा DESIGN.md या टोकन स्रोत को जोड़-घटाव के साथ समाधानित किया जाता है, कभी अधिलेखित नहीं; एक नया स्वीकृत प्रोफ़ाइल जोड़ने पर उसके खंड बाकी को फिर से लिखे बिना जुड़ते हैं; विनाशकारी परिवर्तनों के लिए अनुमोदन आवश्यक है।
संदर्भ द्वारा खोज। DESIGN.md जहाँ भी रहे, AGENTS.md (और CLAUDE.md) उसे संदर्भित करती है — संकेतक, न कि भौतिक स्थान, वह है जो यह गारंटी देता है कि एजेंट उसे लोड करें।
व्यावहारिक, कठोरता से बँधा नहीं। यह उभरती DESIGN.md परिपाटी को अनुसरण करने योग्य एक आकार के रूप में संदर्भित करता है, उसे गैर-विज़ुअल सतहों तक विस्तारित करता है, और किसी एकल टोकन स्कीमा से बँधे बिना Markdown-प्रथम बना रहता है।

इंटरफ़ेस-दायरे वाला, प्रति-प्रोफ़ाइल शक्ति के साथ

यह ऐडऑन उन रिपॉज़िटरीज़ के लिए है जिनके पास कम से कम एक वास्तविक इंटरफ़ेस सतह हो; जिस रिपॉज़िटरी के पास कोई न हो (एक शुद्ध लाइब्रेरी, एक हेडलेस सेवा, केवल-इन्फ्रास्ट्रक्चर रिपॉज़िटरी) उसके लिए यह कभी प्रस्तावित नहीं होता। हर प्रोफ़ाइल अपनी सिफ़ारिश-शक्ति रखता है:

visual-ui पता चलने पर डिफ़ॉल्ट-ऑन है — CSS कस्टम प्रॉपर्टीज़ वाली एक स्टाइलशीट, एक Tailwind कॉन्फ़िग या @theme ब्लॉक, UI कंपोनेंट्स, या एक ब्रांड/शैली मार्गदर्शिका। ऑनबोर्डिंग इसे ट्रस्ट मोड में लागू करती है और गाइडेड मोड में इसकी पुरज़ोर सिफ़ारिश करती है।
cli-output और conversational पता चलने पर अनुशंसित हैं — और हमेशा पूछे जाते हैं, कभी स्वतः लागू नहीं होते, ट्रस्ट मोड में भी। एक CLI रेंडरिंग लाइब्रेरी और एक सुविचारित डिस्प्ले परत पहले का संकेत देती है; एक चैट-प्लेटफ़ॉर्म SDK या संदेश-रचना परत दूसरे का संकेत देती है। कच्चे प्रिंट वाला एक साधारण आर्ग्युमेंट पार्सर योग्य नहीं ठहरता।

यह कभी आवश्यक नहीं — शून्य ऐडऑन वाली एक रिपॉज़िटरी पूर्णतः अनुरूप होती है, और आप किसी भी प्रोफ़ाइल या पूरे ऐडऑन को हमेशा अस्वीकार कर सकते हैं। प्रोफ़ाइलों के अस्तित्व से पहले बनाई गई DESIGN.md एक वैध एकल-प्रोफ़ाइल विज़ुअल फ़ाइल है: कोई माइग्रेशन नहीं।

वैकल्पिक कमांड

स्वीकृत होने पर, ऐडऑन रिपॉज़िटरी के .agents/commands/ में एक /design-system डेलिगेटर स्थापित कर सकता है ताकि बाद में DESIGN.md को पुनर्जनित या ताज़ा किया जा सके। कमांड स्थापित करना वैकल्पिक है; अस्वीकृत ऐडऑन कोई कमांड स्थापित नहीं करता।

प्रति-फ़ीचर डिज़ाइन दस्तावेज़ों से संबंध

यह एक रिपॉज़िटरी-स्तरीय, स्थायी डिज़ाइन-सिस्टम फ़ाइल है — एक प्रति-फ़ीचर तकनीकी डिज़ाइन दस्तावेज़ (उपकरण-बँधे स्पेक-संचालित वर्कफ़्लो की “requirements → design → tasks” वाली design.md) से अलग। Deep Work Plan जानबूझकर कोई अलग प्रति-फ़ीचर डिज़ाइन-दस्तावेज़ आर्किटाइप नहीं भेजता: एक योजना का README, हर कार्य के स्वीकृति मानदंड, और सत्यापन-गेट पहले से ही उस भूमिका को कवर करते हैं। यह ऐडऑन उस एक अंतराल को भरता है जिसे वह भूमिका नहीं भरती: टिकाऊ, रिपॉज़िटरी-नेटिव इंटरफ़ेस डिज़ाइन संदर्भ।