🪐 অ্যান্টিগ্র্যাভিটি সহ একটি এআই অ্যাপ তৈরি ও প্রকাশ করুন

১. ভূমিকা ও প্রস্তুতি

স্বাগতম

হাই! কোডিং জ্যামে আপনাকে স্বাগতম। পরবর্তী ৭৫ মিনিটে, আপনি একটি বাস্তব ও কার্যকরী এআই ওয়েব অ্যাপ তৈরি করবেন।

ওয়েবসাইটটি এখানে দেখুন : কোডিং জ্যাম ওয়েবসাইট

আপনি যা তৈরি করবেন

এই সপ্তাহের প্রজেক্ট ব্রিফের উপর ভিত্তি করে তৈরি একটি এআই-চালিত ওয়েব অ্যাপ। এটি আপনার ব্রাউজারে চলে। এতে গুগলের জেমিনি এআই ব্যবহৃত হয়েছে। সেশন শেষ হওয়ার আগেই এটি সম্পূর্ণরূপে আপনার হয়ে যাবে।

অ্যান্টিগ্র্যাভিটি ইনস্টল করুন

অ্যান্টিগ্র্যাভিটি হলো সেই এআই অ্যাসিস্ট্যান্ট যা আমরা সবকিছুর জন্য ব্যবহার করব। এটি আপনার কম্পিউটারে ইনস্টল করার একটি অ্যাপ।

ধাপ ১ — ডাউনলোড করুন

👉 আপনার ব্রাউজারে https://antigravity.google/download -এ যান।

👉 আপনার অপারেটিং সিস্টেমের (ম্যাক, উইন্ডোজ বা লিনাক্স) জন্য Antigravity 2.0- এর ডাউনলোড বাটনে ক্লিক করুন।

👉 ডাউনলোড করা ইনস্টলারটি চালান। ডিফল্ট সেটিংস ঠিক আছে — সেগুলো ক্লিক করে এগিয়ে যান।

ধাপ ২ — চালু করুন এবং সাইন ইন করুন

👉 আপনার অ্যাপ্লিকেশনস ফোল্ডার (ম্যাক) বা স্টার্ট মেনু (উইন্ডোজ) থেকে অ্যান্টিগ্র্যাভিটি চালু করুন।

👉 নির্দেশিত হলে "সাইন ইন"-এ ক্লিক করুন।

👉 আপনার গুগল অ্যাকাউন্ট ব্যবহার করুন।

পরামর্শ: সেই একই গুগল অ্যাকাউন্ট ব্যবহার করুন যা আপনি পরে গুগল ক্লাউডের জন্য ব্যবহার করবেন (অনুচ্ছেদ ৮)। অ্যাকাউন্ট দুটি একই রাখা সহজ হবে।

ধাপ ৩ — স্বাগতম স্ক্রিনটি যাচাই করুন

আপনি অ্যান্টিগ্র্যাভিটির স্বাগত স্ক্রিনটি দেখতে পাবেন, যেখানে তিনটি বড় বোতাম রয়েছে:

• ফোল্ডার খুলুন — বিদ্যমান কোনো ফোল্ডারকে ওয়ার্কস্পেস হিসেবে খোলে।
• এজেন্ট ম্যানেজার খুলুন — এটি এজেন্ট ড্যাশবোর্ডে নিয়ে যাবে (আমাদের বেশিরভাগ কাজ এখানেই হবে)
• ক্লোন রিপোজিটরি — গিটহাব থেকে একটি প্রজেক্ট ডাউনলোড করে (আমরা এটি ৩ক অনুচ্ছেদে ব্যবহার করব)

আপনি যদি কখনও আরও গভীরে যেতে চান, তাহলে https://antigravity.google/ -এ আরও তথ্য পাবেন।

✅ চেকপয়েন্ট: অ্যান্টিগ্র্যাভিটি ইনস্টল করা হয়েছে, আপনি সাইন ইন করেছেন, এবং তিনটি বাটনসহ স্বাগত স্ক্রিনটি দেখতে পাচ্ছেন।

২. প্রয়োজনীয় টুলস ইনস্টল করুন (অ্যান্টিগ্র্যাভিটির মাধ্যমে)

অ্যান্টিগ্র্যাভিটির জন্য আপনার কম্পিউটারে দুটি সহায়ক টুল প্রয়োজন:

সরঞ্জাম	এটা কী (সহজ ভাষায়)
ইউভি	পাইথন পরিচালনা করে — যা আপনার অ্যাপের ব্যাকএন্ডের পেছনের ভাষা।
গিট	ইন্টারনেট থেকে প্রোজেক্ট ফাইল ডাউনলোড করে (অ্যান্টিগ্র্যাভিটি এটি ক্লোনিংয়ের জন্য ব্যবহার করে)

আপনাকে নিজে থেকে ইনস্টল কমান্ড টাইপ করতে হবে না। আপনি ইংরেজিতে অ্যান্টিগ্র্যাভিটিকে জিজ্ঞাসা করবেন; বাকিটা সে-ই করে দেবে।

ধাপ ১ — একটি অস্থায়ী কর্মক্ষেত্র খুলুন

অ্যান্টিগ্র্যাভিটির সাথে চ্যাট করার জন্য একটি ফোল্ডার খোলা থাকা প্রয়োজন। (ফোল্ডার না থাকলে চ্যাট করা যাবে না।)

👉 স্বাগত স্ক্রিনে, "ওপেন ফোল্ডার" -এ ক্লিক করুন।

👉 যেকোনো একটি খালি ফোল্ডার তৈরি করুন বা বেছে নিন। পরামর্শ: আপনার সুবিধামতো কোনো জায়গায় (আপনার ডেস্কটপ হলেও চলবে) coding-jam-setup নামে একটি নতুন ফোল্ডার তৈরি করুন।

👉 খুলুন -এ ক্লিক করুন (অথবা ফোল্ডার নির্বাচন করুন )।

