उपयोग
बड़े कोडबेस की ऑनबोर्डिंग
Apothem के लिए बड़े-कोडबेस सेटअप चेकलिस्ट: संदर्भ पदानुक्रम, स्किल, हुक, सिंबल खोज, और समीक्षा लय।
इस पृष्ठ का उपयोग तब करें जब कोई रिपॉज़िटरी एक ही प्रॉम्प्ट के लिए बहुत विस्तृत हो, पूरे-वृक्ष स्कैन महँगे पड़ते हों, या प्रत्येक सेवा के अपने बिल्ड और टेस्ट कमांड हों।
यहाँ से शुरू करें
- लक्षित परिवेश अडैप्टर इंस्टॉल या अपडेट करें, फिर
apothem verify --harness <name>चलाएँ। - रूट संदर्भ सतह को छोटा रखें: परियोजना मानचित्र, महत्वपूर्ण कमांड, और केवल पॉइंटर।
- जब लक्षित परिवेश स्तरित संदर्भ का समर्थन करे, तो स्थानीय परिपाटियों को कोड के पास रखें।
- विशेष प्रक्रियाओं को पथ फ़िल्टर के साथ
skills/,rules/, या कमांड दस्तावेज़ों में ले जाएँ। - व्यापक अन्वेषण के लिए केवल-पठन प्रत्यायोजित कर्मियों का उपयोग करें, फिर संपादन से पहले एक संक्षिप्त निष्कर्ष-समुच्चय वापस लाएँ।
- जहाँ प्रलेखित हो वहाँ कैश, जनित, बिल्ड, और वेंडर बहिष्करणों को परिवेश की अनदेखी-सतह में जोड़ें।
- उपलब्ध होने पर LSP या सिंबल टूलिंग का उपयोग करें; अन्यथा
rg, संकुचित पथ, और स्पष्ट फ़ाइल दायरों का उपयोग करें। - छुए गए कोड को कवर करने वाला सबसे संकीर्ण lint या टेस्ट कमांड चलाएँ; रिलीज़ से पहले पूर्ण गेट चलाएँ।
अभ्यास मानचित्र
| अभ्यास | Apothem बंधन |
|---|---|
| दुबला सदा-लोडेड संदर्भ | src/apothem/rules/token-budget-discipline.md सदा-सक्रिय नियमों को छोटा रखता है; रूट संदर्भ फ़ाइलों को केवल पॉइंटर और महत्वपूर्ण खामियाँ ही रखनी चाहिए। |
| माँग पर विशेषज्ञता | src/apothem/skills/README.md SKILL.md परिपाटी को परिभाषित करता है; पथ-फ़िल्टर्ड संगी नियम संकीर्ण प्रक्रियाओं को आधार संदर्भ से बाहर रखते हैं। |
| स्तरित संदर्भ | प्रत्येक परिवेश पंक्ति src/apothem/harnesses/<name>/capabilities.yml में layered_context_surface घोषित करती है; STANDARD-CONVENTION-PIN.md उस पंक्ति का प्राधिकार बना रहता है। |
| पृथक अन्वेषण | प्रत्यायोजित-कर्मी गाइड अलग संदर्भ विंडो और संक्षिप्त वापसी अनुबंधों को बाँधती है। |
| सिंबल नेविगेशन | lsp_symbol_navigation एक ट्रैक की गई क्षमता-सेल है। जब तक कोई वेंडर-समर्थित प्लगइन या टूल सतह पिन नहीं हो जाती, पंक्तियाँ tracked-gap बनी रहती हैं। |
| अनदेखी-सतह | context_ignore_surface प्रलेखित बहिष्करण तंत्र को दर्ज करता है। Claude Code अडैप्टर settings.json के permissions.deny के माध्यम से जनित और कैश बहिष्करणों को प्रक्षेपित करता है। |
| हुक अधिगम | पास-श्रेणी के हुक मौन रहते हैं। आवर्ती निष्कर्ष src/apothem/rules/persistent-conventions-vigilance.md में आर्टिफैक्ट-विकास चक्र के माध्यम से रूट किए जाते हैं। |
| आवधिक समीक्षा | हर तीन से छह माह में, और परिवेश या मॉडल के प्रमुख परिवर्तनों के बाद, *-maintenance योजना लय का उपयोग करते हुए एक कॉन्फ़िगरेशन समीक्षा चलाएँ। |
रखरखाव टिप्पणियाँ
मशीन-पठनीय परिवेश क्षमता पंक्ति चार बड़े-कोडबेस सेल रखती है:
context_ignore_surface, layered_context_surface, lsp_symbol_navigation,
और hook_learning_capture। जब भी कोई वेंडर सतह बदले, इन सेलों को सहोदर
STANDARD-CONVENTION-PIN.md के साथ समकालिक रखें।
स्रोत संदर्भ: बड़े-कोडबेस अभ्यास, सेटिंग्स अनुमतियाँ।