GitHub Spec Kit দিয়ে AI কোডিং: আগে পরিকল্পনা, তারপর কোড

AI কোডিং এজেন্টকে এক লাইনে বললেন “একটা অ্যাপ বানাও”, সে বানিয়েও দিল, কিন্তু দুই দিন পর দেখলেন কোড এলোমেলো, অর্ধেক ফিচার নেই, বাকি অর্ধেক আপনি চানইনি। এই সমস্যার সমাধান হিসেবেই এসেছে Spec-Driven Development: আগে লিখিত পরিকল্পনা, তারপর কোড। আর এই পদ্ধতিটাকে সহজ করে দিয়েছে GitHub-এর ফ্রি ওপেন-সোর্স টুলকিট Spec Kit।

Spec-Driven Development আসলে কী?

সাধারণ “ভাইব কোডিং”-এ আপনি চ্যাটে যা বলেন, এজেন্ট সঙ্গে সঙ্গে কোড লিখতে বসে। ভাবনাটা চ্যাটের সঙ্গেই হারিয়ে যায়। Spec-Driven Development-এ উল্টোটা ঘটে: প্রথমে তিনটি লিখিত নথি তৈরি হয়:

  • Specification (spec.md): কী বানানো হচ্ছে এবং কেন, ব্যবহারকারীর ভাষায়। কোন প্রযুক্তি, তা এখানে থাকে না।
  • Plan (plan.md): কোন প্রযুক্তি ও কাঠামো দিয়ে বানানো হবে, তার কারিগরি পরিকল্পনা।
  • Tasks (tasks.md): কাজের ধাপে ধাপে ভাঙা তালিকা, যেটি ধরে এজেন্ট একে একে এগোয়।

প্রতিটি ধাপে এজেন্ট খসড়া বানায়, আপনি পড়ে ঠিক করেন, তারপর পরের ধাপ। ফলে ভুল পথে যাওয়া কোড অনেক আগেই ধরা পড়ে, আর মাস পরে ফিরে এলেও নথি দেখেই বোঝা যায় সিদ্ধান্তগুলো কেন নেওয়া হয়েছিল।

Spec Kit কী এবং কী কী লাগবে?

Spec Kit কোনো নতুন AI মডেল নয়; এটি একটি প্রক্রিয়া ও টেমপ্লেটের সেট, যা আপনার বিদ্যমান কোডিং এজেন্টের ওপর বসে। GitHub এটি MIT লাইসেন্সে ফ্রি প্রকাশ করেছে (সংস্করণ 1.0 এসেছে আগস্ট 2026-এ), এবং এটি ৪০টির বেশি এজেন্টের সঙ্গে কাজ করে, যার মধ্যে আছে Claude Code, GitHub Copilot, Gemini CLI, Cursor ও Codex।

শুরু করতে যা লাগবে:

  • Python 3.11 বা তার পরের সংস্করণ
  • uv টুল (Python প্যাকেজ চালানোর জন্য)
  • সমর্থিত যেকোনো একটি AI কোডিং এজেন্ট
  • একটি Git রেপো (নতুন বা পুরোনো, দুটোতেই চলে)

AI শেখার একদম শুরুতে থাকলে আগে আমাদের ফ্রিতে AI শেখার কোর্সের তালিকাটা দেখে ভিত্তিটা তৈরি করে নিন, তারপর এই পদ্ধতিতে আসুন।

ইনস্টল: দুটি কমান্ডেই তৈরি

টার্মিনালে প্রথমে Specify CLI ইনস্টল করুন, তারপর আপনার এজেন্ট অনুযায়ী প্রজেক্ট তৈরি করুন (উদাহরণে Copilot):

uv tool install specify-cli
specify init my-project --integration copilot
cd my-project

এরপর প্রজেক্ট ফোল্ডারে আপনার কোডিং এজেন্টটি চালু করুন। মনে রাখবেন, পরের সব কমান্ড টার্মিনালে নয়, এজেন্টের চ্যাটে চালাতে হয়। এজেন্টভেদে লেখার ধরন আলাদা হতে পারে: কোথাও /speckit.specify, কোথাও /speckit-specify, Codex-এ $speckit-specify; কাজ একই।

