এজেন্টিক পাইপলাইন এবং অ্যান্টিগ্র্যাভিটি ব্যবহার করে বৃহৎ পরিসরে লিগ্যাসি মডার্নাইজেশন স্বয়ংক্রিয়করণ

১. আপনার আধুনিকীকরণ যাত্রার দিকনির্দেশনা

এই বিস্তৃত কোডল্যাবটি হলো "How to automate modernization with Antigravity and multi-agent orchestration" শীর্ষক আর্কিটেকচারাল গভীর বিশ্লেষণধর্মী আর্টিকেল থেকে সরাসরি উদ্ভূত একটি ব্যবহারিক সহায়ক ল্যাব। যদিও আমরা আমাদের বাস্তব প্রদর্শনের মাধ্যম হিসেবে একটি ক্লাসিক Node.js ফ্রেমওয়ার্ক অদলবদল ব্যবহার করেছি, এখানে আপনি যে মূল ডিজাইন প্যাটার্ন, ডিরেক্টরি কাঠামো এবং এজেন্টিক অর্কেস্ট্রেশন প্রক্রিয়াগুলো অনুসরণ করবেন, সেগুলো সম্পূর্ণরূপে ভাষা-নিরপেক্ষ এবং যেকোনো বৃহৎ পরিসরের লিগ্যাসি মডার্নাইজেশন প্রকল্পের জন্য সার্বজনীনভাবে প্রযোজ্য।

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

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

• কর্মপ্রবাহের রূপরেখা তৈরি : সুনির্দিষ্ট সেটআপ কাজগুলোকে জটিল হিউরিস্টিক রিফ্যাক্টরিং চ্যালেঞ্জ থেকে কীভাবে সঠিকভাবে শ্রেণিবদ্ধ ও পৃথক করা যায়।
• স্কিলস আর্কিটেকচার : প্রগ্রেসিভ ডিসক্লোজার এবং YAML রাউটিং মেটাডেটা ব্যবহার করে কীভাবে একটি এক্সটেনসিবল এজেন্ট স্কিলস প্যাক গঠন করা যায়।
• ডিজাইন প্যাটার্নের সমন্বয় : রাউটার, প্ল্যান-অ্যান্ড-এক্সিকিউট এবং রিফ্লেকশন ডিজাইন প্যাটার্নগুলোকে শৃঙ্খলিত করে কীভাবে বৃহৎ পরিসরের রিফ্যাক্টরিং পরিচালনা করা যায়
• কঠোর ইনপুট/আউটপুট চুক্তি : বহু-পর্যায়ের রিভার্স-ইঞ্জিনিয়ারিং এবং টার্গেট স্ক্যাফোল্ডিং পাইপলাইন জুড়ে কীভাবে সুস্পষ্ট ইনপুট/দক্ষতা/আউটপুট সীমানা প্রয়োগ করা যায়।
• প্যারিটি যাচাইকরণ : ক্রোম ওয়েব ব্রাউজারের মধ্যে পাশাপাশি প্যারিটি পরীক্ষা করার জন্য কীভাবে অ্যান্টিগ্র্যাভিটির ব্রাউজার সাবএজেন্ট ব্যবহার করবেন।

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

আপনি একটি সম্পূর্ণ স্বয়ংক্রিয় গ্রিনফিল্ড রিফ্যাক্টরিং পাইপলাইন পরিচালনা করবেন, যা প্রচলিত ও সেকেলে এক্সপ্রেস এবং মঙ্গুজ ক্রুড মনোলিথ ('ম্যাডহামস ডেমো')-কে স্বয়ংক্রিয়ভাবে গোড়া থেকে পুনর্নির্মাণ করে একটি কঠোরভাবে টাইপযুক্ত নেক্সট.জেএস অ্যাপ রাউটার অ্যাপ্লিকেশনে পরিণত করবে। এই অ্যাপ্লিকেশনটি মঙ্গোডিবি, কঠোর জোড ভ্যালিডেশন এবং অ্যাক্সেসযোগ্য শ্যাডসিএন ইউআই কম্পোনেন্ট দ্বারা সমর্থিত হবে।

আপনার যা যা লাগবে

• Google Antigravity IDE স্থানীয়ভাবে ইনস্টল করা হয়েছে ( antigravity.google- এ উপলব্ধ)।
  • স্থানীয়ভাবে Node.js (v18+) ইনস্টল করা আছে।
