Claude Architect · पाठ

.claude/rules/ और Frontmatter Paths

नियम केवल matching files को संपादित करते समय लोड कीजिए।

पाठ 3, कुल 4 में से13 चरण

.claude/rules/ और Frontmatter Paths, CoddyKit पर Claude Architect का एक निःशुल्क पाठ है। यह 4 में से 3वाँ पाठ है। इस अध्ययन पथ के 3 तक कोई भी पाठ पूरा पढ़ना निःशुल्क है — इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ व्यावहारिक अभ्यास भी उपलब्ध कराता है। यह Claude Architect सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। Claude Architect पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

एकल CLAUDE.md की समस्या

जैसे-जैसे आपका प्रोजेक्ट बढ़ता है, एक ही CLAUDE.md में हर चीज़ के नियम इकट्ठे होने लगते हैं: React components, SQL migrations, CI scripts और Terraform। इनमें से हर नियम हर सत्र में संदर्भ में लोड होता है, भले ही आप केवल एक ही प्रकार की फ़ाइल पर काम कर रहे हों।

इससे टोकन व्यर्थ होते हैं और ध्यान बंटता है। मॉडल संदर्भ के आरंभ और अंत पर सबसे अधिक ध्यान देता है (बीच में खो जाने का प्रभाव), इसलिए नियमों की एक बहुत बड़ी फ़ाइल उस निर्देश को दबा सकती है जो संपादित की जा रही फ़ाइल के लिए वास्तव में महत्वपूर्ण है।

.claude/rules/ इस समस्या को हल करता है: नियमों को छोटी फ़ाइलों में बाँटें, जो केवल मिलान वाली फ़ाइलों को संपादित करते समय लोड हों।

पथ-सीमित नियम कैसे काम करते हैं

नियम की फ़ाइल .claude/rules/ में रहती है और YAML के फ्रंटमैटर खंड से शुरू होती है। मुख्य फ़ील्ड paths है: ग्लॉब प्रतिरूपों की एक सूची। नियम का मुख्य भाग तभी संदर्भ में डाला जाता है जब जिन फ़ाइलों पर आप काम कर रहे हैं वे इनमें से किसी प्रतिरूप से मेल खाती हों।

इसे सशर्त, फ़ाइल-जागरूक निर्देशों के रूप में समझें। कोई मिलान न होने पर नियम पूरी तरह संदर्भ से बाहर रहता है, जिससे वर्तमान कार्य के लिए संदर्भ-विंडो हल्की रहती है।

नियम की फ़ाइल की संरचना

यहाँ पथ-सीमित नियम का एक न्यूनतम उदाहरण है। फ्रंटमैटर --- वाली पंक्तियों से सीमित होता है; उसके बाद की हर चीज़ वह निर्देश है जो मिलान होने पर मॉडल को मिलता है।

यहाँ paths परीक्षण फ़ाइलों को लक्षित करता है, इसलिए यह मार्गदर्शन तभी दिखाई देता है जब आप tests संपादित कर रहे हों, production code को छूने पर नहीं।

---
paths:
  - "**/*.test.tsx"
  - "**/*.test.ts"
---

# Test Conventions

- Use the existing `renderWithProviders` helper, never bare `render`.
- One behavior per `it` block; describe blocks group by component.
- Mock network calls with MSW handlers from `test/mocks/`.

ग्लॉब प्रतिरूप ही सक्रियण संकेत हैं

paths के ग्लॉब, Claude Code के Glob tool द्वारा उपयोग की जाने वाली शैली के ही होते हैं, जैसे **/*.test.tsx। कुछ उपयोगी प्रतिरूप:

src/api/** — API directory के अंतर्गत आने वाली कोई भी चीज़
**/*.sql — रिपॉज़िटरी की हर SQL file
infra/**/*.tf — केवल infra के अंदर Terraform

