यह ओपन-सोर्स टूल क्लाउड (Claude) से आर्किटेक्चर डायग्राम बनवाता है

BBetter Stack
Computing/Software

Transcript

00:00:00जब हम अपने कोडिंग एजेंट्स को रेपो मैप करने के लिए कहते हैं, तो अक्सर काफ्का, रेडिस, या ऐसा एपीआई गेटवे मिल जाता है जो वास्तव में मौजूद ही नहीं होता।
00:00:07डिएग्राम्स देखने में अक्सर ठीक-ठाक लगते हैं, लेकिन उनमें बहुत सी चीजें छूट जाती हैं।
00:00:10यह है आर्किफाई, जहां एजेंट खुद कुछ भी ड्रा नहीं करता।
00:00:14यह एक टाइप्ड ग्राफ आउटपुट देता है, आर्किफाई उसे वैलिडेट करता है, और फिर डिएग्राम रेंडर करता है।
00:00:19यह हमारे आर्किटेक्चर को विजुअलाइज करने के सबसे बेहतरीन तरीकों में से एक हो सकता है।
00:00:23हम अभी इसका पता लगाने वाले हैं।
00:00:30खैर, हमारे मॉडल को शायद वैसे डिएग्राम ड्रा करना ही नहीं चाहिए।
00:00:33आर्किफाई इस तरह काम करता है कि यह सिस्टम को संरचित, टाइप्ड JSON के रूप में वर्णित करता है।
00:00:37वह वैलिडेट होता है, और उसके बाद ही एक लोकल कंपाइलर इसे फाइनल HTML में बदलता है।
00:00:42अगर ग्राफ अमान्य है, तो यह फेल हो जाता है।
00:00:45यह है आर्किफाई, और इसने कुछ ही महीनों में 44,000 स्टार्स हासिल कर लिए क्योंकि यह सीधे क्लाउड कोड, कर्सर और कोडेक्स से जुड़ जाता है।
00:00:53तो मैं इसे परखना चाहता हूँ।
00:00:54मैं आर्किफाई इंस्टॉल करने जा रहा हूँ, इसे एक रेपो पर पॉइंट करूँगा, और इससे आर्किटेक्चर के बारे में एक सवाल का जवाब दिलवाऊँगा।
00:01:00फिर हम देखेंगे कि क्या हम इस परिणाम को किसी PR में इस्तेमाल भी कर सकते हैं या नहीं।
00:01:03और कुछ ऐसे उपयोग के मामले हैं जहां मैं इसका बिल्कुल इस्तेमाल नहीं करूंगा, लेकिन हम उन पर जल्द ही चर्चा करेंगे।
00:01:08अगर आपको ऐसे कोडिंग टूल्स पसंद हैं जो आपके काम को तेज़ करते हैं, तो सब्सक्राइब ज़रूर करें।
00:01:11हमारे वीडियो लगातार आते रहते हैं।
00:01:13ठीक है, तो इसे इंस्टॉल करना यहाँ एक कमांड का काम है।
00:01:17और यह कोई ऐसा ऐप नहीं है जिसे मैं सेटअप कर रहा हूँ।
00:01:19यह असल में एक एजेंट स्किल है।
00:01:22इसके इंस्टॉल होने के बाद, मैं क्लाउड कोड या पहले बताए गए अन्य विकल्पों में से किसी से भी इसी स्किल का उपयोग कर सकता हूँ
00:01:28बिना एडिटर या अपने वर्कफ़्लो को बदले।
00:01:32अब मैं इसे एक वास्तविक काम सौंप सकता हूँ।
00:01:34मैं इससे इस रेपो के आर्किटेक्चर को ड्रा करने के लिए नहीं कह रहा हूँ।
00:01:37वह ठीक लग सकता है।
00:01:39लेकिन कुल मिलाकर, इससे हमारे पास केवल कचरा ही वापस आएगा।
00:01:42इसलिए मैं एक ठोस सवाल पूछने जा रहा हूँ।
00:01:45आर्किफाई का उपयोग करें, आर्किटेक्चर डिएग्राम अधिकतम 8 से 12 नोड्स का होना चाहिए।
00:01:49इस सर्विस में कैश मिस होने पर क्या होता है?
00:01:52केवल उन्हीं बॉक्स को शामिल करें जो इस रेपो में मौजूद हैं।
00:01:54यदि आप किसी कंपोनेंट को साबित नहीं कर सकते, तो उसे छोड़ दें।
00:01:58एक स्व-निहित HTML डिलीवर करें।
00:02:00यह एक योजना, एक सवाल की तरह है।
00:02:02लगभग 8 से 12 नोड्स।
00:02:04क्योंकि अगर हम किसी एजेंट से हमारे पूरे कोड बेस को मैप करने के लिए कहें, तो क्या हमने कुछ सरल बनाया है या
00:02:08इसे समझने में और कठिन बना दिया है?
00:02:10अब मैंने अपने रेपो ट्री को एक फ्लोचार्ट में बदल दिया है।
00:02:14एजेंट JSON के रूप में आर्किटेक्चर लिखता है।
00:02:16फिर आर्किफाई इसे वैलिडेट करता है।
00:02:18मैं उस वैलिडेशन को सीधे भी चला सकता हूँ जैसा कि मैं यहाँ करने जा रहा हूँ।
00:02:23यह वास्तव में एक बहुत ही शानदार फीचर है जो मुझे इसमें मिला।
00:02:27नोड्स में एक कमिट और एक विशिष्ट लाइन रेंज से बंधे रेपो साक्ष्य भी शामिल हो सकते हैं।
00:02:32यदि वह प्रमाण मौजूद नहीं है, तो नोड को केवल इसलिए एसआरसी बैज नहीं मिलता क्योंकि नोड जवाब में
00:02:37मजबूत लगता है।
00:02:39ठीक है।
00:02:39अब, इससे क्या मदद मिल रही है?
00:02:41यह एक आर्किटेक्चर डिएग्राम जैसा दिखता है।
00:02:43हाँ, ज़रूर, लेकिन आपको इसे उस तरह इस्तेमाल करने की ज़रूरत नहीं है।
00:02:46मैं इसके भीतर एक वास्तविक सर्विस खोज सकता हूँ।
00:02:50मैं उस पर क्लिक कर सकता हूँ और तुरंत देख सकता हूँ कि अपस्ट्रीम और डाउनस्ट्रीम क्या है।
00:02:55फिर मैं उस रूट को चला सकता हूँ और सिस्टम के माध्यम से कैश मिस पाथ का अनुसरण कर सकता हूँ।
00:02:59तो 10 तीरों को घूरने और मानसिक रूप से उन्हें वापस ट्रेस करने की कोशिश करने के बजाय, अब मैं उनके माध्यम से चल सकता हूँ।
00:03:05और...
00:03:06और ऐसा करने के अलावा, मैं इसे एक्सपोर्ट कर सकता हूँ।
00:03:08मैं एक PNG कॉपी कर सकता हूँ या 1200 बाय 36 का शेयर कार्ड जनरेट कर सकता हूँ।
00:03:13यहाँ असली अंतर यह मरमेड है, है ना?
00:03:17मरमेड टूल आमतौर पर कुछ ऐसा होता है जिसे मैं पढ़ता हूँ।
00:03:20यह कुछ ऐसा है जिससे मैं सवाल पूछ सकता हूँ और जिसके खिलाफ पूछ सकता हूँ।
00:03:23और इस गति का उपयोग खराब संरचना को छिपाने के लिए नहीं किया जा रहा है, डिएग्राम को एक स्थिर छवि के रूप में एक्सपोर्ट करें
00:03:28और अर्थ जीवित रहने के लिए अभी भी वहीं है।
00:03:31और एक दूसरा उपयोग का मामला है जो वास्तव में अधिक उपयोगी हो सकता है, है ना?
00:03:35हम क्या सोच रहे हैं?
00:03:36खैर, मैं कोड रिव्यू के बारे में सोच रहा हूँ।
00:03:38मान लीजिए कि यह बदलाव से पहले का सिस्टम है।
00:03:41फिर मैं एक मौजूदा रीट्राय वर्कर जोड़ता हूँ।
00:03:44मैं एजेंट से हवा में कुछ भी गढ़े बिना आर्किटेक्चर को अपडेट करने के लिए कह सकता हूँ।
00:03:49आर्किफाई तब दो वैलिडेटेड स्नैपशॉट का अंतर बता सकता है: जोड़ा गया, हटाया गया, स्थानांतरित किया गया, पुनः रूट किया गया।
00:03:54तो दो जनरेटेड डिएग्राम प्राप्त करने के बजाय, मैं देख सकता हूँ कि वास्तव में क्या बदला है।
00:03:59और एडिटर अभी भी सिर्फ चैट है।
00:04:02लेकिन अगर मैं चाहता हूँ कि यह आर्किटेक्चर अगले एजेंट सत्र तक जीवित रहे, तो मैं JSON को कमिट करता हूँ।
00:04:07खेल के इस बिंदु पर, आर्किफाई को समझने का सबसे आसान तरीका यह है।
00:04:11सिस्टम मैप्स के लिए HTML VM के वास्ते, कोडिंग एजेंट फ्रंट एंड है।
00:04:15JSON मध्यवर्ती प्रतिनिधित्व है।
00:04:19HTML संकलित परिणाम है।
00:04:21और वह मध्य परत बहुत सारा काम कर रही है।
00:04:24JSON सख्त स्कीमा का पालन करता है।
00:04:26अज्ञात फ़ील्ड वैलिडेशन में विफल हो सकते हैं।
00:04:28और पाँच डिएग्राम मोड हैं।
00:04:30आर्किटेक्चर, वर्कफ़्लो, सीक्वेंस, डेटा फ़्लो और लाइफ़ साइकल।
00:04:34लेकिन सबसे दिलचस्प निर्णयों में से एक यह है कि मॉडल किस पर नियंत्रण नहीं रखता है।
00:04:38लेआउट।
00:04:39मॉडल सिस्टम का वर्णन करता है।
00:04:41यह बिल्कुल तय नहीं करता है कि हर बॉक्स कहाँ जाने वाला है।
00:04:44उन्होंने वास्तव में स्वचालित डिग्री लेआउट के साथ थीम वाले मरमेड की कोशिश की।
00:04:48यह सामान्य मरमेड से बेहतर नहीं था।
00:04:51और वैलिडेशन भी बंद होकर विफल हो जाता है।
00:04:54खराब JSON किसी भी तरह से सुंदर डिएग्राम नहीं बनता है।
00:04:58आपको डायग्नोस्टिक्स, रूल कोड और समर्थित मरम्मत मिलती है।
00:05:02अब, इन सब में से, यहाँ वह जगह है जहाँ मैं शायद आर्किफाई का उपयोग नहीं करूँगा।
00:05:06यदि आपको अपनी रीडमी फ़ाइल के अंदर सीधे डिएग्राम की आवश्यकता है, तो शायद नहीं।
00:05:10कुछ समय लग सकता है।
00:05:11गिटहब इसे रेंडर करता है।
00:05:12आर्किफाई HTML नहीं करता है।
00:05:15आर्किफाई यहाँ एक अलग तरह की समस्या को हल कर रहा है।
00:05:18लूप में पहले से ही एक एजेंट है।
00:05:20वह एजेंट एक आर्किटेक्चर आर्टिफ़ैक्ट तैयार कर रहा है।
00:05:23शायद यह PR में जाता है।
00:05:25शायद यह डिज़ाइन रिव्यू में जाता है।
00:05:27यहीं से चेक किया गया आउटपुट मायने रखता है।
00:05:30अब, इसके भीतर, मुझे यहाँ बहुत कुछ पसंद आया।
00:05:32यह उन टूल्स के अंदर रहता है जिनका हम पहले से ही हर दिन उपयोग कर रहे हैं।
00:05:35मैं आउटपुट बाहर भेज सकता हूँ।
00:05:38रेपो एविडेंस मुझे वास्तव में जाँचने के लिए कुछ ठोस देता है।
00:05:41और क्योंकि आर्किटेक्चर संरचित है, मैं इसे बिना चीज़ों के समय के साथ बदले लगातार संपादित कर सकता हूँ।
00:05:46यह इतना अच्छा भी दिखता है कि मुझे शायद फ़िग्मा या इस तरह के किसी अन्य टूल में इसे फिर से ड्रा करने की आवश्यकता महसूस नहीं होगी।
00:05:53लेकिन इन सबके साथ यह भी है कि साथ ही, आर्किफाई आपके आर्किटेक्चर को नहीं जानता है।
00:05:58एक ग्राफ पूरी तरह से मान्य हो सकता है और फिर भी गलत सिस्टम का वर्णन कर सकता है।
00:06:02आपको अभी भी इसे पढ़ना होगा।
00:06:03एक खराब मॉडल, जैसा कि हम जानते हैं, अक्सर ऐसा JSON बनाएगा जो काम करता है, लेकिन यह अभी भी खराब दिखता है।
00:06:08और यदि आपके डिएग्राम का अंतिम घर रीडमी है, तो मरमेड यहाँ अभी भी बेहतर हो सकता है।
00:06:13आर्किफाई के साथ, आप शायद JSON और HTML को कमिट कर रहे हैं या आप एक इमेज एक्सपोर्ट कर रहे हैं।
00:06:18और एक ऐसी गलती है जिससे मैं निश्चित रूप से बचना चाहूँगा।
00:06:21इसे किसी विशाल रेपो पर पॉइंट न करें और कहें, सब कुछ मैप करो।
00:06:25मुझे लगता है कि आप अंदाज़ा लगा सकते हैं कि यह कैसा होने वाला है क्योंकि आपको शायद वापस कचरे का ढेर ही मिलने वाला है।
00:06:29लेकिन यह वास्तव में आर्किफाई की विफलता नहीं है।
00:06:32यह बल्कि एक बुरा सवाल है।
00:06:34यदि आप पहले से ही कोडिंग एजेंटों के साथ काम करते हैं और नियमित रूप से ऐसे डिएग्राम बनाते हैं जिन्हें आप भविष्य में देखने जा रहे हैं या कोई और देख सकता है, तो यह समझ में आता है।
00:06:42पीआर रिव्यू, डिज़ाइन डॉक्स, मैं शायद इसका उपयोग करूँगा।
00:06:47मैं इसे इसलिए इंस्टॉल नहीं करूँगा क्योंकि मैं किसी ऐसी चीज़ का सुंदर संस्करण चाहता हूँ जो हमारे पास पहले से है, उदाहरण के लिए मरमेड।
00:06:52और मैं निश्चित रूप से इससे मेरे लिए किसी भी चीज़ को रिवर्स-इंजीनियर करने की उम्मीद नहीं करूँगा।
00:06:55कोशिश करने की बाधा वास्तव में बहुत कम है।
00:06:58एक MPX कमांड, मशीन पर नोड।
00:07:00यहाँ कोई मॉडल वेट नहीं हैं।
00:07:02मेरा M4 Pro मूल रूप से इसमें अप्रासंगिक है।
00:07:05लेकिन एक नियम है जिसका मैं पालन करूँगा।
00:07:07प्रति फ़ाइल एक प्रश्न।
00:07:08यदि आप यह स्पष्ट रूप से नहीं बता सकते कि डिएग्राम किस प्रश्न का उत्तर दे रहा है, तो डिएग्राम जनरेट न करें।
00:07:14मैं बेटरस्टैक से जोश हूँ।
00:07:15यदि आपको इस तरह के कोडिंग टिप्स और ट्रिक्स पसंद हैं, तो चैनल को सब्सक्राइब करना न भूलें।
00:07:19हम आपसे दूसरे वीडियो में मिलेंगे।
00:07:20हम आपसे दूसरे वीडियो में मिलेंगे।