• স্বয়ংক্রিয় UI যাচাইকরণের জন্য ক্রোম ব্রাউজার ।
• ওপেন-সোর্স মডার্নাইজিং-এক্সপ্রেসজেএস ডেমোনস্ট্রেশন মনোরেপোর একটি ক্লোন।

২. আধুনিকীকরণের পরিবেশ তৈরি করুন

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

লিগ্যাসি এক্সপ্রেস বনাম আধুনিক নেক্সট.জেএস আর্কিটেকচার ম্যাপিং

উপাদান	লিগ্যাসি স্ট্যাক	আধুনিক প্রতিস্থাপন	যুক্তি
স্থাপত্য	এক্সপ্রেস মনোলিথ	নেক্সট.জেএস অ্যাপ রাউটার	অপ্টিমাইজড রেন্ডারিং এবং রিয়্যাক্ট সার্ভার কম্পোনেন্টস (RSC)-এর পারফরম্যান্সের জন্য লজিককে সার্ভার কম্পোনেন্টসে পৃথক করা।
ডেটা লজিক	বেজি (ওডিএম)	MongoDB + Zod	অন্তর্নিহিত ORM হুকগুলির পরিবর্তে সুস্পষ্ট, টাইপ-সেফ Zod স্কিমা এবং সরাসরি ড্রাইভার পারফরম্যান্স ব্যবহার করা হচ্ছে।
ভাষা	কমনজেএস / জাভাস্ক্রিপ্ট	টাইপস্ক্রিপ্ট (ইএসএম)	কম্পাইল-টাইম নিরাপত্তা জোরদার করা এবং আধুনিক মডিউল স্ট্যান্ডার্ডে স্থানান্তরিত হওয়া।
ফ্রন্টএন্ড	পাগ/ইজেএস (সার্ভার ভিউ)	ShadCN UI + Tailwind	অনমনীয় টেমপ্লেট থেকে সরে এসে একটি গঠনযোগ্য, প্রবেশযোগ্য এবং উপযোগিতা-কেন্দ্রিক ডিজাইন সিস্টেম গ্রহণ করা।
প্রমাণীকরণ	পাসপোর্ট.জেএস	নেক্সটঅথ	Edge এবং সমসাময়িক প্রোভাইডারদের জন্য অন্তর্নির্মিত সমর্থনের মাধ্যমে সেশন ব্যবস্থাপনার আধুনিকীকরণ।
নিরাপত্তা	ম্যানুয়াল মিডলওয়্যার	জোড (কঠোর বৈধতা)	সম্পূর্ণ স্ট্যাক জুড়ে ডেটা যাচাইকরণের জন্য একটি 'একক নির্ভরযোগ্য উৎস' বাস্তবায়ন করা।

আধুনিকীকরণ কেন্দ্রটি চালু করুন

আমাদের প্রথম সুনির্দিষ্ট পদক্ষেপ হলো বিচ্ছিন্ন মনোরেপো কাঠামোটি ক্লোন করা। এটি রিড-অনলি লিগ্যাসি কোডকে আমাদের নতুন গ্রিনফিল্ড টার্গেট রিপোজিটরি থেকে আলাদা করে, যা মূল অ্যাপ্লিকেশনে কোনো অনিচ্ছাকৃত পরিবর্তন না ঘটা নিশ্চিত করে।

আপনার অ্যান্টিগ্র্যাভিটি টার্মিনাল খুলুন এবং নিম্নলিখিত সেটআপ কমান্ডগুলি চালান:

git clone https://github.com/GoogleCloudPlatform/devrel-demos.git
cd devrel-demos/other/modernizing-expressjs

একবার ক্লোন করা হয়ে গেলে, সরাসরি Antigravity IDE এক্সপ্লোরারে modernizing-expressjs ফোল্ডারটি খুলুন। আপনি নিম্নলিখিত বিচ্ছিন্ন লেআউটটি দেখতে পাবেন:

/modernizing-expressjs/
├── .agents/            # Skills metadata and checklists
│   └── skills/
├── docs/               # Target directory for reverse-engineered markdown artifacts
├── legacy-app/         # Read-only root of the legacy Express monolith
├── modern-app/         # Greenfield target repository for the Next.js rewrite
├── GEMINI.md           # Project-wide agent constitution
└── README.md           # Companion documentation