এজেন্ট ম্যানেজার ভিউটি আপনার নতুন (খালি) ওয়ার্কস্পেসটি নির্বাচিত অবস্থায় খোলে।

ধাপ ২ — অ্যান্টিগ্র্যাভিটিকে টুলগুলো পরীক্ষা ও ইনস্টল করতে বলুন

👉 চ্যাট ইনপুটে ফোকাস করতে Cmd+L (Mac) বা Ctrl+L (Win/Linux) চাপুন।

👉 নিশ্চিত করুন যে নিচের মডেল পিকারটিতে Gemini 3 Flash দেখাচ্ছে (ডিফল্ট — এক্ষেত্রে ঠিক আছে)।

📝 সবচেয়ে সহজ নির্দেশ — এটি চ্যাটে পেস্ট করুন:

Install uv and git on my computer if they're not already there. 
Don't install Node.js. Ask permission before each install command.

📝 আরও বিস্তারিত সংস্করণ (যদি আপনি চান):

Check whether uv and git are installed by running their --version commands.
For any tool that's missing, install it using the best method for my OS:
- Mac: prefer `brew install` (install Homebrew first if missing)
- Windows: prefer `winget install`
- Linux: prefer `apt install` or `dnf install`
Ask permission before each install command. 
Do NOT install Node.js — we'll install it later only if needed.
When done, give me a summary of what's installed.

👉 পাঠাতে এন্টার চাপুন।

🤖 এজেন্টের কাজ দেখুন, পপ-আপগুলিতে Allow-এ ক্লিক করুন।

ধাপ ৩ — সারাংশটি পড়ুন

এজেন্টটির কাজ শেষ হলে, আপনি এইরকম কিছু দেখতে পাবেন:

✅ Setup complete:
- uv 0.4.18 ✅ (installed)
- git 2.42.0 ✅ (already had it)
- Node.js: skipped (will install later if needed)

যদি কিছু ভুল হয়

"আমি Homebrew ইনস্টল করতে পারছি না" / "winget খুঁজে পাওয়া যায়নি" — এজেন্ট এমনটাই বলবে।

বিকল্প উপায়: এগুলো আপনার ব্রাউজারে খুলুন এবং ডিফল্ট সেটিংস সহ ইনস্টলারগুলো ম্যানুয়ালি চালান। তারপর অ্যান্টিগ্র্যাভিটিকে বলুন: "আমি [টুল] ম্যানুয়ালি ইনস্টল করেছি, অনুগ্রহ করে ভার্সন কমান্ড দিয়ে যাচাই করুন।"

• uv: docs.astral.sh/uv/getting-started/installation/
• গিট: git-scm.com/downloads

✅ চেকপয়েন্ট: এজেন্ট নিশ্চিত করে যে uv এবং git উভয়ই ইনস্টল করা আছে। মোট সময়: প্রায় ৩-৫ মিনিট (অথবা প্রায় ৭ মিনিট, যদি Mac-এ প্রথমে Homebrew ইনস্টল করতে হয়)।

আপনার প্রজেক্ট ক্লোন করুন

ধাপ ১ — এই সপ্তাহের প্রকল্প বাছাই করুন

কোডিং জ্যাম একটি ৮-সপ্তাহব্যাপী প্রোগ্রাম, যেখানে প্রতি সপ্তাহে একটি ভিন্ন মিনি-প্রজেক্ট থাকে। আপনার ফ্যাসিলিটেটর আপনাকে জানিয়ে দেবেন আজ আমরা কোন সপ্তাহের কাজ করছি। সেই সারিটি খুঁজে বের করুন এবং URL-টি কপি করুন।

সপ্তাহ	প্রকল্প	রিপো ইউআরএল
১	এআই হেয়ারস্টাইল ট্রাই-অন	https://github.com/gca-americas/codingjam-glow-up
২	এআই অবতার জেনারেটর	https://github.com/gca-americas/codingjam-avatar-studio
৩	আমার বিশেষ বছরের ক্যালেন্ডার	https://github.com/gca-americas/codingjam-year-in-poetry
৪	ফ্রিজ থেকে রেসিপি	https://github.com/gca-americas/codingjam-fridge-chef
৫	এআই মুড জার	https://github.com/gca-americas/codingjam-moodjar
৬	এক পৃষ্ঠার পোর্টফোলিও	https://github.com/gca-americas/codingjam-my-corner
৭	জীবনবৃত্তান্ত টেইলর	https://github.com/gca-americas/codingjam-bulletproof
৮	এআই ক্যারেক্টার চ্যাট	https://github.com/gca-americas/codingjam-character-chat

এই সপ্তাহে যোগ দিতে চান? কোনো সমস্যা নেই। আজকের সারিটি বেছে নিন। কোডল্যাবটি যেকোনো সপ্তাহের জন্যই একইভাবে কাজ করে।

ধাপ ২ — অ্যান্টিগ্র্যাভিটির মাধ্যমে ক্লোন

'ক্লোন রিপোজিটরি' বাটনটি ব্যবহার করার জন্য আমাদের লঞ্চ স্ক্রিনে ফিরে যেতে হবে।

👉 Antigravity-তে, আপনার পছন্দের প্রজেক্টটি ক্লোন করুন। উদাহরণস্বরূপ, সপ্তাহ ১ ক্লোন করুন, কিন্তু আপনাকে সঠিক রিপো ইনপুট করতে হবে।

• আপনি যে প্রজেক্টটি ক্লোন করতে চান, সেটি বেছে নিতে ভুলবেন না।
• আপনার লোকাল মেশিনে ফোল্ডারটি কোথায় সেভ করবেন তা ঠিক করে নিন।

⚠️ থামুন। পেস্ট করার আগে এটি পড়ুন।

নিচের প্রম্পটটিতে ⚠️ PASTE_YOUR_PROJECT এবং ⚠️ PASTE_YOUR_LOCATION প্লেসহোল্ডার রয়েছে।

