Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 11.1 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 11.1 KB
Raw

CLAUDE.md (हिन्दी)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

@AGENTS.md

सभी प्रोजेक्ट नियम AGENTS.md में हैं — प्रत्येक AI सहायक के लिए सत्य का एकमात्र स्रोत (आर्किटेक्चर, परंपराएँ, परीक्षण, गुणवत्ता द्वार, git वर्कफ़्लो, 23 कठोर नियम, PII से मिली सीख)। इसे पूरा पढ़ें; प्रोजेक्ट नियमों को यहाँ दोबारा न जोड़ें। नीचे दी गई हर चीज़ केवल Claude Code पर लागू होती है — AGENTS.md में पहले से परिभाषित नियमों के परिचालन संबंधी परिशोधन।

वर्कट्री आइसोलेशन — Claude Code के लिए विशिष्ट बातें

पूर्ण अनिवार्य वर्कट्री प्रोटोकॉल (बेस-ब्रांच पुष्टि, .claude/worktrees/ कैनोनिकल पथ, cp -al node_modules, टियरडाउन नियम) docs/ops/WORKTREE_ISOLATION.md में है (AGENTS.md → Git Workflow → "Worktree isolation" में सारांशित)। Claude Code-विशिष्ट बातें:

  • ऑपरेटर से AskUserQuestion के माध्यम से बेस ब्रांच की पुष्टि करें (हार्ड रूल #19), जब तक कि उन्होंने पहले से ही आपको न बता दिया हो।
  • नेटिव EnterWorktree टूल को प्राथमिकता दें — यह पहले से ही .claude/worktrees/ (कैनोनिकल पथ) के तहत वर्कट्री बनाता है। दस्तावेज़ीकृत git worktree add कमांड से वर्कट्री बनाएं, फिर उसके path के साथ EnterWorktree को कॉल करें।

क्रॉस-सेशन सुरक्षा — Claude Code की विशिष्टताएँ

कठोर नियम #19/#21/#22 (AGENTS.md में) समानांतर सेशन को नियंत्रित करते हैं। इस हार्नेस के लिए परिचालन अनुस्मारक:

  • git को प्रभावित करने वाले प्रत्येक सबएजेंट के प्रॉम्प्ट में git stash प्रतिबंध को शब्दशः दोहराएँ (Agent टूल / Workflow स्क्रिप्ट) — सबएजेंट इस फ़ाइल को इनहेरिट नहीं करते, और stash घटना की दर्ज पुनरावृत्ति एक सबएजेंट के माध्यम से हुई थी।
  • किसी ऐसे PR में मर्ज या पुश करने से पहले जिसे आपने इस सेशन में नहीं बनाया है, git worktree list चलाएँ और gh pr view <N> --json state,headRefOid की फिर से जाँच करें (कठोर नियम #22b)।
  • प्रत्येक सेशन को मुख्य चेकआउट उसी ब्रांच पर रखकर समाप्त करें, जिस पर वह शुरू हुआ था।

Superpowers / योजना आर्टिफ़ैक्ट — पथ ओवरराइड

_tasks/ परंपरा AGENTS.md → "Planning & Research Artifacts" में परिभाषित है। superpowers स्किल्स के डिफ़ॉल्ट docs/… की ओर संकेत करते हैं — उन डिफ़ॉल्ट को यहाँ ओवरराइड किया गया है। जब कोई superpowers स्किल "saved to docs/superpowers/plans/…" जैसा पथ घोषित करे, तो लिखने से पहले उसे समकक्ष _tasks/… पथ में बदलें:

आर्टिफ़ैक्ट (स्किल) डिफ़ॉल्ट (उपयोग न करें) इसके बजाय यहाँ सहेजें
योजनाएँ (writing-plans) docs/superpowers/plans/ _tasks/superpowers/plans/YYYY-MM-DD-<feature>.md
विनिर्देश / डिज़ाइन (brainstorming) docs/superpowers/specs/ _tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md
शोध (deep-research, तदर्थ) docs/research/ _tasks/research/…
हैंड-ऑफ़ (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

उन आर्टिफ़ैक्ट को _tasks/ रेपो के भीतर कमिट करें (git -C _tasks …), मुख्य रेपो में कभी नहीं।

स्क्रैच / अस्थायी फ़ाइलें — /tmp नहीं, _artifacts/ का उपयोग करें

यह प्रोजेक्ट हार्नेस के डिफ़ॉल्ट सेशन स्क्रैचपैड (/tmp/claude-*/…) को ओवरराइड करता है। अस्थायी/कार्यशील फ़ाइलें — एक्सपोर्ट, जेनरेट की गई zip फ़ाइलें, एकबारगी मध्यवर्ती आउटपुट, वह सब कुछ जिसे आप अन्यथा /tmp में रखते — इसके बजाय /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/ में लिखें।

  • _artifacts/ एक रूट _* पथ है: पहले से gitignored है (AGENTS.md → "Root _* paths"), केवल डिस्क पर रहता है, कभी ट्रैक नहीं किया जाता।
  • कारण: स्क्रैच आउटपुट को प्रोजेक्ट के भीतर (/tmp के बजाय) रखने से ऑपरेटर के लिए सभी अस्थायी चीज़ों को एक ही स्थान पर ढूँढना और हटाना आसान हो जाता है, बजाय उन अस्थायी सेशन-विशिष्ट /tmp डायरेक्टरियों में खोजने के जो गायब हो जाती हैं या बिना ट्रैक हुए जमा होती रहती हैं।
  • इसे _tasks/ (कठोर नियम #23, टिकाऊ योजनाओं/विनिर्देशों/शोध/हैंड-ऑफ़ के लिए इसका अपना निजी git रेपो) के साथ भ्रमित न करें — _artifacts/ केवल नष्ट की जा सकने वाली कार्यशील फ़ाइलों के लिए है, यहाँ किसी भी चीज़ को सुरक्षित रखने या वर्ज़न करने की आवश्यकता नहीं है।

PR खोलने से पहले बेस-ग्रीन

ब्रांच काटने या PR खोलने से पहले, बेस-ग्रीन जाँच चलाएँ (AGENTS.md → Git Workflow → "Base-green check"; प्रोजेक्ट स्किल्स इसे .agents/skills/_shared/base-green.md के रूप में संदर्भित करती हैं)। यदि बेस टिप रेड होने के दौरान कोई PR खोला जाता है, तो उसके बॉडी में ⚠️ base-red inherited: #<issue> होना चाहिए। संचित रेड स्थिति (बेस टिप + रेड PR) को समाप्त करने के लिए, /sweep-reds स्किल का उपयोग करें।