গুরুত্বপূর্ণ: "ডিপেন্ডেন্সি র‍্যাবিট হোল" এড়িয়ে চলুন। আপনার এজেন্টদেরকে legacy-app/ ডিরেক্টরির ভিতরে npm install চালানোর নির্দেশ দেবেন না । যদি এক দশক পুরোনো কোনো প্যাকেজ C++ কম্পাইলার এরর দেখায়, তাহলে একটি অতি সাহায্যপ্রবণ অটোনোমাস এজেন্ট লোকাল বিল্ড চেইন "ঠিক" করার চেষ্টায় আপনার রিফ্যাক্টরিং চেকলিস্ট পুরোপুরি পরিত্যাগ করতে পারে—যার ফলে একটি গ্রিনফিল্ড রিরাইটের জন্য অপ্রাসঙ্গিক একটি লিগ্যাসি রানটাইমের পেছনে আপনার টোকেন বাজেট শেষ হয়ে যাবে। লিগ্যাসি ডিপেন্ডেন্সিগুলো আনইনস্টলড রাখুন।

আপনার মনোরেপো এনভায়রনমেন্টকে ডিটারমিনিস্টিকভাবে কীভাবে প্রস্তুত ও বিচ্ছিন্ন করবেন, তা প্রদর্শনকারী এই সংক্ষিপ্ত ভিডিওটি দেখুন:

৩. আর্কিটেক্ট এআই এজেন্ট স্কিল প্যাক ও প্যাটার্ন

একটি শক্তিশালী এজেন্ট স্কিল তৈরি করা একটি সাধারণ চ্যাট প্রম্পট লেখার থেকে মৌলিকভাবে ভিন্ন। যখন আপনি একটি স্কিল প্যাক তৈরি করেন, তখন আপনি একটি মডিউলার সফটওয়্যার ডিজাইন করেন যা একটি অন্তর্নিহিত এলএলএম (LLM) স্বয়ংক্রিয়ভাবে সম্পাদন করবে। এজেন্টকে বিভ্রান্তি বা "কন্টেক্সট উইন্ডো ট্যাক্স" থেকে রক্ষা করার জন্য, আমরা দুটি অলঙ্ঘনীয় নীতি দ্বারা চালিত একটি সম্প্রসারণযোগ্য অথরিং টেমপ্লেট হিসাবে ওপেন-সোর্স গ্রিনফিল্ড অর্কেস্ট্রেশন স্কিল প্যাক চালু করেছি: সংক্ষিপ্ততা এবং প্রগতিশীল প্রকাশ ।

YAML মেটাডেটা রাউটিং ব্যবহার করে প্রগতিশীল প্রকাশ

সমস্ত টার্গেট রুল একটি একক বিশাল সিস্টেম প্রম্পটে রাখার পরিবর্তে, আমরা নির্দেশাবলী বিভিন্ন ডিরেক্টরিতে ভাগ করে দিই। প্রতিটি Skill ডিরেক্টরিতে একটি SKILL.md এন্ট্রিপয়েন্ট থাকে, যা একটি YAML রাউটিং ফ্রন্টম্যাটার ব্লকের মধ্যে মোড়ানো থাকে।

.agents/skills/orchestrating-greenfield-migration/SKILL.md ফাইলটি খুলুন এবং রাউটার মেটাডেটা পরীক্ষা করুন:

---
name: orchestrating-greenfield-migration
description: >
  Manages the end-to-end modernization of legacy Express
  monoliths into Next.js architectures. Orchestrates subagents
  for auditing, scaffolding, and verification. Use when starting
  or managing a greenfield rewrite project.
---

পরামর্শ: এখানে দুটি গুরুত্বপূর্ণ রচনারীতি লক্ষ্য করুন:

1. জেরান্ড নামকরণ : সম্পাদিত কাজটি সুস্পষ্টভাবে সংজ্ঞায়িত করার জন্য আমরা জেরান্ড ক্রিয়ারূপ (যেমন: orchestrating-greenfield-migration ) ব্যবহার করি।
2. সুস্পষ্ট ট্রিগার প্রসঙ্গ : description ক্ষেত্রটি অন্তর্নিহিত মডেলকে স্পষ্টভাবে নির্দেশ দেয় কখন স্কিলটি সক্রিয় করতে হবে ( "একটি গ্রিনফিল্ড রিরাইট প্রকল্প শুরু বা পরিচালনা করার সময় ব্যবহার করুন" )। যদি আপনার বিবরণ অস্পষ্ট হয়, তাহলে প্ল্যাটফর্মের রাউটিং লজিক আপনার সাবএজেন্টকে আহ্বান করতে ব্যর্থ হবে।