মূল ধাপগুলো: constitution থেকে converge

  • Constitution (একবার, পুরো প্রজেক্টের জন্য): প্রজেক্টের স্থায়ী নীতিমালা ঠিক করা, যেমন কোডের মান, টেস্টিং ও রক্ষণাবেক্ষণের নিয়ম। এটি constitution.md ফাইলে থাকে এবং প্রতিটি ফিচারে প্রযোজ্য হয়।
  • Specify: ফিচারটির বর্ণনা দিন, কী ও কেন। এজেন্ট spec.md তৈরি করে।
  • Clarify: স্পেসিফিকেশনের ফাঁক ও অস্পষ্ট জায়গাগুলো প্রশ্ন করে পরিষ্কার করা হয়। এই ধাপ বাদ দেবেন না, বেশিরভাগ ভুল এখানেই ধরা পড়ে।
  • Plan: প্রযুক্তি ও কাঠামো ঠিক করে plan.md তৈরি হয়।
  • Tasks: প্ল্যান ভেঙে tasks.md-তে কাজের তালিকা তৈরি হয়।
  • Analyze: spec, plan ও tasks পরস্পরের সঙ্গে মিলছে কিনা যাচাই (কিছু লেখা হয় না, শুধু প্রতিবেদন)।
  • Implement: এজেন্ট তালিকা ধরে আসল কোড লেখে।
  • Converge: তৈরি কোড আবার spec ও প্ল্যানের সঙ্গে মিলিয়ে দেখা হয়; বাকি থাকা কাজ নতুন টাস্ক হিসেবে যোগ হয়। Converged না বলা পর্যন্ত implement ও converge চালাতে হয়।

শুনতে লম্বা মনে হলেও ছোট ফিচারের জন্য অফিসিয়াল দ্রুত পথ আছে মাত্র পাঁচ ধাপে: specify, plan, tasks, implement, converge।

কার জন্য এই পদ্ধতি, কার জন্য নয়?

  • উপযোগী: মাঝারি বা বড় প্রজেক্ট, দলগত কাজ, ক্লায়েন্টের কাজ, বা যেকোনো কোড যেটি মাসের পর মাস চালাতে হবে। নথি থাকায় অন্য ডেভেলপার (বা ভবিষ্যতে আপনি নিজে) সহজে যোগ দিতে পারেন।
  • অপ্রয়োজনীয়: একবারের ছোট স্ক্রিপ্ট, দ্রুত পরীক্ষা-নিরীক্ষা বা প্রোটোটাইপ। সেখানে সরাসরি প্রম্পটই যথেষ্ট; প্রক্রিয়ার ভার লাভের চেয়ে বেশি হবে।

নতুনদের সাধারণ তিনটি ভুল

  • Clarify ধাপ বাদ দেওয়া: অস্পষ্ট স্পেসিফিকেশন থেকে জন্ম নেয় ভুল কোড। প্রশ্নগুলোর উত্তর দিতে পাঁচ মিনিট সময় দিন।
  • Spec না পড়েই implement চালানো: প্রতিটি ধাপের শেষে নথিটা অন্তত একবার পড়ুন; এজেন্টের খসড়াই চূড়ান্ত সত্য নয়।
  • Constitution-এ নিয়ম লিখে ভুলে যাওয়া: এজেন্ট বারবার কোনো নিয়ম ভাঙলে সেই নিয়মটি ফাইলের উপরের দিকে তুলে দিন; শুরুর দিকের নিয়মে এজেন্ট বেশি গুরুত্ব দেয়।

সাধারণ প্রশ্ন (FAQ)

Spec Kit কি সম্পূর্ণ ফ্রি?

হ্যাঁ। Spec Kit নিজে MIT লাইসেন্সে ফ্রি ও ওপেন-সোর্স। তবে মনে রাখবেন, এটি দিয়ে চালানো কোডিং এজেন্টটির (যেমন Claude Code বা Copilot) নিজস্ব সাবস্ক্রিপশন খরচ আলাদা, সেটি Spec Kit-এর খরচ নয়।

আমার এজেন্ট কি সমর্থিত?

সম্ভবত হ্যাঁ। Claude Code, GitHub Copilot, Gemini CLI, Cursor ও Codexসহ ৪০টির বেশি এজেন্ট সমর্থিত। প্রজেক্ট তৈরির সময় –integration দিয়ে নিজের এজেন্টটি বেছে দিন।

পুরোনো প্রজেক্টে কি Spec Kit যোগ করা যায়?

যায়। বিদ্যমান রেপোর ভেতরে specify init চালালেই প্রয়োজনীয় ফাইল ও কমান্ড যোগ হয়ে যায়; পুরো প্রজেক্ট নতুন করে বানাতে হয় না।

স্পেসিফিকেশন কি বাংলায় লেখা যাবে?

আপনার এজেন্ট বাংলা বুঝলে লেখা যাবে। তবে দলগত প্রজেক্টে বা অন্য ডেভেলপারের সঙ্গে ভাগ করতে হলে ইংরেজিতে নথি রাখা সুবিধাজনক। একা নিজের প্রজেক্টে যেটিতে স্বচ্ছন্দ, সেটিই সেরা।

M

Musa Kazim

EndxTech-এর প্রতিষ্ঠাতা ও লেখক। বাংলায় AI টুলস, মোবাইল টিপস আর প্রযুক্তির সহজ গাইড লিখি। Facebook পেজে যুক্ত হোন

Leave a Reply