नामकरण परंपराएँ
kebab-case फ़ाइल नाम, frontmatter कुंजी प्रारूप, टाइप उपसर्गों के साथ ब्रांच नामकरण, और क्रमबद्ध आर्टिफ़ैक्ट अनुक्रमों के लिए संख्यात्मक उपसर्ग शब्दार्थ निर्धारित करता है।
पूरे पारिस्थितिकी तंत्र में फ़ाइल नाम, पहचानकर्ता और ब्रांच नाम के स्वरूप के लिए विहित संदर्भ।
CLAUDE.mdपरंपराओं में दिया गया सारांश इनलाइन घोषणा है; यह पृष्ठ वह स्वतंत्र संदर्भ है जिसे डाउनस्ट्रीम योगदानकर्ता उद्धृत करते हैं।
1. फ़ाइल सिस्टम नाम
फ़ाइलें और फ़ोल्डर डिफ़ॉल्ट रूप से kebab-case का उपयोग करते हैं। पहचानकर्ताओं में कोई रिक्त स्थान, कोई अंडरस्कोर, और कोई कैमल-केस नहीं होता।
विहित अपरकेस अपवाद उन प्रकाशन-सतह सिंगलटन फ़ाइलों के लिए आरक्षित हैं जिन्हें हर योगदानकर्ता पहली ही मुठभेड़ में पहचान लेता है: CLAUDE.md, README.md, LICENSE, CHANGELOG.md, SECURITY.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md, और प्लान-सूट सिंगलटन (MASTER-PLAN.md, PROGRESS.md, PHASE.md, SKILL.md, VERSION)। बाकी हर फ़ाइल kebab-case का उपयोग करती है।
2. frontmatter कुंजियाँ
कमांड frontmatter की कुंजियाँ kebab-case का उपयोग करती हैं (उदाहरण के लिए, argument-hint, disable-model-invocation, allowed-tools)। स्किल की कुंजियाँ kebab-case का उपयोग करती हैं, सिवाय userInvocable के, जो स्रोत कॉर्पस द्वारा उपयोग की गई camelCase वर्तनी है; Claude Code इंस्टॉल उसका नाम user-invocable कर देता है। नियम और प्रत्यायोजित-कार्यकर्ता की कुंजियाँ camelCase हैं (उदाहरण के लिए, pathFilter, alwaysApply, maxTurns, disallowedTools)। frontmatter स्कीमा की आवश्यक-कुंजी तालिका हर वर्ग की कुंजियाँ सूचीबद्ध करती है।
3. ब्रांच नाम
ब्रांच <type>/<short-description> का अनुसरण करते हैं, जहाँ टाइप बंद समुच्चय {feat, fix, chore, docs, refactor, test, perf, ci, build, style, revert, release} से लिया जाता है। विवरण kebab-case में और पचास वर्णों से कम होता है।
4. संख्यात्मक उपसर्ग
फ़ाइल सिस्टम पथों पर संख्यात्मक उपसर्ग (NN-) क्रम का संप्रेषण करते हैं और केवल वहीं लागू होते हैं जहाँ क्रम अंतर्निहित है — चरण फ़ोल्डर, उप-चरण फ़ोल्डर, माइग्रेशन स्क्रिप्ट, और कोई भी अन्य आर्टिफ़ैक्ट वर्ग जिसका अनुक्रम अनुबंध का हिस्सा है। जिन रूट-स्तरीय सिंगलटन के पास कोई सहोदर अनुक्रम नहीं है, वे कोई संख्यात्मक उपसर्ग नहीं लेते; उपसर्ग जोड़ना एक ऐसे क्रम संबंध का गलत संकेत देता है जो मौजूद नहीं है। पूर्ण अनुशासन src/apothem/rules/canonical-layout.md §2.1 में रहता है।
5. सत्यापनकर्ता
src/apothem/conformity/naming_grep.py पर naming-grep यांत्रिक प्रवर्तन सतह है। CI इसे make validate के माध्यम से आह्वान करता है।
settings.json दस्तावेज़ीकरण
Apothem इकोसिस्टम के लिए Claude Code हुक निष्पादन, अनुमतियाँ, इवेंट, टाइमआउट, Python रनटाइम, सत्यापन और स्तरित सेटिंग्स प्राथमिकता कॉन्फ़िगर करें।
Frontmatter स्कीमा
YAML frontmatter ब्लॉक संरचना, प्रति-वर्ग आवश्यक कुंजियों, और सभी आर्टिफ़ैक्ट वर्गों में वैलिडेटर प्रवर्तन नियमों के लिए संदर्भ मार्गदर्शिका।