Claude Code کو 10 منٹ میں ایک منظم AI تعمیراتی ٹیم کے طور پر ترتیب دیں

Claude Code سیٹ اپ کِٹ کیا کرتی ہے

Claude Code سیٹ اپ کِٹ پروجیکٹ کی یادداشت، انجینئرنگ کے اصول، معاون ایجنٹس، ٹیسٹنگ، لِنٹنگ اور تعیناتی کے حفاظتی اقدامات شامل کرکے Claude Code کو زیادہ منظم تعمیراتی ٹیم میں بدل دیتی ہے۔ یہ کاروباری مالکان، وائب کوڈرز، آئی ٹی ماہرین اور ان ڈویلپرز کے لیے بنائی گئی ہے جو چاہتے ہیں کہ Claude Code زیادہ نظم و ضبط کے ساتھ کام کرے۔

ورنہ Claude Code سیشنز کے درمیان پروجیکٹ کا اہم سیاق و سباق بھول سکتا ہے، مستقل حفاظتی اصولوں کے بغیر کام کر سکتا ہے، یا کسی خراب تبدیلی کو لائیو ایپلیکیشن تک پہنچا سکتا ہے۔ یہ کِٹ ایک ہی سیٹ اپ فائل سے کام کرنے والا پروجیکٹ ڈھانچا تیار کرکے ان مسائل کو حل کرتی ہے۔

یہ نئے اور موجودہ ریپوزٹریز کے ساتھ کام کرتی ہے۔ یہ خاص طور پر Cloudflare Workers کے لیے موزوں ہے، تاہم Vercel، Node اور Python جیسے اسٹیکس کے مطابق بھی ڈھل جاتی ہے۔

اہم خصوصیات

• پروجیکٹ کی یادداشت: CLAUDE.md اور docs/ ڈائریکٹری میں موجودہ لائیو حالت، اگلا کام اور کیے گئے فیصلے محفوظ رہتے ہیں۔
• بنیادی اصول: .claude/rules/ میں موجود فائلیں سیکیورٹی، ٹیسٹنگ، صاف کوڈ اور عام فہم زبان میں رابطے سے متعلق توقعات متعین کرتی ہیں۔
• سات معاون ایجنٹس: کم لاگت اور تیز ماڈلز تلاش، تعمیر، ٹیسٹنگ اور جانچ کا کام کر سکتے ہیں، جبکہ مرکزی ماڈل منصوبہ بندی اور جائزہ لیتا ہے۔
• خطرے پر مبنی لینز: چھوٹی، درمیانی اور بڑی تبدیلیوں کو بتدریج زیادہ مضبوط جانچ سے گزارا جاتا ہے۔
• پُش گارڈ: سیٹ اپ غلط منزل، فورس پُش اور ناکام جانچ کے ساتھ پُش کو روک سکتا ہے۔
• خودکار ٹیسٹس اور لِنٹ: تبدیلیوں کو صارفین تک پہنچنے سے پہلے جانچا جاتا ہے۔
• دستاویزات کی تازہ کاری: /update-docs کمانڈ اگلے سیشن کے لیے پیش رفت ریکارڈ کرتی ہے۔
• اختیاری اضافے: ان میں عوامی ریپوزٹری میں لیک کی جانچ، ہر پروجیکٹ کے لیے حفاظتی پُش گارڈ، اور آپ کے Claude سیٹ اپ کا بیک اپ بمعہ آزمودہ بحالی کا عمل شامل ہیں۔

سیٹ اپ کِٹ انسٹال کریں

مرحلہ 1: سیٹ اپ فائل ڈاؤن لوڈ کریں

ریپوزٹری میں موجود SETUP-CLAUDE-STRUCTURE.md کھولیں اور Download raw file منتخب کریں۔ ابتدا میں آپ کو صرف یہی فائل شامل کرنے کی ضرورت ہے۔

مرحلہ 2: اسے اپنے پروجیکٹ میں رکھیں

SETUP-CLAUDE-STRUCTURE.md کو اپنے پروجیکٹ کے روٹ فولڈر میں کاپی کریں۔ آپ موجودہ ریپوزٹری استعمال کر سکتے ہیں یا نئے، خالی فولڈر سے شروع کر سکتے ہیں۔

مرحلہ 3: Claude Code چلائیں

اسی پروجیکٹ فولڈر میں Claude Code کھولیں اور اسے سیٹ اپ کی ہدایات پر عمل کرنے کو کہیں:

Follow SETUP-CLAUDE-STRUCTURE.md

