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

SDD + ADD স্টার্টার টেমপ্লেটটি AI প্রোগ্রামিং সহায়কদের জন্য, বিশেষ করে ক্লড কোডের জন্য একটি শাসন কাঠামো। এর প্রাথমিক লক্ষ্য হলো AI সহায়ককে একটি শৃঙ্খলাবদ্ধ উন্নয়ন অংশীদারে রূপান্তর করা যা স্পেক-চালিত উন্নয়ন (SDD) ওয়ার্কফ্লো এবং এজেন্ট-চালিত উন্নয়ন (ADD) এর সাথে মিল রেখে কাজ করে। ## মূল ওয়ার্কফ্লো টেমপ্লেটটি একটি ক্রমিক উন্নয়ন ওয়ার্কফ্লো প্রয়োগ করে: CONTEXT → SPEC → PLAN → TASKS → execute → verify → sync। প্রতিটি ধাপে একটি চেকপয়েন্ট থাকে এবং এজেন্টকে কার্যকর করার অনুমতি দেওয়ার আগে মানুষের অনুমোদন প্রয়োজন। ## তিনটি মৌলিক নিয়ম 1. **স্পেক সম্পাদনা করুন, কোড নয়**: যখন একটি প্রয়োজনীয়তা অনুপস্থিত বা অস্পষ্ট থাকে, তখন প্রথমে `/sdd-update` কমান্ড ব্যবহার করে স্পেক আপডেট করুন, তারপর আচরণ পরিবর্তনের আগে এটি পর্যালোচনা করুন। 2. **কোনো প্রযুক্তিগত অনুমান নয়**: পরিকল্পনা, কাজ এবং কার্যকরীকরণে শুধুমাত্র `.sdd/architecture-profile.md`-এ অনুমোদিত বাইন্ডিং এবং সঠিক যাচাইকরণ কমান্ড ব্যবহার করা হয়। 3. **মানুষ সিদ্ধান্ত নেয়**: এজেন্ট নিজেকে অনুমোদন করে না, `git push` করে না, ডিপ্লয় করে না এবং স্বায়ত্তশাসিতভাবে শারীরিক অবস্থা পরিবর্তন করে না। ## মালিকানা এবং কার্যকরীকরণ টেমপ্লেটটি `.sdd/shared_context.md`-এ দুটি স্বাধীন অক্ষ আলাদা করে: - **প্রজেক্ট মালিকানা** (`solo` বা `team`): মানুষের পর্যালোচনার বৈধতা এবং Git ডেলিভারি নীতি নির্ধারণ করে। ডিফল্ট `team`। - **এজেন্ট কার্যকরীকরণ** (`direct` বা `orchestrated`): `/add-execute` বর্তমান এজেন্টে সরাসরি চলে বা রানটাইম ক্ষমতা পর্যবেক্ষণের পরে কর্মীদের সংগঠিত করে। ## ডকুমেন্টেশন টেমপ্লেটটি একটি বিস্তৃত ডকুমেন্টেশন সিস্টেম প্রদান করে: - **কুইক স্টার্ট** (`docs/sdd-add-quickstart.md`): নতুনদের জন্য ধাপে ধাপে রোডম্যাপ। - **অপারেশন গাইড** (`docs/sdd-add-guide.md`): আর্টিফ্যাক্ট, গেট এবং মালিকানা বুঝুন। - **কুইক রেফারেন্স** (`docs/sdd-add-field-guide.md`): পরিস্থিতি অনুযায়ী কমান্ড নির্বাচন করুন। - **পরিস্থিতি প্লেবুক** (`docs/sdd-add-scenario-playbook.md`): গ্রিনফিল্ড, ব্রাউনফিল্ড, ত্রুটি এবং হ্যান্ডঅফ পরিচালনা করুন। - **আর্কিটেকচার প্রোফাইল গাইড** (`docs/architecture-profile-guide.md`): বাইন্ডিং এবং প্রযুক্তিগত কমান্ড নির্বাচন করুন। - **এক্সিকিউশন গাইড** (`docs/multi-agent-orchestration-guide.md`): কাজ/বৈশিষ্ট্য কার্যকরীকরণ এবং কর্মী সংগঠন। ## ক্যানোনিকাল সোর্স - `.claude/skills/`: কমান্ডের জন্য চুক্তি। - `.claude/skills/_shared/ai-review-protocol.md`: পর্যালোচনা প্রোটোকল, পদ্ধতি এবং অ্যাকশন রেকর্ড। - `.sdd/architecture-profile.md`: প্রযুক্তিগত বাইন্ডিং এবং সঠিক যাচাইকরণ কমান্ড। - `CONSTITUTION.md`: নিরাপত্তা, আর্কিটেকচার এবং মানের উপর কঠোর নিয়ম। - `AGENTS.md`: এজেন্টের সুযোগ এবং অনুমতি। ## ইউটিলিটি স্ক্রিপ্ট - `scripts/self-heal.sh`: প্রমাণ সংগ্রহ করতে একটি অনুমোদিত কমান্ড চালায়; সোর্স পরিবর্তন করে না বা পুনরায় চেষ্টা করে না। - `scripts/template-smoke.sh` / `.ps1`: ফাইল, লিঙ্ক এবং নীতি চুক্তির জন্য স্ট্যাটিক চেক। - `scripts/adopt.*`: বিদ্যমান রিপোজিটরিতে টেমপ্লেটটি গ্রহণ করুন। - `scripts/update.*`: টেমপ্লেট থেকে আপডেট টানুন; শাসন ফাইলগুলি মানুষের পর্যালোচনার জন্য মঞ্চায়িত হয়।