सॉफ्टवेयर इंजीनियरिंग
रिपॉज़िटरी आर्किटेक्चर ग्राफ़ बनाएँ
रिपॉज़िटरी का परतदार नक्शा जो entry points, modules, data stores, external systems और ownership को जोड़ता है, ताकि इंजीनियर बदलाव के प्रभाव को देख सकें और ग्राफ़ को पूर्ण होने का दावा न करें।
प्रक्रिया
इस क्रम में करो।
- रिपॉज़िटरी संशोधन, भाषाएँ, ग्राफ का उद्देश्य, अभिप्रेत विवरण-स्तर और वे प्रश्न तय करें जिनका उत्तर ग्राफ में मिलना चाहिए।
- प्रवेश-बिंदु, build और deployment फ़ाइलें, पैकेज, सेवाएँ, डेटा-स्टोर, कतारें, बाहरी एकीकरण और जनित या vendored क्षेत्रों की सूची बनाएँ।
- उपलब्ध स्रोत और रिपॉज़िटरी प्रमाण से imports, calls, events, configuration और data flows ट्रेस करें, सटीक पथ और विश्वास दर्ज करें।
- नोड्स और संबंधों को उपयोगी system, container, component और code परतों में व्यवस्थित करें, अलग-अलग ज़िम्मेदारियों को एक बॉक्स में न मिलाएँ।
- स्वामी, परीक्षण, दस्तावेज़, runtime निर्भरताएँ और बाहरी-सिस्टम लेबल जोड़ें, और अनुमानित, पुराने या अनुपलब्ध संबंध स्पष्ट रूप से चिह्नित करें।
- ग्राफ को प्रतिनिधि journeys, builds और tests से सत्यापित करें, फिर drift, missing edges और हर सुधार के अगले स्वामी को दर्ज करें।
- legend, evidence links, update trigger, coverage limits और अनसुलझे जोखिम सहित versioned graph या diagram प्रकाशित करें, बिना शर्त के पूर्ण map कहे।
यह लाओ
इनपुट जो बिल्ली मांगेगी।
- रिपॉज़िटरी और संशोधन
- आर्किटेक्चर प्रश्न और दायरा
- उपलब्ध कोड और इतिहास पहुँच
- वांछित दर्शक और अपडेट स्वामी
राउटर + एक playbook
पहले रूट करो। एक चुनो।
Cat Paw हर काम पर एक playbook खोलता है, कई को मिलाता नहीं। इस राउटर से शुरू करो; बाकी रास्ते इसी workflow के उम्मीदवार हैं।
- राउटर:
code-graph-pack skills/code-graph-pack/repository-architecture-graph/SKILL.md
सीमाएँ
सीमाएँ प्रॉम्प्ट के साथ चलती हैं।
- शुरू करने से पहले वास्तविक टूल, खाते, अनुमतियों और वर्कस्पेस की जाँच करें; कभी न कहें कि अनुपलब्ध टूल, खाता, स्रोत या क्षमता मौजूद है।
- निजी कोड, कलाकृत, लाइव जाँच या गैर-सार्वजनिक डेटा के लिए Latch/target-workspace का उपयोग करें; यह पहुँच उपलब्ध न हो तो अनुमान के बजाय सीमा पर रुककर अड़चन बताएँ।
- महत्वपूर्ण बाहरी कार्रवाई से पहले स्पष्ट स्वीकृति के लिए रुकें; प्रमाण, अनसुलझे जोखिम, मान्यताएँ और स्वीकृति की प्रतीक्षा में कोई भी कार्रवाई लौटाएँ।
पूरा मतलब
एक जाँचने लायक अंत।
संस्करणित repository architecture graph सत्यापित घटकों और flows को source evidence, ownership, tests, confidence, coverage limits और अनसुलझे जोखिम से जोड़ता है।
स्रोत
यह प्रक्रिया कहाँ से आई।
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- c4model.com/
- docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
स्रोत workflow का पैटर्न तय करते हैं। Reddit और कम्युनिटी पोस्ट, जहाँ हैं, अभ्यास की कहानी हैं — सार्वभौमिक तथ्य नहीं।