পরিকল্পনা-এবং-কার্যকর প্যাটার্ন হার্ডকোডিং করা

একটি স্বায়ত্তশাসিত এজেন্টকে লক্ষ্যচ্যুত হওয়া, আকর্ষণীয় পুরোনো মিডলওয়্যারের দ্বারা বিভ্রান্ত হওয়া, বা অননুমোদিত ডেটাবেস অদলবদলের চেষ্টা করা থেকে বিরত রাখতে, আমরা নির্দেশাবলীর মধ্যে সরাসরি প্ল্যান-অ্যান্ড-এক্সিকিউট প্যাটার্নটি হার্ডকোড করে প্রমিত উন্মুক্ত পরিকল্পনাকে অগ্রাহ্য করি।

প্রধান অর্কেস্ট্রেটরের ভিতরে এমবেড করা আক্ষরিক মার্কডাউন চেকলিস্টটি পরিদর্শন করুন:

### Phase 1: The AI audit (reverse engineering)
Dispatch subagents to produce specifications while identifying project-specific test scenarios.

*   [ ] Init `docs/verification/Verification_Plan.md` to create baseline template.
*   [ ] Run `auditing-data-models` -> Append Data Integrity Stress-Tests.
*   [ ] Run `auditing-api-contracts` -> Append API Parity & Edge Case Probes.
*   [ ] Run `auditing-business-logic` -> Append Logic & Authorization Stress-Tests.
*   [ ] Run `auditing-ui-archeology` -> Append Interaction & Layout Targets.

দ্রষ্টব্য: এটি অর্কেস্ট্রেটর স্কিলটির একটি অংশ মাত্র। সম্পূর্ণ বিবরণের জন্য আপনার ক্লোন করা রিপোজিটরিতে স্কিলটি পর্যালোচনা করুন।

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

৪. পর্যায় ১ — পুরোনো মনোলিথটির রিভার্স-ইঞ্জিনিয়ারিং (নিরীক্ষা)

আমরা আমাদের প্রধান অর্কেস্ট্রেশন সিকোয়েন্সটি চালু করার জন্য প্রস্তুত! আমাদের প্রথম প্রধান ধাপে, লিগ্যাসি মনোলিথ থেকে বিজনেস রুলস, ডেটা স্কিমা এবং এপিআই পেলোডগুলো এক্সট্র্যাক্ট করে পরিষ্কার মার্কডাউন আর্টিফ্যাক্ট হিসেবে সংরক্ষণ করা হবে এবং এর মাধ্যমে এক দশকের অপরিহার্য টেকনিক্যাল ডেট পেছনে ফেলে আসা হবে।

স্বয়ংক্রিয় রিফ্যাক্টরিং ক্রমটি সক্রিয় করুন

অ্যান্টিগ্র্যাভিটি এজেন্ট ম্যানেজার চ্যাট প্যানেলে, নিম্নলিখিত কাস্টম স্ল্যাশ কমান্ডটি টাইপ করুন এবং এন্টার চাপুন:

/orchestrating-greenfield-migration

এখন, আপনার টার্মিনাল কনসোলটি পর্যবেক্ষণ করুন। আপনি দেখবেন যে মূল এজেন্টটি তার সিস্টেম প্রম্পট পড়ছে, আপনার অনুরোধটিকে অর্কেস্ট্রেটরের মেটাডেটার সাথে মেলাচ্ছে, ৫-পর্যায়ের চেকলিস্টটি আউটপুট করছে এবং অবিলম্বে সমান্তরালভাবে বিশেষায়িত "অডিটর" সাব-এজেন্টদের প্রেরণ করা শুরু করছে।

ইনপুট/দক্ষতা/আউটপুট নির্দেশনামূলক চুক্তি

প্রথম পর্যায়ে, এজেন্ট নিম্নলিখিত নির্দেশনামূলক চুক্তি দ্বারা আবদ্ধ একটি কঠোর রিভার্স-ইঞ্জিনিয়ারিং পাইপলাইন কার্যকর করে:

ব্যবহৃত ইনপুট : legacy-app/ ভিতরে অবস্থিত শুধুমাত্র পঠনযোগ্য লিগ্যাসি সোর্স কোড ফাইলসমূহ।

ব্যবহৃত দক্ষতা :