আপনাকে অবশ্যই ধাপ ১ থেকে পাওয়া আপনার আসল মানগুলো দিয়ে এগুলো প্রতিস্থাপন করতে হবে, অন্যথায় .env ফাইলটিতে আক্ষরিক ⚠️ PASTE_... লেখা থাকবে এবং আপনার অ্যাপটি কাজ করবে না ।

📝 রেফারেন্স প্রম্পট

Git clone ⚠️ PASTE_YOUR_PROJECT and save to my local folder: ⚠️ PASTE_YOUR_LOCATION

ধাপ ৩ — প্রকল্পটি পরিদর্শন করুন

ফাইল তালিকাটি দেখুন। আপনি দেখতে পাবেন:

ফাইল / ফোল্ডার	এটা কি
BRIEF.md	পণ্যের ধারণা — সহজ ভাষায় বলতে গেলে, আমরা যা তৈরি করছি।
রেফারেন্স/	একটি কার্যকরী উদাহরণ অ্যাপসহ একটি ফোল্ডার। আপনার কোড লেখার সময় এআই এটি পড়বে , যাতে আপনার অ্যাপটি প্যাটার্নগুলোর সাথে মেলে।
.gitignore	গিট যেসব ফাইল উপেক্ষা করবে তার একটি তালিকা (প্রযুক্তিগতভাবে — উপেক্ষা করবে)

👉 ক্লিক করুন

BRIEF.md ফাইলটি খুলুন এবং এখানে প্রকল্পের ধারণাটি দেওয়া হলো।

✅ চেকমার্ক: আপনি প্রজেক্টটি ক্লোন করেছেন, এটিকে ওয়ার্কস্পেস হিসেবে খুলেছেন এবং BRIEF.md পড়েছেন।

৩. ওয়ার্কশপ দক্ষতা স্থাপন করুন

"স্কিল" হলো গিটহাবে সংরক্ষিত একগুচ্ছ নির্দেশাবলী যা আপনি আপনার এআই-কে দিতে পারেন।

ধাপ ১ — অ্যান্টিগ্র্যাভিটিকে স্কিলগুলো ইনস্টল করতে বলুন

📝 এই প্রম্পটটি চ্যাটে পেস্ট করুন:

Please install the workshop skills into this workspace's .agent/skills/ 
folder. Run these two git clones from the project root:

1. git clone https://github.com/gca-americas/skills-garden .agent/skills/skills-garden
2. git clone https://github.com/google-gemini/gemini-skills .agent/skills/gemini-skills

When Antigravity asks permission to run each command, I'll click Allow.

When done, list the skills that are now available in this workspace.

ধাপ ২ — দুটি পপ-আপে Allow-এ ক্লিক করুন

🤖 আপনার এইরকম কিছু দেখা উচিত

I'll create the .agent/skills/ folder and clone both repos into it.

Running: git clone https://github.com/gca-americas/skills-garden .agent/skills/skills-garden

এজেন্ট অনুরোধ করলে যেকোনো কাজ করার অনুমতি দিন।

👉 আপনার ফাইল তালিকাটি দেখুন। এখন আপনি একটি নতুন .agent/ ফোল্ডার দেখতে পাবেন। এটি খুলতে ক্লিক করুন এবং নিশ্চিত করুন যে এই ফোল্ডারের ভিতরে skills-garden এবং gemini-skills মতো একাধিক স্কিল রয়েছে।

প্রতিটি দক্ষতার কাজ (শুধুমাত্র তথ্যের জন্য, কোনো পদক্ষেপ নেওয়ার প্রয়োজন নেই)

দক্ষতা	এটা যা করে
pm-design-doc	প্রোডাক্ট ডিজাইন ডকুমেন্ট লেখে
ux-design-doc	ইউএক্স ডিজাইন ডকুমেন্ট লেখে
eng-design-doc	ইঞ্জিনিয়ারিং ডিজাইন ডকুমেন্ট লেখেন (টেস্টিং স্ট্র্যাটেজি সেকশন সহ)
test-driven-dev	টেস্ট লেখে, সেগুলো চালায়, এবং ব্যর্থতাগুলো স্বয়ংক্রিয়ভাবে সমাধান করে (সর্বোচ্চ ৩ বার চেষ্টার মাধ্যমে)।
gemini-api-dev	অফিসিয়াল গুগল স্কিল — জেমিনি এপিআই সঠিকভাবে ব্যবহার করার উপায়
gemini-api	অফিসিয়াল দক্ষতা উপলব্ধ না থাকলে একটি সহজ বিকল্প ব্যবস্থা।
cloud-pup , y2k-dreamcore	ভিজ্যুয়াল শৈলী রেফারেন্স

অনুমতি পপ-আপ সম্পর্কে: অ্যান্টিগ্র্যাভিটি প্রতিটি শেল কমান্ড চালানোর আগে অনুমতি চায়। এটি একটি সুরক্ষা বৈশিষ্ট্য — যা ভালো । আমাদের দুটি গিট ক্লোনের জন্য, 'Allow'-তে ক্লিক করুন। শুধু এই ওয়ার্কশপের জন্য নিরাপত্তা ("টার্বো মোড") নিষ্ক্রিয় করবেন না।

✅ চেকপয়েন্ট: আপনার ফাইল তালিকায় একটি নতুন .agent/skills/ ফোল্ডার দেখা যাচ্ছে, যার ভেতরে skills-garden/ এবং gemini-skills/ উভয়ই রয়েছে।

৪. স্পেক টক

স্পেক টক হলো একটি ২-মিনিটের কথোপকথন, যেখানে আপনি এআই-কে বলেন যে আপনি কী তৈরি করতে চান। কোনো কোড নেই, কোনো ডকুমেন্টেশন নেই, এখনো কিছু তৈরি করা হয়নি। আমরা শুধু বিষয়টি নিয়ে আলোচনা করি ।