Claude پانچ مختصر سوالات پوچھتا ہے، ایک منصوبہ پیش کرتا ہے، اور ساختی تبدیلیاں کرنے سے پہلے آپ کی منظوری کا انتظار کرتا ہے۔ منصوبے کا جائزہ لیں اور تیار ہونے پر واضح تصدیق فراہم کریں۔

Claude Code .claude/ فولڈر کو محفوظ رکھتا ہے، اس لیے وہاں انفرادی فائلیں لکھنے سے پہلے یہ اجازت مانگ سکتا ہے۔ سیٹ اپ کی ان کارروائیوں کی منظوری ہو تو Allow منتخب کریں۔

سیٹ اپ کے دوران کیا ہوتا ہے

Claude پہلے آپ سے پروجیکٹ کے بارے میں معلومات لیتا ہے اور ٹیکنالوجی اسٹیک کی شناخت کرتا ہے۔ پھر یہ موجودہ کوڈ کے گرد مناسب ڈھانچا بناتا ہے، بجائے اس کے کہ ایپلیکیشن کے کام کرنے کا طریقہ تبدیل کرے۔

سیٹ اپ کا مقصد تنظیم، دستاویزات، جانچ کے مراحل اور ٹیسٹس شامل کرنا ہے۔ یہ آپ کی ایپلیکیشن کے رویے کو تبدیل نہیں کرتا۔ اگر آپ کے پاس پہلے سے CLAUDE.md فائل موجود ہے تو Claude آپ کا مواد برقرار رکھتا ہے، اسے مناسب جگہ منتقل کرتا ہے، اور پچھلے ورژن کو Git کی تاریخ میں محفوظ رہنے دیتا ہے۔

Cloudflare سے متعلق حصے وہاں چھوڑ دیے جاتے ہیں جہاں ان کا اطلاق نہ ہو۔ مثال کے طور پر، Node یا Python پروجیکٹ کو صرف Cloudflare کی ترتیب کے بجائے اس کے شناخت شدہ اسٹیک کے مطابق جانچ اور اصول ملتے ہیں۔

بنیادی استعمال

نیا کام کا سیشن شروع کریں

سیٹ اپ کے بعد پروجیکٹ ڈائریکٹری میں Claude Code کھولیں اور وہ کام بیان کریں جسے آپ مکمل کرنا چاہتے ہیں۔ تیار کردہ پروجیکٹ میموری Claude کو موجودہ حالت، آئندہ کام اور گزشتہ فیصلوں کا سیاق فراہم کرتی ہے۔

Help me add the next feature listed in the project documentation.

Claude پروجیکٹ کے اصول اور خطرے پر مبنی لینز استعمال کرکے طے کرتا ہے کہ تبدیلی کے لیے کتنی منصوبہ بندی، عمل درآمد، ٹیسٹنگ اور جائزہ درکار ہے۔

چھوٹی تبدیلی کی درخواست کریں

محدود تبدیلی کے لیے مطلوبہ نتیجہ واضح طور پر بیان کریں اور Claude سے اس کی تصدیق کرنے کو کہیں:

Make this small UI text change, run the relevant checks, and report what changed.

چھوٹا کام گرین لین میں انجام دیا جاتا ہے، جبکہ بڑی یا زیادہ خطرناک تبدیلیوں کو زیادہ وسیع جانچ سے گزارا جاتا ہے۔

سیشنز کے درمیان پیش رفت ریکارڈ کریں

کام کے سیشن کے اختتام پر دستاویزات کی کمانڈ چلائیں تاکہ پروجیکٹ کی یادداشت تازہ ترین پیش رفت کی عکاسی کرے:

/update-docs

یہ اگلے سیشن کے لیے موجودہ حالت محفوظ کرتی ہے، جس سے Claude صفر سے شروع کرنے کے بجائے مفید سیاق کے ساتھ کام شروع کر سکتا ہے۔

سیکیورٹی اور منظوری کے اصول

یہ کِٹ واضح منظوری اور کم سے کم رسائی کے اصولوں کے تحت بنائی گئی ہے:

• Claude ساختی تبدیلیاں کرنے سے پہلے پوچھتا ہے۔
• Claude کبھی پوچھے بغیر پُش نہیں کرتا، کیونکہ پُش سے ایپلیکیشن شائع ہو سکتی ہے۔
• خفیہ ناموں کو دستاویز کیا جا سکتا ہے، لیکن خفیہ اقدار کبھی محفوظ نہیں کی جاتیں۔
• اصول Claude کو .env اور .dev.vars جیسی حساس فائلیں کھولنے سے روکتے ہیں۔
• ٹیسٹس خالی خفیہ اقدار استعمال کرتے ہیں تاکہ وہ حقیقی سروسز تک رسائی حاصل نہ کر سکیں۔
• پُش گارڈ فورس پُش، غلط منزل پر پُش، اور جانچ ناکام ہونے کی صورت میں پُش کو روک سکتا ہے۔