দক্ষতা	বর্ণনা
auditing-api-contracts	সঠিক JSON রেসপন্স এনভেলপ নথিভুক্ত করার জন্য লিগ্যাসি রুটগুলো ট্রেস করে।
auditing-data-models	মঙ্গুস স্কিমা বিশ্লেষণ করে রিলেশন, প্রয়োজনীয় ফিল্ড এবং ডিফল্ট মান বের করে।
auditing-business-logic	অন্তর্নিহিত পার্শ্ব-প্রতিক্রিয়া, পাসপোর্ট অথেন্টিকেশন ফ্লো এবং মিডলওয়্যার নিয়মাবলী নথিভুক্ত করে।
auditing-ui-archeology	উচ্চ-স্তরের "UI Intent" (নেভবার, ফর্ম) ম্যাপ করার জন্য পুরোনো Pug টেমপ্লেট স্ক্যান করে।

উৎপাদিত সামগ্রী : অত্যন্ত সুগঠিত মার্কডাউন স্পেসিফিকেশন যা সরাসরি আপনার docs/ ফোল্ডারে তৈরি হয়।

প্রত্নবস্তু	বর্ণনা
docs/API_Contracts.md	এই ডকুমেন্টটিতে লিগ্যাসি এক্সপ্রেস অ্যাপ্লিকেশনটির রিভার্স-ইঞ্জিনিয়ারড এপিআই সারফেস এরিয়ার বিস্তারিত বিবরণ দেওয়া হয়েছে। আধুনিক নেক্সট.জেএস অ্যাপ্লিকেশনে রাউটগুলো পুনর্নির্মাণের সময় কঠোর সমতা নিশ্চিত করতে এই ক্যাটালগটি ব্যবহার করুন।
docs/Business_Logic_Rules.md	এই নথিতে লিগ্যাসি এক্সপ্রেস অ্যাপ্লিকেশনের প্রমাণীকরণ (AuthN), অনুমোদন (AuthZ), গ্লোবাল মিডলওয়্যার, সেশন ম্যানেজমেন্ট এবং সাইড-ইফেক্ট সম্পর্কিত যাচাইকৃত আচরণ, কনফিগারেশন এবং কঠোর নিয়মাবলী লিপিবদ্ধ করা হয়েছে।
docs/Data_Models.md	এই ডকুমেন্টটি legacy-app/app/models/ থেকে পুরোনো Mongoose স্কিমাগুলোর একটি বিশদ বিশ্লেষণ প্রদান করে এবং নেটিভ MongoDB ও Zod ব্যবহার করে একটি টাইপ-সেফ আধুনিক ডেটা অ্যাক্সেস লেয়ারের রূপরেখা দেয়।
docs/UI_Inventory.md	এই ডকুমেন্টটি legacy-app এ থাকা পুরোনো Pug-ভিত্তিক ইউজার ইন্টারফেসের একটি বিশদ বিশ্লেষণ প্রদান করে এবং modern-app এ একটি আধুনিক, কম্পোনেন্ট-চালিত Next.js ফ্রন্টএন্ড আর্কিটেকচারের রূপরেখা তুলে ধরে।

স্বয়ংক্রিয় রিভার্স-ইঞ্জিনিয়ারিং অডিটটি কীভাবে কাজ করে তা দেখতে এই লাইভ টার্মিনাল ক্যাপচারটি দেখুন:

৫. পর্যায় ২ ও ৩ — টিডিডি হারনেস এবং গ্রিনফিল্ড ব্যাকএন্ড স্ক্যাফোল্ডিং

লিগ্যাসি অ্যাপ্লিকেশনটি সম্পূর্ণরূপে নিরীক্ষিত এবং নথিভুক্ত হয়ে গেলে, প্রধান অর্কেস্ট্রেটর আধুনিক টার্গেট ব্যাকএন্ডের কাঠামো তৈরির দিকে অগ্রসর হয়। এই পর্যায়ে আমাদের টুলকিটের সবচেয়ে শক্তিশালী এজেন্টিক ডিজাইন প্যাটার্নটি চালু করা হয়: কঠোর টেস্ট-ড্রাইভেন ডেভেলপমেন্ট (TDD) দ্বারা চালিত ক্লোজড-লুপ রিফ্লেকশন (আত্ম-প্রতিফলন)।

রিফ্লেক্সন লুপ ব্যবহার করে সেলফ-হিলিং কোড চালনা করা

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