একমাত্র আবশ্যক প্রশ্ন

এআই-এর জানার জন্য সবচেয়ে গুরুত্বপূর্ণ বিষয়টি হলো:

কী প্রবেশ করে, কী বেরিয়ে আসে?

🎯 মডেল: জেমিনি ৩ ফ্ল্যাশ (ডিফল্ট) — সহজ প্রশ্নোত্তর।

📝 এটি পেস্ট করুন:

Here's what's in @BRIEF.md. Before we lock the spec, ask me 3 short 
questions to refine it:
1. What's the one input I want the user to provide?
2. What's the magical moment for the user?
3. What are we deliberately NOT building (to keep scope tight)?

DO NOT generate any plans, docs, or code yet. Just ask me the questions 
and wait for my answers.

DO NOT NEED TO WRITE implementation plan.

🤖 এআই-এর সাথে কথা বলুন এবং আপনার পরিকল্পনাকে আরও উন্নত করুন

এখনও নথি তৈরি করবেন না

স্পেক টক-এর শেষে এজেন্টের কোনো ফাইল তৈরি করা উচিত নয়। যদি আপনি product.md বা অন্য কোনো নতুন ফাইল তৈরি হতে দেখেন, তাহলে আপনি এজেন্টকে বলতে পারেন: "থামুন — এইমাত্র তৈরি করা সমস্ত ডকুমেন্ট মুছে ফেলুন। আমরা এখনও স্পেক টক পর্যায়ে আছি।"

টিপস

ইনপুট এবং আউটপুট সম্পর্কে সুনির্দিষ্ট হোন। অস্পষ্ট: "এটি মানুষকে ব্যায়াম করতে সাহায্য করে।" সুনির্দিষ্ট: "ব্যবহারকারী একটি যোগাসন করার ১০-সেকেন্ডের একটি ভিডিও আপলোড করেন। এর বিনিময়ে তিনি তার ভঙ্গিমা সম্পর্কে ১-প্যারাগ্রাফের একটি পর্যালোচনা পান।"

এখনই UI ডিজাইন করার চেষ্টা করবেন না। স্পেক টক-এর মূল বিষয় হলো এটি কী , তা দেখা যাবে কি না, সে বিষয়ে নয়। UI ডকুমেন্টেশন পরে সেকশন ৫-এ আসবে।

✅ চেকপয়েন্ট: আপনি আপনার পণ্যের ধারণা নিয়ে অ্যান্টিগ্র্যাভিটির সাথে একটি সংক্ষিপ্ত আলোচনা করেছেন এবং এটি ইনপুট ও আউটপুটগুলো বুঝতে পেরেছে। এখনো কোনো ফাইল তৈরি হয়নি।

৫. ৩টি ডিজাইন ডকুমেন্ট তৈরি করুন

এখন এআই কোনো কোড লেখার আগেই কাগজে তিনটি পরিকল্পনা লেখে। আমরা তিনটি ডিজাইন-ডকুমেন্টেশন দক্ষতা ক্রমানুসারে ব্যবহার করে একটিমাত্র প্রম্পটেই তিনটি কাজই সম্পন্ন করি।

৩ জন ডাক্তার

ফাইল	এর মধ্যে কী আছে	ব্যবহৃত দক্ষতা
পণ্য.এমডি	ব্যবহারকারী কে, আমরা কী সমাধান করছি, কী কী বৈশিষ্ট্য রয়েছে	pm-design-doc
ui.md	স্ক্রিনগুলো দেখতে কেমন, রং, ফন্ট, লেআউট	ux-design-doc
ইঞ্জিনিয়ারিং.এমডি	টেক স্ট্যাক, ফাইল কাঠামো, + টেস্টিং কৌশল বিভাগ	eng-design-doc

ধাপ ১ — তিনটি ডকুমেন্টই একসাথে তৈরি করুন

🤖 কম চিন্তাভাবনা সহ জেমিনি ৩.১ প্রো-তে স্যুইচ করুন (সুপারিশকৃত)

📝 এটি পেস্ট করুন — একটি প্রম্পটেই তিনটি কাজ হয়ে যায়:

Apply all three design-doc skills in this order:

1. pm-design-doc from .agent/skills/skills-garden/design-doc-skills/pm-design-doc/
   → Generates product.md

2. ux-design-doc from .agent/skills/skills-garden/design-doc-skills/ux-design-doc/
   → Generates ui.md (based on the product.md you just created)