दायरा कसकर रखें। **/* से मेल खाने वाला नियम उद्देश्य को विफल कर देता है: यह बस आपका पुराना एकल CLAUDE.md है, जिसके सिर पर फ्रंटमैटर की टोपी है।

पदानुक्रम में नियम कहाँ स्थित होते हैं

पथ-सीमित नियम CLAUDE.md के पदानुक्रम के ऊपर लागू होते हैं:

उपयोगकर्ता-स्तर ~/.claude/CLAUDE.md — व्यक्तिगत, VCS के माध्यम से साझा नहीं (नए साथियों से छूट जाता है)।
प्रोजेक्ट-स्तर ./CLAUDE.md या .claude/CLAUDE.md — VCS के माध्यम से साझा, हमेशा लोड होता है।
डायरेक्टरी-स्तर — एक उपवृक्ष तक सीमित।
.claude/rules/ और फ्रंटमैटर paths — प्रत्येक मिलान वाली फ़ाइल के अनुसार सशर्त रूप से लोड होता है।

CLAUDE.md में केवल वे कुछ नियम रखें जो सार्वभौमिक रूप से सही हैं। फ़ाइल-प्रकार-विशिष्ट नियमों को .claude/rules/ में भेज दें।

एक वास्तविक rules/ directory

नियमों को उनके उद्देश्य के अनुसार व्यवस्थित करें—हर फ़ाइल-प्रकार या क्षेत्र के लिए एक फ़ाइल। हर फ़ाइल अपना paths रखती है, इसलिए migration संपादित करने पर DB के नियम आते हैं, जबकि component संपादित करने पर React के नियम आते हैं, और इसका उलटा कभी नहीं होता।

# Project layout
.claude/
  CLAUDE.md            # small: universal project facts
  rules/
    react.md           # paths: src/**/*.tsx
    sql-migrations.md   # paths: db/migrations/**/*.sql
    ci-scripts.md       # paths: .github/workflows/**
    terraform.md        # paths: infra/**/*.tf

Migrations नियम का उदाहरण

Database के नियम अक्सर सख्त होते हैं और आसानी से भूल जाते हैं। उन्हें migration files तक सीमित करने का अर्थ है कि मार्गदर्शन ठीक उसी समय संदर्भ में रहेगा जब वह प्रासंगिक हो, और UI code लिखते समय अनुपस्थित रहेगा।

---
paths:
  - "db/migrations/**/*.sql"
---

# Migration Rules

- Every migration must be reversible: include a `-- DOWN` section.
- Never DROP a column in the same migration that stops writing to it.
- Wrap DDL in a transaction; add indexes CONCURRENTLY where supported.
- After inserts, re-sync sequences with setval(...).

Imports बनाम पथ-सीमित नियम

मॉड्यूलर बनाने के दो तरीके हैं, और वे एक जैसे नहीं हैं:

CLAUDE.md के अंदर @path imports, जैसे @./standards/coding-style.md, उस सामग्री को हमेशा शामिल करते हैं। व्यापक रूप से लागू होने वाले साझा मानकों के लिए यह उपयोगी है।
paths फ्रंटमैटर वाला .claude/rules/ सशर्त रूप से लोड होता है, केवल मिलान वाली फ़ाइलों को संपादित करते समय।

सामान्य नियम: यदि मार्गदर्शन किसी विशिष्ट फ़ाइल-प्रकार पर लागू होता है, तो उसे paths से सीमित करें। यदि वह हर जगह लागू होता है, तो import (या स्वयं CLAUDE.md) ठीक है।

<!-- Inside .claude/CLAUDE.md -->
# Project Standards
@./standards/coding-style.md   <!-- always loaded -->
@./standards/commit-format.md  <!-- always loaded -->

