Tutorial 1 Orientation bn

টিউটোরিয়াল ১ · পরিচিতি

লক্ষ্য: প্রকল্পটি চালু করুন, আপনার AI এজেন্টের সঙ্গে পরিচিত হন, এবং একবার টেস্ট গেট চালান — যাতে এরপরের সবকিছু হাতের অভ্যাসে পরিণত হয়।

← হোম-এ ফিরুন · পরবর্তী: টিউটোরিয়াল ২ কোড কীভাবে কাজ করে

---

১. একটি রসিকতার অ্যাপ কেন?

একটি কোডিং এজেন্টের সঙ্গে কাজ করা শেখা তখনই সবচেয়ে সহজ যখন কোডটি ছোট, সত্যিকারের, এবং কম ঝুঁকির। LockedIn CLI তিনটিই:

• ছোট: একটি core ফাইল, একটি entry point, একটি test suite, zero dependency।
• সত্যিকারের: এটি একটি global lockedin কমান্ড হিসেবে install হয় এবং একটি সত্যিকারের AI CLI-র মতো আচরণ করে।
• কম ঝুঁকির: এটি স্যাটায়ার। আপনার এজেন্ট যদি humblebrag-গুলোকে ২০% বেশি বিনয়ী করে ফেলে, কারো কাছে alert যাবে না।

এই সংমিশ্রণ আপনাকে আসল দক্ষতায় মন দিতে দেয়: একটি পরিবর্তন ভালোভাবে বর্ণনা করা, এজেন্টকে কাজটা করতে দেওয়া, এবং ফলাফল যাচাই করা।

২. কোডটি নিন

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

আপনার Node সংস্করণ পরীক্ষা করুন (18+ দরকার):

node --version

install করার কিছু নেই — dependency-র কোনো npm install নেই, কারণ dependency-ই নেই। এটা ইচ্ছাকৃত: কম নড়াচড়ার অংশ, বেশি শেখা।

৩. এটি চালান

আসল জিনিসটা করে দেখুন:

node bin/lockedin.js            # splash + banner
node bin/lockedin.js post       # একটি তৈরি করা "thought-leadership" post
node bin/lockedin.js aura       # আপনার professional aura scan করুন
node bin/lockedin.js            # (কোনো arg ছাড়া) আপনাকে chat session-এ নামায়

session-এর ভেতরে /help টাইপ করুন, ঘুরে দেখুন, তারপর /exit। আপনি যা দেখছেন সবই word pool থেকে স্থানীয়ভাবে তৈরি — কোনো network নেই, কোনো account নেই। সম্পূর্ণ কমান্ড তালিকা: কমান্ড রেফারেন্স।

৪. টেস্ট গেট চালান

এটাই গোটা টিউটোরিয়ালের সবচেয়ে গুরুত্বপূর্ণ কমান্ড:

npm test

আপনার pass 318-এর মতো কিছুতে শেষ হওয়া সবুজ টিকের একটি দেয়াল দেখা উচিত। ওই suite হলো আপনার নিরাপত্তা জাল। এখান থেকে, workflow সবসময়:

কিছু একটা বদলান → npm test → সবুজ হলে তবেই ship করুন।

৫. আপনার এজেন্টের সঙ্গে পরিচিত হন

আপনার কোডিং এজেন্টকে প্রকল্প ফোল্ডারের ভেতরে খুলুন যাতে সে ফাইলগুলো দেখতে পারে। GitHub Copilot CLI দিয়ে সেটা হলো:

copilot

তারপর, নিজের অবস্থান বুঝতে, এজেন্টকে বলুন আপনাকে orient করাতে (এখনই কিছু না বদলে)। এমন একটি prompt চেষ্টা করুন:

"এই repository-র একটি দুই-অনুচ্ছেদের tour দাও: প্রতিটি top-level ফাইল ও ফোল্ডার কীসের জন্য, এবং আমি অ্যাপ ও test কীভাবে চালাই। কিছু বদলিও না।"

তার উত্তরটি ৩–৪ ধাপে যা দেখেছেন তার সঙ্গে মিলিয়ে পড়ুন। এজেন্টকে edit করার আগে ব্যাখ্যা করতে বলার অভ্যাসে স্বচ্ছন্দ হওয়া একটি মূল অভ্যাস — আমরা এর উপর বহুবার নির্ভর করব।

---

✅ আপনার এজেন্ট দিয়ে করে দেখুন

1. এজেন্টকে জিজ্ঞেস করুন: "node bin/lockedin.js reflect 'আমার কফি ঠান্ডা ছিল' কী print করে, এবং কোন ফাইল সেই output ঠিক করে?" কমান্ডটি নিজে চালিয়ে তার উত্তর নিশ্চিত করুন।
2. তাকে test suite চালিয়ে ফলাফল জানাতে বলুন: "npm test চালাও এবং বলো কতগুলো check পাস করে।"

আপনি এখন অ্যাপ, test, এবং এজেন্ট — তিনটিই দেখেছেন। এরপর আমরা দেখব এই codebase কেন এত এজেন্ট-বান্ধব — যে ডিজাইন আপনাকে আত্মবিশ্বাসের সঙ্গে পরিবর্তন হস্তান্তর করতে দেয়।

পরবর্তী: টিউটোরিয়াল ২ কোড কীভাবে কাজ করে