Key Takeaway

आर्किफाई कोडिंग एजेंटों द्वारा तैयार किए गए टाइप्ड JSON और लोकल कंपाइलर के माध्यम से सिस्टम आर्किटेक्चर को सत्यापित और विजुअलाइज करता है, जिससे डेवलपर्स को सटीक 8 से 12 नोड्स वाले डायग्राम मिलते हैं।

Highlights

  • आर्किफाई (Archify) कुछ ही महीनों में 44,000 स्टार्स हासिल कर चुका है क्योंकि यह सीधे क्लाउड कोड, कर्सर और कोडेक्स से जुड़ जाता है।

  • यह टूल कोडबेस को सीधे ड्रा करने के बजाय एक संरचित, टाइप्ड JSON के रूप में वर्णित करता है, जिसे लोकल कंपाइलर द्वारा फाइनल HTML में बदला जाता है।

  • नोड्स में एक कमिट और एक विशिष्ट लाइन रेंज से बंधे रेपो साक्ष्य शामिल होते हैं, और प्रमाण न होने पर नोड को एसआरसी बैज नहीं मिलता है।

  • यह सिस्टम आर्किटेक्चर को विजुअलाइज करने के लिए आर्किटेक्चर, वर्कफ़्लो, सीक्वेंस, डेटा फ़्लो और लाइफ़ साइकल जैसे पाँच डिएग्राम मोड प्रदान करता है।

  • आर्किफाई का उपयोग करने का सबसे अच्छा नियम प्रति फ़ाइल एक प्रश्न पूछना है ताकि बेकार और कचरे जैसा डेटा मिलने से बचा जा सके।

