প্রকল্প সম্পর্কে

# improve — শক্তিশালী মডেল দিয়ে অডিট, সস্তা দিয়ে এক্সিকিউট `improve` হলো একটি এজেন্ট স্কিল (Agent Skills ফরম্যাট) যা যেকোনো কোডবেস অডিট করে এবং অন্য এজেন্টদের এক্সিকিউশনের জন্য বাস্তবায়ন পরিকল্পনা লেখে। মূল ধারণা: আপনার সবচেয়ে সক্ষম মডেলটি সেই অংশে ব্যয় করুন যেখানে বুদ্ধিমত্তা বৃদ্ধি পায় — কোডবেস বোঝা, কী করা মূল্যবান তা বিচার করা, স্পেক লেখা — এবং এক্সিকিউশন সস্তা মডেলের হাতে তুলে দিন। স্কিলটি নিজে কখনো কিছু বাস্তবায়ন করে না; পরিকল্পনাই হলো পণ্য। ``` আপনি → /improve (দামি মডেল, পরামর্শ দেয়) plans/ → 001-fix-n-plus-one.md (স্বয়ংসম্পূর্ণ স্পেক) অন্য এজেন্ট → বাস্তবায়ন, পরীক্ষা, প্রকাশ (সস্তা মডেল, এক্সিকিউট করে) ``` ## ইনস্টল ```bash npx skills add shadcn/improve ``` এটি Agent Skills ফরম্যাট সমর্থন করে এমন যেকোনো এজেন্টে কাজ করে। পরিকল্পনাগুলো প্লেইন মার্কডাউন, তাই যেকোনো এজেন্ট বা মানুষ সেগুলো তুলে নিতে পারে। ## কমান্ড - `/improve` — সম্পূর্ণ অডিট → অগ্রাধিকারপ্রাপ্ত ফলাফল → পরিকল্পনা - `/improve quick` — সস্তা পাস: হটস্পট, শুধু শীর্ষ ফলাফল - `/improve deep` — বিস্তারিত: প্রতিটি প্যাকেজ, প্রতিটি বিভাগ - `/improve security` — ফোকাসড অডিট (এছাড়াও পারফ, টেস্ট, বাগ, ...) - `/improve branch` — শুধু বর্তমান ব্রাঞ্চ যা পরিবর্তন করে তা অডিট করুন - `/improve next` — ফিচার পরামর্শ, প্রজেক্টকে কোথায় নেওয়া যায় - `/improve plan <বর্ণনা>` — অডিট এড়িয়ে যান, একটি জিনিস স্পেক করুন - `/improve review-plan <ফাইল>` — বিদ্যমান পরিকল্পনা সমালোচনা ও শক্ত করুন - `/improve execute <পরিকল্পনা>` — সস্তা এক্সিকিউটর পাঠান, এর কাজ পর্যালোচনা করুন - `/improve reconcile` — ব্যাকলগ রিফ্রেশ করুন: যাচাই, আনব্লক, অবসর - `--issues` — পরিকল্পনাগুলো GitHub ইস্যু হিসেবেও প্রকাশ করুন ## সাধারণ প্রথম রান 1. রিপোতে আপনার এজেন্ট খুলুন এবং `/improve` চালান (বা সস্তা রাখতে `/improve quick`)। 2. এটি রিপো ম্যাপ করে, অডিট করে এবং একটি ফলাফল টেবিল ফিরিয়ে দেয়। আপনি যেগুলো পরিকল্পনা করতে চান সেগুলো উত্তর দিন, যেমন "plan 1, 3 and 5"। 3. পরিকল্পনাগুলো `plans/`-এ জমা হয় — প্রতিটি ফাইল, সাথে প্রস্তাবিত ক্রম সহ একটি সূচক। সেগুলো পর্যালোচনার জন্য তৈরি। 4. যেকোনো এজেন্টকে একটি পরিকল্পনা দিন ("implement plans/001-*.md"), অথবা স্কিলটি চালাতে দিন: `/improve execute 001` একটি বিচ্ছিন্ন ওয়ার্কট্রিতে একটি সস্তা মডেল পাঠায়, পরিকল্পনার বিরুদ্ধে ডিফ পর্যালোচনা করে এবং একটি রায় জানায়। মার্জ করা আপনার উপরই থাকে। 5. পরবর্তী সেশনে, `/improve reconcile` ব্যাকলগ পরিষ্কার করে: কী এসেছে তা যাচাই করে, কী বিচ্যুত হয়েছে তা রিফ্রেশ করে, কী আটকে গেছে তা আনব্লক করে। একটি PR-এর আগে, `/improve branch` একই প্রক্রিয়াকে শুধু ব্রাঞ্চ যা পরিবর্তন করে তাতে সীমাবদ্ধ করে। ## এটি কীভাবে কাজ করে - **রিকন।** রিপো ম্যাপ করে: স্ট্যাক, কনভেনশন এবং সঠিক বিল্ড/টেস্ট/লিন্ট কমান্ড, যা প্রতিটি পরিকল্পনায় যাচাইকরণ গেট হয়ে ওঠে। এটি উপস্থিত থাকলে উদ্দেশ্য এবং ডিজাইন ডকও অন্তর্ভুক্ত করে — ADR (`docs/adr/`), PRD, `CONTEXT.md`, `DESIGN.md`, `PRODUCT.md` — যাতে সিদ্ধান্ত নেওয়া ট্রেডঅফ পুনরায় চিহ্নিত না হয়, দিকনির্দেশনা প্রস্তাবনা উল্লিখিত পণ্য উদ্দেশ্যের উপর ভিত্তি করে থাকে এবং পরিকল্পনাগুলো রিপোর নিজস্ব শব্দভাণ্ডার ব্যবহার করে। - **অডিট।** নয়টি বিভাগে সমান্তরাল সাবএজেন্ট পাঠায়: সঠিকতা, নিরাপত্তা, পারফরম্যান্স, টেস্ট কভারেজ, টেক ডেট, ডিপেন্ডেন্সি ও মাইগ্রেশন, DX, ডক্স এবং দিকনির্দেশনা (ফিচার পরামর্শ অবশ্যই রিপো থেকেই প্রমাণ উদ্ধৃত করতে হবে)। প্রতিটি ফলাফলে `file:line` প্রমাণ, প্রভাব, প্রচেষ্টা এবং আত্মবিশ্বাস থাকে। - **ভেট।** সাবএজেন্টরা অতিরিক্ত রিপোর্ট করে বলে, উপদেষ্টা কিছু দেখানোর আগে প্রতিটি উদ্ধৃত অবস্থান পুনরায় পড়ে; মিথ্যা ইতিবাচক বাদ দেওয়া হয়, ভুল দায় সংশোধন করা হয়, প্রত্যাখ্যান রেকর্ড করা হয়। - **অগ্রাধিকার।** ফলাফলগুলো লিভারেজ অনুসারে ক্রমযুক্ত একটি টেবিলে আসে (প্রভাব ÷ প্রচেষ্টা, আত্মবিশ্বাস দ্বারা ওজনযুক্ত)। আপনি সিদ্ধান্ত নেন কী পরিকল্পনা হবে। - **পরিকল্পনা।** `plans/`-এ নির্বাচিত প্রতিটি ফলাফলের জন্য একটি ফাইল, সাথে একটি সূচক, অগ্রাধিকার ক্রম এবং নির্ভরতা গ্রাফ। ## পরিকল্পনাগুলোকে কী এক্সিকিউটেবল করে পরিকল্পনাগুলো সবচেয়ে দুর্বল সম্ভাব্য এক্সিকিউটরকে লক্ষ্য করে — একটি মডেল যা উপদেষ্টা সেশন দেখেনি এবং অনেক ছোট হতে পারে। তিনটি বৈশিষ্ট্য এটি বহন করে: - **স্বয়ংসম্পূর্ণ।** সমস্ত প্রসঙ্গ ইনলাইন করা: সঠিক ফাইল পাথ, বর্তমান-অবস্থা কোড উদ্ধৃতি, একটি উদাহরণ ফাইল সহ রিপো কনভেনশন, যাচাই করা কমান্ড। কোনো "উপরে আলোচনা করা হয়েছে" নেই। - **যাচাইকরণ গেট।** প্রতিটি ধাপ একটি কমান্ড এবং এর প্রত্যাশিত আউটপুট দিয়ে শেষ হয়; সম্পন্ন মানদণ্ড মেশিন-পরীক্ষাযোগ্য, তাই এক্সিকিউটরকে সাফল্য বিচার করতে হয় না। - **কঠোর সীমানা।** স্পষ্ট আউট-অফ-স্কোপ তালিকা এবং STOP শর্ত ("যদি X, থামুন এবং রিপোর্ট করুন") একটি ছোট মডেলকে বাস্তবতা পরিকল্পনার সাথে মেলে না এমন পরিস্থিতিতে ইম্প্রোভাইজ করতে দেওয়ার পরিবর্তে। প্রতিটি পরিকল্পনা যে git কমিটের বিরুদ্ধে লেখা হয়েছে তা স্ট্যাম্প করে, যাতে এক্সিকিউটররা কিছু স্পর্শ করার আগে একটি যান্ত্রিক ড্রিফট চেক চালাতে পারে। ## লুপ বন্ধ করা - **`execute <পরিকল্পনা>`** একটি বিচ্ছিন্ন git ওয়ার্কট্রিতে একটি সস্তা এক্সিকিউটর সাবএজেন্ট তৈরি করে, এটিকে পরিকল্পনা দেয়, তারপর ফলাফলটি টেক লিডের মতো পর্যালোচনা করে — প্রতিটি সম্পন্ন মানদণ্ড পুনরায় চালায়, স্কোপ সম্মতি পরীক্ষা করে, উদ্দেশ্যের বিরুদ্ধে ডিফ পড়ে। রায়: অনুমোদন (মার্জ করা আপনার কল), সংশোধনের জন্য ফেরত পাঠান (সর্বোচ্চ ২ রাউন্ড), অথবা ব্লক করুন এবং পরিকল্পনা পরিমার্জন করুন। - **`reconcile`** এরপর যা ঘটেছে তা প্রক্রিয়া করে: DONE পরিকল্পনা এখনও ধরে আছে কিনা তা যাচাই করে, BLOCKED গুলো তদন্ত করে এবং বাধার চারপাশে পুনরায় লেখে, বিচ্যুত পরিকল্পনা রিফ্রেশ করে, স্বাধীনভাবে ঠিক করা ফলাফল অবসর দেয়। - **`--issues`** পরিকল্পনাগুলো একই স্বয়ংসম্পূর্ণ বডি সহ GitHub ইস্যু হিসাবে প্রকাশ করে, যাতে যেকোনো এজেন্ট বা মানুষ সেগুলো তুলে নিতে পারে যেখানে কাজ ইতিমধ্যে থাকে। ## কঠোর নিয়ম - নিজে কখনো সোর্স কোড পরিবর্তন করে না। একমাত্র লেখা `plans/`-এ যায়; এক্সিকিউটররা শুধুমাত্র নিষ্পত্তিযোগ্য ওয়ার্কট্রিতে সম্পাদনা করে এবং মার্জ করা সর্বদা আপনার। - ওয়ার্কিং ট্রি পরিবর্তন করে এমন কমান্ড কখনো চালায় না — শুধুমাত্র পড়া, অনুসন্ধান এবং শুধুমাত্র-পঠন বিশ্লেষণ। - গোপন মান পুনরুত্পাদন করে না; শুধুমাত্র অবস্থান এবং ক্রেডেনশিয়াল প্রকার, ঘূর্ণন সর্বদা সুপারিশ করা হয়। - বাস্তবায়ন করতে বলা হলে, এটি অস্বীকার করে এবং পরিকল্পনার দিকে নির্দেশ করে (অথবা `execute` অফার করে)। ## লাইসেন্স MIT © shadcn