1. দ্বিতীয় পর্যায় (TDD সেটআপ) : অর্কেস্ট্রেটর ' generating-api-tests সাবএজেন্টকে আহ্বান করে, যা docs/API_Contracts.md ফাইলটি পড়ে এবং সুনির্দিষ্ট প্রয়োজনীয় HTTP স্ট্যাটাস কোড ও JSON পেলোড যাচাই করে বিশদ Vitest ইন্টিগ্রেশন টেস্ট স্যুট লেখে। TDD-তে যেমনটা প্রত্যাশিত, এই টেস্টগুলো প্রাথমিকভাবে ব্যর্থ হয়।
2. পর্যায় ৩ (ব্যাকএন্ড স্ক্যাফোল্ডিং) : স্ক্যাফোল্ডিং সাবএজেন্টরা আধুনিক Next.js রাউট হ্যান্ডলার এবং কঠোর Zod ভ্যালিডেশন স্কিমা লেখা শুরু করে।
3. স্ব-সংশোধন চক্র : যখন ডিটারমিনিস্টিক ভাইটেস্ট হারনেস নতুন কোডটি মূল্যায়ন করে ব্যর্থতা ফেরত দেয় (যেমন, একটি প্রত্যাশিত 422 ভ্যালিডেশন ত্রুটির ফলে 500 কোড ফেরত এলে), তখন এজেন্ট ক্র্যাশ করে না। এটি উদ্দেশ্যমূলক ত্রুটির আউটপুট পর্যালোচনা করে, টার্গেট রুট হ্যান্ডলারটি পুনরায় খোলে, Zod স্কিমা পেলোড কাঠামোটি ঠিক করে এবং পরীক্ষাগুলো আবার চালায়। এটি স্বয়ংক্রিয়ভাবে পুনরাবৃত্তি করতে থাকে যতক্ষণ না এক্সিট কোড 0 -তে পৌঁছায়।

ইনপুট/দক্ষতা/আউটপুট নির্দেশনামূলক চুক্তি

ব্যবহৃত ইনপুট : রিভার্স-ইঞ্জিনিয়ার করা স্পেসিফিকেশন আর্টিফ্যাক্ট ( docs/API_Contracts.md , docs/Data_Models.md )।

ব্যবহৃত দক্ষতা :

দক্ষতা	বর্ণনা
generating-api-tests	ব্যর্থ ভিটেস্ট ইন্টিগ্রেশন স্যুট তৈরি করে।
scaffolding-nextjs-foundation	Next.js অ্যাপের মূল রাউটার লেআউটটি চালু করে।
scaffolding-test-foundation	স্থানীয় Vitest টেস্ট রানার পরিবেশ কনফিগার করে।
scaffolding-data-layer	পুরানো Mongoose মডেলগুলোকে MongoDB + Zod স্কিমাতে রূপান্তর করে।
scaffolding-api-routes	এক্সপ্রেস রাউটগুলোকে পুনর্গঠন করে নেক্সট.জেএস রাউট হ্যান্ডলার এবং মডিউলার রাউট গার্ডে পরিণত করে।

উৎপাদিত আউটপুট : প্রাথমিকভাবে ব্যর্থ হওয়া Vitest স্যুট, সম্পূর্ণ টাইপ করা Zod স্কিমা, কার্যকরী Next.js রাউট হ্যান্ডলার, এবং ত্রুটিমুক্ত ও সফল টেস্ট স্যুট এক্সিকিউশন।

TDD টেস্ট হারনেসটির স্বয়ংক্রিয়ভাবে তৈরি হওয়া পর্যবেক্ষণ করুন:

টার্গেট ব্যাকএন্ডকে স্কাফোল্ডিংকারী স্ব-সংশোধনকারী রিফ্লেকশন লুপের রিয়েল-টাইম কার্য সম্পাদন পর্যবেক্ষণ করুন:

৬. পর্যায় ৪ — আধুনিক ফ্রন্টএন্ডের কাঠামো তৈরি করা (ইউআই উপাদানসমূহ)

ব্যাকএন্ড ভ্যালিডেশন লেয়ার সম্পূর্ণরূপে সুরক্ষিত এবং ইন্টিগ্রেশন টেস্টে উত্তীর্ণ হওয়ায়, মূল অর্কেস্ট্রেটর ভিজ্যুয়াল প্রেজেন্টেশনকে আধুনিক করার দিকে মনোযোগ দেয়। বাধ্যতামূলক সার্ভার-রেন্ডার করা টেমপ্লেটগুলো বাদ দিয়ে একটি অত্যন্ত সহজলভ্য ও উপযোগিতা-কেন্দ্রিক কম্পোনেন্ট ডিজাইন সিস্টেম গ্রহণ করা হয়।