3. eng-design-doc from .agent/skills/skills-garden/design-doc-skills/eng-design-doc/
   → Generates engineering.md (based on product.md, ui.md, and @BRIEF.md)
   → MUST include a "Testing strategy" section with real content
     (specific functions to unit-test, one integration test per major flow,
     and what's deliberately NOT being tested)

Use the patterns in @reference/ as guidance for the engineering doc 
(but vary if the brief justifies it).

Save all three files in the project root. After each one is saved, 
briefly confirm what you saved before moving to the next.

When all three are done, give me a final summary listing the section 
titles in each file.

DO NOT NEED TO WRITE implementation plan. ONLY show me all three generated files and a final summary

ধাপ ২ — সংরক্ষিত ফাইলগুলো যাচাই করুন

👉 আপনার ফাইল তালিকাটি দেখুন। আগে যা ছিল তার পাশাপাশি এখন আপনি দেখতে পাবেন:

codingjam-week-1/
├── product.md          ← NEW
├── ui.md               ← NEW
├── engineering.md      ← NEW
├── BRIEF.md
├── reference/
└── .agent/

ধাপ ৩ - পর্যালোচনা ও পুনরাবৃত্তি

আপনিই বস। পরিকল্পনাটি এআই লিখেছে। এখন আপনি এটি পড়ুন এবং পরিবর্তনের অনুরোধ করুন।

সবচেয়ে গুরুত্বপূর্ণ অভ্যাস

যখন কোনো পরিবর্তন চান, তখন কোড নয়, ডকুমেন্টেশন (DOC) পরিবর্তন করুন। ডকুমেন্টেশনই হলো তথ্যের নির্ভরযোগ্য উৎস।

🤖 তিনটি নথিই পড়ুন ও পর্যালোচনা করুন

👉 ফাইল তালিকায় (বাম প্যানেল) ফাইলের নামে ( product.md ) ক্লিক করুন।

ডানদিকের প্যানেলে ডকুমেন্টটির প্রিভিউ দেখা যায়।

ধাপ ২ — পড়ুন ও মন্তব্য করুন, গুগল ডক্স স্টাইলে

👉 প্রতিটি ডকুমেন্ট প্রিভিউ করার পর, আগাগোড়া পড়ুন এবং জিজ্ঞাসা করুন:

1. product.md — আমি যা চাই, এটা কি তার বর্ণনা?
2. ui.md — স্ক্রিনগুলো কি দেখতে ঠিক আছে?
3. engineering.md — টেস্টিং কৌশলটি কি যৌক্তিক? (আপনার প্রযুক্তি বোঝার প্রয়োজন নেই — শুধু দেখুন একটি পরিকল্পনা আছে কি না।)

সরাসরি ডক্স-এর উপর মন্তব্য করুন — ঠিক গুগল ডক্স-এর মতো। অ্যান্টিগ্র্যাভিটি আপনাকে যেকোনো ফাইলে ইনলাইন মন্তব্য করার সুযোগ দেয়। এজেন্ট আপনার মন্তব্যগুলো পড়ে এবং পরিবর্তনগুলো প্রয়োগ করে — চ্যাটে ফিডব্যাক কপি-পেস্ট করার কোনো প্রয়োজন নেই।

🤖 এজেন্ট আপনার মন্তব্যগুলো প্রয়োগ করে দিলে এবং ডকুমেন্টগুলো সঠিকভাবে পড়া গেলে, পরবর্তী বিভাগে চলে যান ।

৬. বাস্তবায়ন ও পরীক্ষা

কোডল্যাবের সবচেয়ে বড় অংশ এটি। AI তিনটি ডকুমেন্টেশন থেকে তথ্য নিয়ে অ্যাপটি তৈরি করে — কোড এবং টেস্ট একসাথে, একবারে। এই অংশটি শেষ হলে, আপনার কাছে একটি কার্যকরী কোডবেস থাকবে যা নিজের টেস্টগুলোই পাস করবে।

কোড ও টেস্ট একসাথে কেন?

টেস্ট-ড্রাইভেন-ডেভ স্কিল সম্পর্কে: ঐতিহাসিকভাবে এই স্কিলটির নামকরণ করা হয়েছে টেস্ট-ড্রাইভেন ডেভেলপমেন্টের (Test-Driven Development) নামানুসারে, কিন্তু আমরা যা করছি তা কঠোর TDD (যেখানে টেস্টকে অগ্রাধিকার দেওয়া হয়) নয়। আমরা AI-কে দিয়ে কোড তৈরি করাচ্ছি, এবং তারপর সেটি সাথে সাথেই টেস্ট তৈরি করে, সেগুলো রান করে, এবং যেকোনো ব্যর্থতা স্বয়ংক্রিয়ভাবে ঠিক করে দেয়। এটিকে ইমপ্লিমেন্টেশনের সাথে ওতপ্রোতভাবে জড়িত 'টেস্ট একটি সুরক্ষা গেট' হিসেবে ভাবা যেতে পারে — আপনি কিছু ক্লিক করার আগেই এটি সমস্যাগুলো ধরে ফেলে।

আপনার engineering.md ফাইলে কী কী টেস্ট থাকা উচিত তা ইতিমধ্যেই নির্দিষ্ট করা আছে (টেস্টিং স্ট্র্যাটেজি সেকশনে)। সেই টেস্টগুলো পাস না করা পর্যন্ত ইমপ্লিমেন্টেশন সম্পূর্ণ হয় না। তাই আমরা দুটোই এক ধাপে সম্পন্ন করি।

🤖 উচ্চ চিন্তাভাবনা সহ জেমিনি ৩.১ প্রো-তে পরিবর্তন করুন (সুপারিশকৃত)

ধাপ ১ — AI-কে কোড এবং টেস্ট তৈরি করতে বলুন

📝 এটি পেস্ট করুন:

You're going to do two things in one shot.

PART 1 — IMPLEMENT THE APP CODE
- Build it according to @engineering.md (stack, file structure)
- Match the UI described in @ui.md
- Use the patterns in @reference/ as guidance for code style
- Backend: use Python with `uv` for dependency management
- If your chosen stack requires Node.js and it isn't installed on my 
  system, install it via Antigravity (use brew/winget/apt) — ask 
  permission first
- DO NOT start any dev servers — that's a later section

PART 2 — APPLY THE TEST-GATE SKILL
After the code is written, apply the test-driven-dev skill from
.agent/skills/skills-garden/eng-skills/test-driven-dev.md.

Use the "Testing strategy" section in @engineering.md as the test plan.

IMPORTANT: Mock the Gemini API calls in tests — use a stub that returns
fake response data. The real API key isn't set up yet, and tests should
be deterministic and free anyway (best practice).

The skill should:
1. Write the tests described in the Testing strategy
2. Run them (use pytest for Python, Vitest or Jest for JS)
3. If any fail, fix the CODE (not the tests) and re-run
4. Up to 3 retry attempts max
5. If still failing after 3 tries, STOP and tell me what's broken

When Antigravity asks permission to run commands (uv sync, uv pip 
install, pytest, etc.), click Allow.

Report results when both parts are done.

🤖 একাধিক পপ-আপের ক্ষেত্রে অনুমতি দিন-এ ক্লিক করুন

ধাপ ২ — চূড়ান্ত প্রতিবেদনটি পড়ুন

কাজ শেষ হলে, নিম্নলিখিত বিষয়গুলো যাচাই করুন:

• ✅ কোড সহ একটি backend/ ফোল্ডার বিদ্যমান আছে
• ✅ কোড সহ একটি frontend/ ফোল্ডার বিদ্যমান আছে
• ✅ tests/ নামে একটি ফোল্ডার আছে যেখানে পরীক্ষার ফাইলগুলো রয়েছে
• ✅ সারাংশে বলা হয়েছে "সব পরীক্ষা পাস করেছে" ( "৩ বার চেষ্টার পরেও ব্যর্থ" নয়)।
• ✅ এজেন্ট কোনো সার্ভার চালু করেনি

যদি তিনবারই পুনরায় চেষ্টা করা ব্যর্থ হয় তাহলে কী হবে?

বিরল হলেও সম্ভব। এর মানে সাধারণত এই যে, যা তৈরি করা হয়েছে তার জন্য ইঞ্জিনিয়ারিং ডকুমেন্টের টেস্টিং কৌশলটি অবাস্তব।

📝 এটি পেস্ট করুন:

The auto-fix loop hit the 3-try cap. Pull up @engineering.md and look 
at the Testing strategy section. Is the strategy realistic for what 
got built? Suggest updates to the doc so the tests align with reality. 
Don't change the code yet — update the doc, then re-apply the 
test-driven-dev skill.

যদি কিছু অস্বাভাবিক মনে হয়?

👉 যদি AI এমন কিছু তৈরি করে যা ডকুমেন্টেশনের সাথে মেলে না, তাহলে ডকুমেন্টেশনে ফিরে যান — শুধু AI-কে 'কোডটি ঠিক করতে' বলবেন না।

উদাহরণ:

I see you built the chat as a popup, but @ui.md says it should be a 
full page. Either update ui.md if a popup is actually better, OR 
rebuild the chat as a full page to match the current ui.md.

সর্বদা: ডাক্তারই সত্যের উৎস।

প্রিভিউ করার আগে আমরা কেন টেস্ট করি: টেস্টের মাধ্যমে ব্রাউজার না খুলেই ত্রুটিপূর্ণ ইম্পোর্ট ও লজিক বাগ ধরা পড়ে। যদি আমরা প্রথমে প্রিভিউ করতাম, তাহলে এদিক-ওদিক ক্লিক করে সেই একই বাগগুলো খুঁজে পেতাম (প্রতিটি বাগের জন্য ৫ মিনিট)। টেস্টের মাধ্যমে সেগুলো কয়েক সেকেন্ডের মধ্যেই খুঁজে পাওয়া যায়। টেস্ট সময় বাঁচায়, কাজের চাপ বাড়ায় না।

"সময় বাঁচাতে" টেস্ট বাদ দেবেন না। টেস্ট বাদ দেওয়ার অর্থ হলো ৫০ মিনিটে এমন বিভ্রান্তিকর বাগ খুঁজে পাওয়া, যা একটি অটো-টেস্ট ৩৫ মিনিটেই ধরে ফেলত।

✅ চেকমার্ক: কোড আছে, টেস্ট আছে, টেস্টগুলো পাস করেছে। এপিআই কী (API key) সেট আপ করার জন্য প্রস্তুত।

৭. গুগল ক্লাউড + এপিআই কী সেটআপ

ধাপ ১ — এআই স্টুডিও থেকে আপনার জেমিনি এপিআই কী সংগ্রহ করুন (১ মিনিট)

1. একটি নতুন ব্রাউজার ট্যাবে https://aistudio.google.com/app/apikey খুলুন।
2. একই গুগল অ্যাকাউন্ট দিয়ে সাইন ইন করুন।
3. 'Create API key'-তে (উপরে-ডানদিকে) ক্লিক করুন।
4. একটি প্রজেক্ট ড্রপডাউন সহ একটি ডায়ালগ বক্স খোলে:
   • আপনার যদি আগে থেকেই একটি গুগল প্রজেক্ট তৈরি করা থাকে, তাহলে আপনি সেটি নির্বাচন করে 'Create API key in existing project'-এ ক্লিক করতে পারেন।
   • তালিকায় না থাকলে "প্রজেক্ট তৈরি করুন" এ ক্লিক করুন।
5. প্রদর্শিত API কী-টি কপি করুন । এটি AIza... দিয়ে শুরু হয় এবং এতে প্রায় ৪০টি অক্ষর থাকে।

✏️ এটা কোনো নিরাপদ জায়গায় লাগিয়ে রাখুন — এরপর আপনি এটা অ্যান্টিগ্র্যাভিটিকে দেবেন।

এপিআই কী-কে পাসওয়ার্ডের মতো ব্যবহার করুন। এটি পাবলিক চ্যাটে পেস্ট করবেন না, স্ক্রিনশট নেবেন না বা কোনো পাবলিক গিটহাব রিপোজিটরিতে কমিট করবেন না। আমরা এটি একটি .env ফাইলে রাখব (যা ইতিমধ্যে .gitignore ফাইলে রয়েছে)।

ধাপ ২ — অ্যান্টিগ্র্যাভিটিকে .env সেট আপ করতে বলুন (৩০ সেকেন্ড)

অ্যান্টিগ্র্যাভিটিতে ফিরে এসে চ্যাটটি খুলুন।

⚠️ থামুন। পেস্ট করার আগে এটি পড়ুন।

নিচের প্রম্পটটিতে PASTE_YOUR_API_KEY_HERE এবং PASTE_YOUR_PROJECT_ID_HERE প্লেসহোল্ডার রয়েছে।

আপনাকে অবশ্যই ধাপ ১ থেকে পাওয়া আপনার আসল মানগুলো দিয়ে এগুলো প্রতিস্থাপন করতে হবে, অন্যথায় .env ফাইলটিতে আক্ষরিক ⚠️ PASTE_... লেখা থাকবে এবং আপনার অ্যাপটি কাজ করবে না ।

প্রেরণ করুন (Send) বোতামে ক্লিক করার আগে, নির্দেশাবলী ভালোভাবে দেখে নিশ্চিত করুন যে আপনি নিম্নলিখিত বিষয়গুলো দেখতে পাচ্ছেন:

• GEMINI_API_KEY=AIzaSy... ( AIzaSy দিয়ে শুরু, প্রায় ৪০ অক্ষর)

যদি আপনি এখনও প্রম্পটের কোথাও ⚠️ PASTE_... দেখতে পান, তাহলে এখনই পাঠাবেন না — প্রথমে সেগুলোকে প্রতিস্থাপন করুন।

📝 পেস্ট করার জন্য প্রম্পট (প্রতিস্থাপন করুন)

⚠️ PASTE_...

প্রথমে চিহ্নিতকারীগুলো!)