<!-- File-type specifics live in .claude/rules/*.md, loaded only on match -->

टोकन और ध्यान का लाभ

लाभ दोहरा है। पहला, कम टोकन: अप्रासंगिक नियमों के मुख्य भाग कभी विंडो में आते ही नहीं, इसलिए वास्तविक code और tool output के लिए जगह बचती है। दूसरा, अधिक केंद्रित ध्यान: मौजूद नियम आपकी वर्तमान फ़ाइलों से मेल खाते हैं, इसलिए React की त्रुटि ठीक करते समय मॉडल को Terraform के नियमों में छानबीन नहीं करनी पड़ती।

यह आपके स्थायी निर्देशों पर लागू वही अनुशासन है जिसमें लंबे tool output को केवल प्रासंगिक फ़ील्ड तक सीमित किया जाता है।

साझाकरण और गुप्त जानकारी

क्योंकि .claude/rules/ रिपॉज़िटरी में रहता है, यह प्रोजेक्ट-स्तर की CLAUDE.md की तरह VCS के माध्यम से साझा होता है। नए साथियों को वही सीमित मार्गदर्शन अपने-आप मिल जाता है, जो उपयोगकर्ता-स्तर की ~/.claude/CLAUDE.md उन्हें नहीं देगी।

नियमों की फ़ाइलों को code की तरह संभालें: उनकी समीक्षा करें और उनमें कभी गुप्त जानकारी न चिपकाएँ। यदि कोई नियम किसी integration का संदर्भ देता है, तो token commit करने के बजाय ${GITHUB_TOKEN} जैसे env vars की ओर संकेत करें।

डिज़ाइन जाँच-सूची

जब आप एकल CLAUDE.md को पथ-सीमित नियमों में बाँटें:

हर फ़ाइल-प्रकार या क्षेत्र के लिए एक फ़ाइल रखें; हर फ़ाइल को केंद्रित रखें।
paths ग्लॉब को नियम के वास्तविक दायरे जितना ही कसा हुआ रखें।
CLAUDE.md में केवल सार्वभौमिक तथ्य रखें; फ़ाइल-विशिष्ट नियमों को बाहर ले जाएँ।
हमेशा सक्रिय साझा मानकों के लिए @imports और सशर्त मानकों के लिए paths का उपयोग करें।
VCS में commit करें, ताकि पूरी टीम समान व्यवहार साझा करे।

परिणाम ऐसी संदर्भ-विंडो है जो आपके द्वारा संपादित की जा रही फ़ाइल के अनुसार ढलती है।

त्वरित जाँच: SQL नियम का दायरा सीमित करना

आपकी CLAUDE.md बढ़कर 600 lines की हो गई है और अधिकांश सत्रों में SQL को छुआ तक नहीं जाता, फिर भी विस्तृत migration नियम हर बार लोड होकर प्रासंगिक code को पीछे धकेल देते हैं। आप चाहते हैं कि ये migration नियम db/migrations/ के अंतर्गत फ़ाइलें संपादित करते समय केवल संदर्भ में आएँ और पूरी टीम के साथ साझा हों। सबसे अच्छा तरीका क्या है?

इंटरैक्टिव पाठ में इसका उत्तर दें

पुनरावलोकन

मुख्य बातें:

YAML फ्रंटमैटर paths वाली .claude/rules/*.md फ़ाइल नियम को केवल मिलान वाली फ़ाइलों को संपादित करते समय लोड करती है, जिससे एकल CLAUDE.md की तुलना में संदर्भ और टोकन बचते हैं।
paths **/*.test.tsx या db/migrations/**/*.sql जैसे Glob-शैली के प्रतिरूपों का उपयोग करता है; उनका दायरा कसकर रखें।
नियमों की फ़ाइलें VCS के माध्यम से साझा होती हैं, उपयोगकर्ता-स्तर की ~/.claude/CLAUDE.md के विपरीत।
हमेशा सक्रिय साझा मानकों के लिए @imports का उपयोग करें; सशर्त, फ़ाइल-प्रकार-विशिष्ट नियमों के लिए paths फ्रंटमैटर का उपयोग करें।
CLAUDE.md को छोटा और सार्वभौमिक रखें; अनुकूलनशील, हल्के संदर्भ के लिए फ़ाइल-विशिष्ट मार्गदर्शन को .claude/rules/ में भेज दें।

शुरुआत निःशुल्क

एआई शिक्षक के साथ Python सीखें — निःशुल्क

अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।

पाठ्यक्रम: 26
पाठ: 104

निःशुल्क सीखना शुरू करें पूरा पाठ्यक्रम देखें

अक्सर पूछे जाने वाले प्रश्न

क्या “.claude/rules/ और Frontmatter Paths” पाठ निःशुल्क है?

हाँ — Claude Architect अध्ययन पथ के 3 तक कोई भी पाठ, जिसमें “.claude/rules/ और Frontmatter Paths” भी शामिल है, यहाँ वेब पर पूरा पढ़ना निःशुल्क है। इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ इंटरैक्टिव अभ्यास भी उपलब्ध कराता है। Claude Architect पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

“.claude/rules/ और Frontmatter Paths” में मैं क्या सीखूँगा?

नियम केवल matching files को संपादित करते समय लोड कीजिए। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ Claude Architect का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।

क्या Claude Architect शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?

पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर Claude Architect शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 3वाँ पाठ है।

“.claude/rules/ और Frontmatter Paths” पाठ पूरा करने में कितना समय लगता है?

CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।

क्या मैं इस Claude Architect पाठ में कोड लिख और चला सकता हूँ?

हाँ। हर Claude Architect पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।

इस पाठ्यक्रम के सभी पाठ

उपयोगकर्ता / प्रोजेक्ट / डायरेक्टरी स्तर
@path इम्पोर्ट सिंटैक्स
.claude/rules/ और Frontmatter Paths
मोनोलिथ बनाम मॉड्यूलर नियम

← Claude Architect पर वापस जाएँ