UI ইন্টেন্টকে কম্পোজেবল ভিউতে অনুবাদ করা

লাইন-বাই-লাইন CSS অনুবাদের চেষ্টা না করে, ফ্রন্টএন্ড সাবএজেন্ট নিষ্কাশিত "UI Intent" তালিকাটি পড়ে এবং কাঠামোগত উপাদানগুলিকে সরাসরি উচ্চ-মানের আধুনিক সমতুল্যগুলির সাথে ম্যাপ করে।

ইনপুট/দক্ষতা/আউটপুট নির্দেশনামূলক চুক্তি

ব্যবহৃত ইনপুট : রিভার্স-ইঞ্জিনিয়ার করা ফ্রন্টএন্ড ইনভেন্টরি আর্টিফ্যাক্ট ( docs/UI_Inventory.md )।

ব্যবহৃত দক্ষতা :

দক্ষতা	বর্ণনা
scaffolding-ui-components	একটি UI_Component_Inventory.md আর্টিফ্যাক্টকে আধুনিক ShadCN + Tailwind কম্পোনেন্ট এবং সম্পূর্ণরূপে স্কাফোল্ড করা Next.js পেজে রূপান্তর করে।

উৎপাদিত আউটপুট : অত্যন্ত অ্যাক্সেসযোগ্য ShadCN UI কম্পোনেন্ট এবং Tailwind CSS ইউটিলিটি লেআউট ব্যবহার করে নির্মিত প্রোডাকশন-রেডি Next.js ফ্রন্টএন্ড পেজ।

আধুনিক ফ্রন্টএন্ড ভিউ লেয়ারের স্বয়ংক্রিয় গঠন প্রক্রিয়াটি দেখুন:

৭. পর্যায় ৫ — যাচাইকরণ ও প্রতিপক্ষীয় নিরীক্ষা

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

দুই-ট্যাব পরীক্ষা সম্পাদন এবং ব্রাউজার সক্রিয়করণ

যাচাইকরণ পর্যায়টি অ্যান্টিগ্র্যাভিটির সমন্বিত ভিজ্যুয়াল এবং DOM সক্ষমতা ব্যবহার করে, আপনাকে ম্যানুয়ালি ফর্মগুলিতে ক্লিক করার প্রয়োজন ছাড়াই স্বয়ংক্রিয়ভাবে সাফল্য প্রমাণ করে:

1. পাশাপাশি সমতা : auditing-parity সাবএজেন্ট স্থানীয় রানারকে লিগ্যাসি এক্সপ্রেস মনোলিথ এবং আধুনিক নেক্সট.জেএস অ্যাপ্লিকেশন উভয়ই একযোগে চালু করার নির্দেশ দেয়, যা অভিন্ন ভিজ্যুয়াল উপস্থাপনা এবং ডেটা রেন্ডারিং যাচাই করে।
2. প্রতিপক্ষীয় নিরাপত্তা অনুসন্ধান : অর্কেস্ট্রেটর adversarial-verification সাবএজেন্টকে আহ্বান করে, যা অ্যান্টিগ্র্যাভিটি ব্রাউজার সাবএজেন্ট চালু করে। এই বিশেষায়িত এজেন্ট সরাসরি ব্রাউজারকে সক্রিয় করে—ইনপুট টাইপ করা, ফর্ম জমা দেওয়া এবং নিরাপত্তা ত্রুটি, ত্রুটিপূর্ণ সেশন কুকি বা অমীমাংসিত প্রান্তিক পরিস্থিতি অনুসন্ধান করে।
3. অডিট ট্রেইল তৈরি : ব্রাউজার সাবএজেন্ট স্বয়ংক্রিয়ভাবে তার সেশন অ্যাকচুয়েশনের WebP ভিডিও ক্যাপচার রেকর্ড করে এবং যাচাইযোগ্য "কাজের প্রমাণ" হিসেবে সেগুলোকে সরাসরি চূড়ান্ত মাইগ্রেশন রিপোর্টের সাথে সংযুক্ত করে।

ইনপুট/দক্ষতা/আউটপুট নির্দেশনামূলক চুক্তি

ব্যবহৃত ইনপুট : স্থানীয় রানটাইম পরিবেশে পাশাপাশি চলমান পুরোনো এবং আধুনিক উভয় অ্যাপ্লিকেশন।

ব্যবহৃত দক্ষতা :