Apply the gemini-api-dev skill from .agent/skills/gemini-skills/skills/gemini-api-dev/.
(If that skill isn't found, fall back to .agent/skills/skills-garden/eng-skills/gemini-api.md)

Create a .env file in the backend folder with these settings:
- GEMINI_API_KEY= ⚠️ PASTE_YOUR_API_KEY_HERE
- Any other env vars the app needs based on @engineering.md

Also verify:
- .env is in .gitignore so the key never gets committed
- The backend code reads GEMINI_API_KEY at startup
- The Gemini SDK is initialized correctly (use google-genai for Python)

When Antigravity asks permission to install Python packages, click Allow.
When done, show me the .env contents with the KEY redacted (just first 6 chars + ...).

🤖 প্রত্যাশিত: এজেন্ট .env ফাইল তৈরি করবে, google-genai ইনস্টল করবে (আপনি Allow-তে ক্লিক করবেন), এবং গোপন করা কী (key) দিয়ে নিশ্চিত করবে:

✅ .env created at backend/.env
GEMINI_API_KEY=AIzaSy... (40 chars, redacted)

.env is already in .gitignore ✓
Backend reads GEMINI_API_KEY via os.getenv() ✓
Gemini client initialized ✓

যদি এজেন্ট GEMINI_API_KEY=<< >> রিপোর্ট করে GEMINI_API_KEY=<< >> প্লেসহোল্ডারটি প্রতিস্থাপন করতে ভুলে গেছেন! এটি পেস্ট করুন:

The .env file has the literal placeholder text instead of my real key.
Please update GEMINI_API_KEY to AIzaSy... (paste your real key).

৮. পূর্বরূপ দেখুন ও যাচাই করুন

কোড বিল্ড করা হয়েছে। টেস্টগুলো পাস করেছে। এপিআই কী কনফিগার করা হয়েছে। এবার অ্যাপটি খুলুন এবং বিভিন্ন জায়গায় ক্লিক করে দেখুন।

মানুষ যা ধরতে পারে (যা পরীক্ষায় ধরা পড়ে না)

টেস্ট ক্যাচ	মানুষ ধরে
ভুল রিটার্ন মান	কুৎসিত রং
ত্রুটিপূর্ণ ফাংশন কল	বিভ্রান্তিকর অনুলিপি
অনুপস্থিত আমদানি	অদ্ভুত জায়গায় বোতাম
অফ-বাই-ওয়ান ত্রুটি	অ্যানিমেশনটা কেমন যেন খাপছাড়া লাগছে
লজিক বাগ	পরিবেশটা ভালো না।

ধাপ ১ — অ্যান্টিগ্র্যাভিটিকে ডেভ সার্ভার চালু করতে বলুন

🎯 মডেল: ডিফল্ট (ফ্ল্যাশ) হলেই চলবে।

📝 এটি পেস্ট করুন:

Please start the dev server(s) so I can preview the app in my browser.
Tell me the URL when it's ready. When Antigravity asks permission to 
run the server command, I'll click Allow.

🔔 পপ-আপ: uv run uvicorn main:app --reload (বা অনুরূপ) → Allow-এ ক্লিক করুন

ধাপ ২ — প্রিভিউ ইউআরএলটি খুলুন

🤖 এজেন্ট জানাচ্ছেন:

Backend running at: http://localhost:8000
Frontend served at: http://localhost:8000 (backend serves it)

URL সাধারণত http://localhost:8000 অথবা http://localhost:5173 হয়ে থাকে।

👉 চ্যাটে থাকা URL-টিতে ক্লিক করুন, অথবা কপি করে একটি নতুন ব্রাউজার ট্যাবে পেস্ট করুন।

ধাপ ৩ — চারপাশে ক্লিক করুন

একজন প্রকৃত ব্যবহারকারীর মতোই এটি ব্যবহার করুন:

• প্রতিটি বোতামে ক্লিক করুন
• টাইপ করুন
• জিনিসগুলির উপর মাউস রাখুন
• শুরু থেকে শেষ পর্যন্ত মূল প্রবাহটি চেষ্টা করুন।

যদি সবকিছু দেখতে ও অনুভব করতে ঠিকঠাক মনে হয়, তাহলে চলে যান

ধাপ ৪ — একটি README লিখুন

নিচে। অন্যথায়, README লেখার আগে প্রথমে বিভিন্ন জায়গায় ক্লিক করে দেখুন এবং কোনো সমস্যা থাকলে Antigravity-কে জানান।

ধাপ ৪ — একটি README লিখুন

আপনার অ্যাপটি কাজ করা শুরু করলে, তা নিশ্চিত করুন:

📝 এটি পেস্ট করুন:

The app works! Please create a README.md in the project root that explains:
- What this app does (in plain English)
- How to install it on a new machine (uv sync, etc.)
- How to run the dev server(s)
- The 3 design docs (@product.md, @ui.md, @engineering.md) are the 
  source of truth — anyone can read them to understand the system

Save it as README.md.

🤖 প্রত্যাশিত: ফাইল তালিকায় README.md ফাইলটি থাকবে।

README কেন গুরুত্বপূর্ণ

আপনি এমন কিছু তৈরি করছেন যা দীর্ঘস্থায়ী। engineering.md , আপনার টেস্টগুলো এবং একটি README ফাইল থাকলে, আপনি আজ কাজ ছেড়ে দিয়ে ৩ সপ্তাহ পর আবার ফিরে আসতে পারেন। কাজ চালিয়ে যাওয়ার জন্য আপনার প্রয়োজনীয় সবকিছু ডিস্কে সংরক্ষিত থাকে। এটি একটি সত্যিকারের প্রজেক্ট, শুধু একটি ডেমো নয়।

✅ চেকমার্ক: আপনি অ্যাপটি ভালোভাবে দেখেছেন, কোনো সমস্যা থাকলে তা সমাধান করেছেন এবং একটি README ফাইল সেভ করেছেন।

৯. 🎉 আপনি একটি MVP পাঠিয়েছেন!

তুমি পেরেছো।

আপনি যা তৈরি করেছেন

• ✅ একটি এআই-চালিত ওয়েব অ্যাপ
• ✅ তিনটি ডিজাইন ডকুমেন্ট ( product.md , ui.md , engineering.md )
• ✅ একটি প্রকৃত টেস্ট স্যুট যা প্রতিবার কোড পরিবর্তন করার সময় চলে।
• ✅ একটি README.md , যাতে আপনি যেকোনো সময় এখানে ফিরে আসতে পারেন।
• ✅ গুগলের জেমিনি এআই-এর সাথে একটি সংযোগ

আপনি নিজে এক লাইন কোডও না লিখে, একটি ধারণা থেকে একটি কার্যকরী অ্যাপ তৈরি করে ফেলেছেন। এটা অবিশ্বাস্য।

আপনি যা শিখেছেন

দক্ষতা	কেন এটি গুরুত্বপূর্ণ
স্পেক → কোড+টেস্ট → ভেরিফাই	প্রথমে পরিকল্পনা করুন। একসাথে কোড ও টেস্ট তৈরি করুন। সবশেষে বিভিন্ন পরীক্ষা-নিরীক্ষা করুন। সবসময় এই ক্রমেই করুন।
ডকুমেন্টেশন ঠিক করুন, কোড নয়।	যখন কিছু ভুল হয়, তখন পরিকল্পনা পরিবর্তন করুন এবং নতুন করে গড়ুন। জোড়াতালি দেবেন না।
নিরাপত্তা গেট হিসেবে পরীক্ষা	বাস্তবায়নের অংশ হিসেবেই এটি তৈরি করা হয়েছে — আপনার কিছু করার আগেই এআই ভুলগুলো ধরে ফেলে।
পশ্চাদপসরণ নিয়ম	মানুষের খুঁজে পাওয়া প্রতিটি বাগ একটি পরীক্ষায় পরিণত হয়। বাগটি আর কখনো ফিরে আসতে পারে না।
ডাক্তার-চালিত পরিবর্তন	যখন দিকনির্দেশনা বদলাবে, তখন ডকুমেন্টটি পরিবর্তন করুন — বাকিটা এআই সামলে নেবে।
অ্যান্টিগ্র্যাভিটি ৩-স্তর প্রবাহ	চ্যাটে ইংরেজি → এজেন্ট কমান্ড বাছাই করে → আপনি অনুমোদন করেন।

আগামী সপ্তাহে ফিরছেন?

• ৮-সপ্তাহের সারণি থেকে একটি ভিন্ন সারি বেছে নিন।
• Antigravity-র "ক্লোন রিপোজিটরি" বোতামের মাধ্যমে সেই সপ্তাহের রিপোটি ক্লোন করুন।
• প্রতিটি ওয়ার্কস্পেসের জন্য স্কিলগুলো নতুন করে ইনস্টল হয় (ওয়ার্কস্পেস-ভিত্তিক = কোনো অবশিষ্ট অবস্থা থাকে না)।
• আপনি আপনার একই গুগল ক্লাউড প্রজেক্ট পুনরায় ব্যবহার করতে পারেন।
• বাকি সবকিছু একই কর্মপ্রবাহ যা আপনি এইমাত্র শিখলেন।

এরপর কী হবে

• আপনার প্রজেক্ট প্রকাশ করুন: কোডিং জ্যাম সাইটে আপনার প্রজেক্টটি প্রকাশ করুন!
• ঘরে বসেই তৈরি করুন: আপনার তিনটি ডকুমেন্ট বহনযোগ্য। যেকোনো এআই টুলে সেগুলো খুলুন এবং তৈরি করতে থাকুন।
• বন্ধুকে সাথে আনুন: নতুন কারো সাথে জুটি বেঁধে এই কোডল্যাবটি করুন। শেখানোর মাধ্যমেই সবচেয়ে দ্রুত শেখা যায়।

সম্পদ

• অ্যান্টিগ্র্যাভিটি ডকুমেন্টেশন
• অ্যান্টিগ্র্যাভিটি স্কিলস ডকস
• অ্যান্টিগ্র্যাভিটি কথোপকথন দৃশ্য
• অফিসিয়াল জেমিনি স্কিলস (গুগল)
• কোডিং জ্যাম (সকল ৮টি সাপ্তাহিক প্রজেক্ট)
• দক্ষতা বাগান (আমরা যে দক্ষতাগুলো ব্যবহার করেছি)
• জেমিনি এপিআই ডকুমেন্টেশন
• ফাস্টএপিআই ডকুমেন্টেশন

ক্লাবে স্বাগতম। তুমি এখন একজন নির্মাতা। যাও, আরও জিনিস তৈরি করো।