Timeline

आर्किफाई की कार्यप्रणाली और स्थापना

  • कोडिंग एजेंट अक्सर अवास्तविक और छूटे हुए घटकों के साथ डायग्राम बनाते हैं।
  • आर्किफाई सिस्टम को संरचित JSON के रूप में वर्णित करता है, जो अमान्य होने पर फेल हो जाता है।
  • इसे एक कमांड से एजेंट स्किल के रूप में स्थापित किया जाता है।

पारंपरिक कोडिंग एजेंट अक्सर ऐसे डायग्राम बनाते हैं जिनमें काफ्का या रेडिस जैसे काल्पनिक गेटवे होते हैं। आर्किफाई एजेंट को कुछ भी खुद ड्रा करने के बजाय टाइप्ड JSON आउटपुट देने के लिए कहता है, जिसे लोकल कंपाइलर HTML में बदलता है।

विजुअलाइजेशन और कोड संपादन

  • ठोस सवाल पूछकर 8 से 12 नोड्स वाला फ्लोचार्ट तैयार किया जाता है।
  • नोड्स में विशिष्ट कमिट और लाइन रेंज से जुड़े रेपो साक्ष्य होते हैं।
  • दो वैलिडेटेड स्नैपशॉट की तुलना करके जोड़े या हटाए गए बदलावों को देखा जा सकता है।

एजेंट से पूरा कोडबेस मैप करने के बजाय एक ठोस सवाल पूछा जाता है। नोड्स में कमिट और लाइन रेंज के प्रमाण होते हैं, जिससे अपस्ट्रीम और डाउनस्ट्रीम घटकों को आसानी से ट्रैक किया जा सकता है।

सीमाएँ और सही उपयोग के मामले

  • मॉडल केवल सिस्टम का वर्णन करता है और लेआउट तय नहीं करता है।
  • इसे सीधे रीडमी फ़ाइल में उपयोग करना सही नहीं है क्योंकि गिटहब HTML रेंडर नहीं करता है।
  • विशाल रेपो पर इसे एक साथ सब कुछ मैप करने के लिए पॉइंट नहीं करना चाहिए।

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

Community Posts

No posts yet. Be the first to write about this video!

Write about this video