দক্ষতা	বর্ণনা
auditing-parity	রানটাইমে পাশাপাশি যাচাইকরণ পরীক্ষা সম্পাদন করে।
adversarial-verification	স্বয়ংক্রিয় ব্রাউজার সক্রিয়করণের মাধ্যমে যৌক্তিক ত্রুটি এবং কার্যকরী পশ্চাদপসরণ অনুসন্ধান করা হয়।

উৎপাদিত আউটপুট : সম্পূর্ণ সাফল্য নিশ্চিতকারী একটি বিশদ কার্যকরী সমতা নিরীক্ষা ট্রেইল এবং রেকর্ডকৃত ব্রাউজার সেশন ভিডিও।

স্বয়ংক্রিয় ব্রাউজার সাবএজেন্টটিকে আধুনিক অ্যাপ্লিকেশনটি সক্রিয়ভাবে যাচাই করতে লক্ষ্য করুন:

৮. অভিবাসন-পরবর্তী উৎপাদন প্রস্তুতি ও পরবর্তী পদক্ষেপসমূহ

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

প্রোডাকশন ডেপ্লয়মেন্টের জন্য প্রস্তুতি

আপনার Next.js অ্যাপ্লিকেশনটি সম্পূর্ণরূপে যাচাই ও নিরীক্ষা করা হয়ে গেলে, আপনি প্রোডাকশন ইন্টিগ্রেশনের জন্য প্রস্তুত। শিল্প-মানসম্মত এই পরবর্তী পদক্ষেপগুলো বাস্তবায়নের কথা বিবেচনা করুন:

• ইনক্রিমেন্টাল রাউটিং : লিগ্যাসি এক্সপ্রেস অ্যাপ থেকে আধুনিক টার্গেটে ট্র্যাফিক পর্যায়ক্রমে রাউট করার জন্য একটি রিভার্স প্রক্সি (যেমন, স্ট্র্যাংলার ফিগ প্যাটার্ন ) স্থাপন করুন।
• এসইও সংরক্ষণ : বিদ্যমান ডোমেইন অথরিটি ধরে রাখতে পুরোনো এক্সপ্রেস রুটগুলোকে নেক্সট.জেএস-এর স্থায়ী রিডাইরেক্ট ( _redirects.yaml ) -এর সাথে ম্যাপ করুন।
• ডেটা স্ট্রিমিং : স্ট্যাটিক ডেটাবেস সিডিং থেকে সরে এসে কঠোর Zod স্কিমা ব্যবহার করে রানটাইমে সুরক্ষিতভাবে যাচাইকৃত লাইভ প্রোডাকশন ডেটা স্ট্রিমিং-এ স্থানান্তর করুন।
• পর্যবেক্ষণযোগ্যতা : অপরিহার্য লগিং ইউটিলিটিগুলোকে কাঠামোগত ওপেনটেলিমেট্রি ফ্রেমওয়ার্ক দিয়ে প্রতিস্থাপন করুন।

আপনার আধুনিকীকরণ দক্ষতা আরও গভীর করুন

এই পাইপলাইনের পেছনের সম্পূর্ণ কোডবেস, কাস্টম স্কিল নির্দেশনা এবং বিশদ তাত্ত্বিক যুক্তি জানতে, মূল সম্পূর্ণ নিবন্ধটি অবশ্যই পড়ুন:

• অ্যান্টিগ্র্যাভিটি এবং মাল্টি-এজেন্ট অর্কেস্ট্রেশন ব্যবহার করে আধুনিকীকরণকে কীভাবে স্বয়ংক্রিয় করা যায়

এজেন্টিক বিল্ডার কমিউনিটিতে যোগ দিন

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

• লিঙ্কডইনে অনুসরণ করুন : linkedin.com/in/jamesor
• টুইটারে অনুসরণ করুন : x.com/JamesOR

আপনার মতামত জানান।

এজেন্টিক অর্কেস্ট্রেশন সম্পর্কে কোন বিষয়টি আপনাকে সবচেয়ে বেশি উৎসাহিত করে?

প্রতিপক্ষীয় ব্রাউজার যাচাইকরণ স্বায়ত্তশাসিত রিফ্যাক্টরিং লুপ সম্প্রসারণযোগ্য দক্ষতা স্থাপত্য মাল্টি-এজেন্ট অর্কেস্ট্রেশন সার্বজনীন ভাষা অজ্ঞেয়বাদ

গুগল অ্যান্টিগ্র্যাভিটি দিয়ে নির্মাণের জন্য আপনাকে ধন্যবাদ!