جب Claude محفوظ سیٹ اپ فائلوں تک رسائی کی اجازت مانگے تو مطلوبہ کارروائی کا جائزہ لیں اور صرف اسی کام کی منظوری دیں جس کی آپ اس سے توقع رکھتے ہیں۔

اعلیٰ درجے کی تجاویز

جائزے کی محنت کو خطرے کے مطابق رکھنے کے لیے لینز استعمال کریں

تین لینز کو ایک ہلکے پھلکے تبدیلی کے انتظامی نظام کے طور پر سمجھیں۔ سبز رنگ چھوٹی تبدیلیوں، پیلا درمیانی تبدیلیوں، اور سرخ بڑی تبدیلیوں کے لیے ہے۔ جیسے جیسے ممکنہ اثر بڑھتا جائے، توقع رکھیں کہ تبدیلی کو تیار سمجھنے سے پہلے مزید منصوبہ بندی، تصدیق اور جائزے کی ضرورت ہوگی۔

پروجیکٹ کی یادداشت کو تازہ رکھیں

معنی خیز کام کے بعد /update-docs استعمال کریں، بجائے اس کے کہ طویل پروجیکٹ کے اختتام تک انتظار کریں۔ تازہ دستاویزات مستقبل کے سیشنز کو زیادہ قابلِ اعتماد بناتی ہیں اور فیصلوں کو نمایاں رکھتی ہیں۔

عوامی یا فعال پروجیکٹس کے لیے اختیاری حفاظتی اقدامات استعمال کریں

اگر پروجیکٹ عوامی ہے تو اختیاری لیک چیک فعال کرنے پر غور کریں۔ ایسے پروجیکٹس کے لیے جہاں حادثاتی تعیناتی باعثِ تشویش ہو، سیفٹی نیٹ پش گارڈ استعمال کریں۔ بیک اپ آپشن آپ کے Claude سیٹ اپ کو محفوظ رکھ سکتا ہے اور اس میں بحالی کا آزمودہ طریقۂ کار شامل ہے۔

کِٹ کو اپنے موجودہ فراہم کنندہ اور اسٹیک کے مطابق ڈھالیں

یہ کِٹ AI ایپلی کیشنز کے لیے OpenRouter کی تجویز دیتی ہے کیونکہ ایک کلید متعدد ماڈلز تک رسائی فراہم کر سکتی ہے، لیکن یہ آپ کو اسی فراہم کنندہ تک محدود نہیں کرتی۔ اگر آپ کا پروجیکٹ پہلے ہی کسی دوسرے فراہم کنندہ کو استعمال کرتا ہے تو موجودہ انتخاب برقرار رہتا ہے۔

Windows پر پش گارڈ ایک Bash اسکرپٹ ہے۔ WSL یا Git Bash استعمال کریں، اور درکار انسٹالیشن کے بارے میں Claude کی ہدایات پر عمل کریں۔

نتیجہ

Claude Code Setup Kit آپ کو خود ساختہ ڈھانچا تیار کرنے کی ضرورت کے بغیر Claude Code کے لیے ایک دہرائے جانے کے قابل پروجیکٹ ورک فلو فراہم کرتی ہے۔ ایک فائل ڈاؤن لوڈ کریں، اسے اپنے پروجیکٹ میں رکھیں، اور Claude سے اس کی پیروی کرنے کو کہیں۔ منظوری کے بعد آپ کو مستقل پروجیکٹ میموری، واضح قواعد، معاون ایجنٹس، خطرے کی بنیاد پر لینز، خودکار جانچیں، دستاویزات کی تازہ کاری، اور زیادہ محفوظ پش رویہ حاصل ہوتا ہے۔

تازہ ترین ورژن کے لیے ریپوزٹری کی CHANGELOG.md دیکھیں اور دستیاب ریلیزز کا جائزہ لیں۔ یہ پروجیکٹ CC BY 4.0 لائسنس کے تحت دستیاب ہے، جو Abdo Samy کو کریڈٹ دینے اور ریپوزٹری کا لنک شامل کرنے کے ساتھ استعمال، اشتراک اور ترمیم کی اجازت دیتا ہے۔