Tutorial 1 Orientation ur

ٹیوٹوریل ۱ · تعارف

🌎 زبان: اردو — تمام ۳۳ زبانیں دیکھیں

مقصد: پروجیکٹ کو چلانا، اپنے AI ایجنٹ سے ملنا، اور ایک بار ٹیسٹ گیٹ چلانا — تاکہ اس کے بعد سب کچھ عادت بن جائے۔

← صفحۂ اول پر واپس · اگلا: ٹیوٹوریل ۲ کوڈ کیسے کام کرتا ہے

---

۱. ایک مذاق ایپ کیوں؟

کسی کوڈنگ ایجنٹ کے ساتھ کام کرنا سیکھنا سب سے آسان تب ہوتا ہے جب کوڈ چھوٹا، حقیقی اور کم-داؤ ہو۔ LockedIn CLI تینوں ہے:

• چھوٹا: ایک کور فائل، ایک اینٹری پوائنٹ، ایک ٹیسٹ سویٹ، صفر انحصار۔
• حقیقی: یہ ایک عالمی lockedin کمانڈ کے طور پر انسٹال ہوتا ہے اور ایک حقیقی AI CLI کی طرح برتاؤ کرتا ہے۔
• کم-داؤ: یہ طنز ہے۔ اگر آپ کا ایجنٹ humblebrags کو ۲۰٪ زیادہ عاجزانہ بنا دے، تو کسی کو پیج نہیں کیا جائے گا۔

یہ امتزاج آپ کو اصل مہارت پر توجہ دینے دیتا ہے: کسی تبدیلی کو اچھی طرح بیان کرنا، ایجنٹ کو کام کرنے دینا، اور نتیجے کی تصدیق کرنا۔

۲. کوڈ حاصل کریں

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

اپنا Node ورژن چیک کریں (18+ درکار ہے):

node --version

انسٹال کرنے کے لیے کچھ نہیں ہے — انحصار کا کوئی npm install نہیں، کیونکہ کوئی ہے ہی نہیں۔ یہ جان بوجھ کر ہے: کم حرکت پذیر پرزے، زیادہ سیکھنا۔

۳. اسے چلائیں

اصل چیز آزمائیں:

node bin/lockedin.js            # ابتدائی اسکرین + بینر
node bin/lockedin.js post       # تیار کردہ «فکری قیادت» پوسٹ
node bin/lockedin.js aura       # اپنی پیشہ ورانہ آرا اسکین کریں
node bin/lockedin.js            # (کوئی آرگومنٹ نہیں) چیٹ سیشن میں لے جاتا ہے

سیشن کے اندر /help ٹائپ کریں، اِدھر اُدھر دیکھیں، پھر /exit۔ جو کچھ آپ دیکھتے ہیں وہ مقامی طور پر لفظ پولز سے بنتا ہے — کوئی نیٹ ورک نہیں، کوئی اکاؤنٹ نہیں۔ کمانڈز کی مکمل فہرست: کمانڈ ریفرنس۔

۴. ٹیسٹ گیٹ چلائیں

یہ پورے ٹیوٹوریل کی سب سے اہم کمانڈ ہے:

npm test

آپ کو سبز چیکس کی ایک دیوار نظر آنی چاہیے جو کچھ اس طرح ختم ہو pass 318۔ وہ سویٹ آپ کا حفاظتی جال ہے۔ یہاں سے آگے، ورک فلو ہمیشہ یہی ہے:

کچھ بدلیں → npm test → صرف تب شپ کریں جب یہ سبز ہو۔

۵. اپنے ایجنٹ سے ملیں

اپنے کوڈنگ ایجنٹ کو پروجیکٹ فولڈر میں کھولیں تاکہ وہ فائلیں دیکھ سکے۔ GitHub Copilot CLI کے ساتھ، یہ ہے:

copilot

پھر، اپنے آپ کو سمجھنے کے لیے، ایجنٹ سے کہیں کہ وہ آپ کا تعارف کرائے (ابھی کچھ نہ بدلے)۔ ایک ایسا پرامپٹ آزمائیں:

"مجھے اس ریپازٹری کا دو-پیراگراف دورہ دو: ہر اعلیٰ-سطح فائل اور فولڈر کس لیے ہے، اور میں ایپ اور ٹیسٹ کیسے چلاؤں۔ کچھ مت بدلو۔"

اس کے جواب کو اس کے مقابل پڑھیں جو آپ نے مراحل ۳–۴ میں دیکھا۔ ایجنٹ سے ایڈٹ کرنے سے پہلے وضاحت کرانے کی عادت ڈالنا ایک بنیادی عادت ہے — ہم اس پر خوب انحصار کریں گے۔

---

✅ اپنے ایجنٹ کے ساتھ آزمائیں

1. ایجنٹ سے پوچھیں: "node bin/lockedin.js reflect 'میری کافی ٹھنڈی تھی' کیا پرنٹ کرتا ہے، اور کون سی فائل اس آؤٹ پٹ کا فیصلہ کرتی ہے؟" خود کمانڈ چلا کر اس کے جواب کی تصدیق کریں۔
2. اس سے کہیں کہ ٹیسٹ سویٹ چلائے اور نتیجہ رپورٹ کرے: "npm test چلاؤ اور بتاؤ کتنے چیکس پاس ہوتے ہیں۔"

اب آپ نے ایپ، ٹیسٹ، اور ایجنٹ دیکھ لیا ہے۔ اگلا، ہم دیکھیں گے کہ یہ کوڈ بیس اتنا ایجنٹ-دوست کیوں ہے — وہ ڈیزائن جو آپ کو اعتماد کے ساتھ تبدیلیاں سونپنے دیتا ہے۔

اگلا: ٹیوٹوریل ۲ کوڈ کیسے کام کرتا ہے