speccrew 0.1.1 → 0.1.3

package/README.ar.md

@@ -1,10 +1,34 @@
 # SpecCrew - إطار عمل هندسة البرمجيات المدعوم بالذكاء الاصطناعي
 
 <p align="center">
-  <a href="./README.md">中文</a> |
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
   <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
   <a href="./README.ar.md">العربية</a> |
-  <a href="./README.es.md">Español</a>
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
 </p>
 
 > فريق تطوير افتراضي بالذكاء الاصطناعي يتيح التنفيذ الهندسي السريع لأي مشروع برمجي
@@ -93,7 +117,7 @@ graph LR
     B --> C[API Contract<br/>عقد الواجهة]
     C --> D[Design<br/>التصميم التفصيلي]
     D --> E[Dev<br/>التنفيذ]
-    E --> F[Test<br/>الاختبار]
+    E --> F[System Test<br/>اختبار النظام]
     F --> G[Archive<br/>الأرشفة]
     
     H[Knowledge<br/>المستودع] -.-> A
@@ -113,7 +137,7 @@ graph LR
 | Solution | Planner | PRD | الحل التقني + عقد API | ✅ مطلوب |
 | Design | Designer | Solution | مستندات التصميم الأمامي/الخلفي | ✅ مطلوب |
 | Dev | Dev | Design | الكود + سجلات المهام | ✅ مطلوب |
-| Test | Test | مخرجات Dev + معايير قبول PRD | تقرير الاختبار | ✅ مطلوب |
+| System Test | Test Manager | مخرجات Dev + Feature Spec | حالات الاختبار + كود الاختبار + تقرير الاختبار + تقرير الأخطاء | ✅ مطلوب |
 
 ---
 
@@ -134,100 +158,71 @@ graph LR
 
 ## البدء السريع
 
-### 1. تثبيت SpecCrew
-
-**الطريقة 1: سكريبت التثبيت بنقرة واحدة (موصى به، Qoder IDE فقط)**
-
-```bash
-# macOS / Linux / WSL - التثبيت من GitHub
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.sh | bash
-
-# macOS / Linux / WSL - التثبيت من Gitee (مرآة الصين)
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.sh | bash
-```
+### المتطلبات المسبقة
 
-```powershell
-# Windows - التثبيت من GitHub
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.ps1").Content
+- Node.js >= 16.0.0
+- IDEs المدعومة: Qoder (افتراضي)، Cursor، Claude Code
 
-# Windows - التثبيت من Gitee (مرآة الصين)
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.ps1").Content
-```
-
-> **ملاحظة**: سكريبت التثبيت بنقرة واحدة يدعم حالياً Qoder IDE فقط. للـ IDEs الأخرى (VS Code, Cursor, إلخ)، يرجى استخدام طريقة النسخ اليدوي أدناه.
+> **ملاحظة**: لم يتم اختبار محولات Cursor و Claude Code في بيئات IDE الفعلية (تم تنفيذها على مستوى الكود والتحقق منها من خلال اختبارات E2E، ولكن لم يتم اختبارها بعد في Cursor/Claude Code الحقيقي).
 
-**الطريقة 2: النسخ اليدوي (عالمي لجميع IDEs)**
+### 1. تثبيت SpecCrew
 
 ```bash
-# استنساخ المستودع والنسخ إلى مشروع موجود
-git clone https://github.com/charlesmu99/SpecCrew.git
-# أو: git clone https://gitee.com/amutek/SpecCrew.git
-
-# نسخ إلى المشروع الهدف (تعديل حسب دليل تكوين IDE الخاص بك)
-cp -r SpecCrew/.speccrew /path/to/your-project/
-cp -r SpecCrew/SpecCrew-workspace /path/to/your-project/
-
-# لـ Qoder IDE، انسخ أيضًا إلى دليل .qoder/
-cp -r SpecCrew/.speccrew/agents/* /path/to/your-project/.qoder/agents/
-cp -r SpecCrew/.speccrew/skills/* /path/to/your-project/.qoder/skills/
+npm install -g speccrew
 ```
 
 ### 2. تهيئة المشروع
 
+انتقل إلى الدليل الجذر لمشروعك وقم بتشغيل أمر التهيئة:
+
 ```bash
-# تشغيل مهارة التهيئة لإنشاء قاعدة المعرفة وهيكل المشروع تلقائياً
-# يتم تنفيذها تلقائياً بواسطة مهارة SpecCrew-project-init
-```
+cd /path/to/your-project
 
-### 3. بدء سير عمل التطوير
+# الافتراضي يستخدم Qoder
+speccrew init
 
-```bash
-# 1. إنشاء PRD
-# 2. إنشاء Solution
-# 3. تأكيد عقد API
-# 4. التصميم التفصيلي
-# 5. تنفيذ التطوير
-# 6. الاختبار
+# أو تحديد IDE
+speccrew init --ide qoder
+speccrew init --ide cursor
+speccrew init --ide claude
 ```
 
-### 4. إلغاء تثبيت SpecCrew
+بعد التهيئة، سيتم إنشاء ما يلي في مشروعك:
+- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 تعريفات أدوار Agent
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 سير عمل Skill
+- `speccrew-workspace/` — مساحة العمل (أدلة التكرار، قاعدة المعرفة، قوالب المستندات)
+- `.speccrewrc` — ملف تكوين SpecCrew
 
-**الطريقة 1: سكريبت إلغاء التثبيت بنقرة واحدة (موصى به، Qoder IDE فقط)**
+لتحديث Agents و Skills لـ IDE معين لاحقاً:
 
 ```bash
-# macOS / Linux / WSL - إلغاء التثبيت من GitHub
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.sh | bash
-
-# macOS / Linux / WSL - إلغاء التثبيت من Gitee (مرآة الصين)
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.sh | bash
+speccrew update --ide cursor
+speccrew update --ide claude
 ```
 
-```powershell
-# Windows - إلغاء التثبيت من GitHub
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.ps1").Content
-
-# Windows - إلغاء التثبيت من Gitee (مرآة الصين)
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.ps1").Content
-```
+### 3. بدء سير عمل التطوير
 
-> **ملاحظة**: سكريبت إلغاء التثبيت بنقرة واحدة يدعم حالياً Qoder IDE فقط.
+اتبع سير عمل الهندسة القياسي خطوة بخطوة:
 
-**الطريقة 2: إلغاء التثبيت اليدوي (عالمي لجميع IDEs)**
+1. **PRD**: يقوم Product Manager Agent بتحليل المتطلبات وإنشاء وثيقة متطلبات المنتج
+2. **Feature Design**: يقوم Feature Designer Agent بإنشاء وثيقة تصميم الميزات + عقد API
+3. **System Design**: يقوم System Designer Agent بإنشاء مستندات تصميم النظام حسب المنصة (واجهة/خلفية/محمول/سطح مكتب)
+4. **Dev**: يقوم System Developer Agent بتنفيذ التطوير حسب المنصة بالتوازي
+5. **System Test**: يقوم Test Manager Agent بتنسيق اختبار ثلاثي المراحل (تصميم الحالات → توليد الكود → تقرير التنفيذ)
+6. **Archive**: أرشفة التكرار
 
-```bash
-# حذف دليل SpecCrew-workspace
-rm -rf SpecCrew-workspace/
+> تتطلب مخرجات كل مرحلة تأكيداً بشرياً قبل الانتقال إلى المرحلة التالية.
 
-# حذف الملفات ببادئة SpecCrew- في .speccrew/ (الحفاظ على المحتوى المخصص)
-rm -rf .speccrew/agents/SpecCrew-*.md
-rm -rf .speccrew/skills/SpecCrew-*/
+### 4. أوامر CLI الأخرى
 
-# لـ Qoder IDE، نظف أيضًا دليل .qoder/
-rm -rf .qoder/agents/SpecCrew-*.md
-rm -rf .qoder/skills/SpecCrew-*/
+```bash
+speccrew list       # عرض قائمة agents و skills المثبتة
+speccrew doctor     # تشخيص البيئة وحالة التثبيت
+speccrew update     # تحديث agents و skills إلى أحدث إصدار
+speccrew uninstall  # إلغاء تثبيت SpecCrew (--all يحذف أيضاً مساحة العمل)
 ```
 
-> **ملاحظة**: سيؤدي إلغاء التثبيت إلى الحفاظ على ملفات المصدر والمحتوى المخصص في `.speccrew/`. لإزالة تكوينات IDE بالكامل، احذف دليل التكوين المقابل يدوياً (مثل `.qoder/`).
+📖 **دليل تفصيلي**: بعد التثبيت، راجع [دليل البدء السريع](docs/GETTING-STARTED.ar.md) للاطلاع على سير العمل الكامل ودليل المحادثة مع الوكلاء.
 
 ---
 
@@ -235,40 +230,51 @@ rm -rf .qoder/skills/SpecCrew-*/
 
 ```
 your-project/
-├── .speccrew/                       # ملفات مصدر SpecCrew (قابلة للتحكم في الإصدار)
-├── .qoder/                          # تكوين Qoder IDE (وقت التشغيل)
-│   ├── agents/                      # 6 وكلاء الأدوار
-│   └── skills/                      # 16 مهارة
+├── .qoder/                          # دليل تكوين IDE (مثال Qoder)
+│   ├── agents/                      # 7 وكلاء أدوار
+│   │   ├── speccrew-team-leader.md       # قائد الفريق: الجدولة العامة وإدارة التكرار
+│   │   ├── speccrew-product-manager.md   # مدير المنتج: تحليل المتطلبات و PRD
+│   │   ├── speccrew-feature-designer.md  # مصمم الميزات: Feature Design + عقد API
+│   │   ├── speccrew-system-designer.md   # مصمم النظام: تصميم النظام حسب المنصة
+│   │   ├── speccrew-system-developer.md  # مطور النظام: التطوير المتوازي حسب المنصة
+│   │   ├── speccrew-test-manager.md      # مدير الاختبار: تنسيق الاختبار ثلاثي المراحل
+│   │   └── speccrew-task-worker.md       # عامل المهام: تنفيذ المهام الفرعية المتوازية
+│   └── skills/                      # 38 مهارة (مجمعة حسب الوظيفة)
+│       ├── speccrew-pm-*/                # إدارة المنتج (تحليل المتطلبات، التقييم)
+│       ├── speccrew-fd-*/                # تصميم الميزات (Feature Design، عقد API)
+│       ├── speccrew-sd-*/                # تصميم النظام (واجهة/خلفية/محمول/سطح مكتب)
+│       ├── speccrew-dev-*/               # التطوير (واجهة/خلفية/محمول/سطح مكتب)
+│       ├── speccrew-test-*/              # الاختبار (تصميم الحالات/توليد الكود/تقرير التنفيذ)
+│       ├── speccrew-knowledge-bizs-*/    # معرفة الأعمال (تحليل API/تحليل UI/تصنيف الوحدات، إلخ)
+│       ├── speccrew-knowledge-techs-*/   # المعرفة التقنية (توليد المكدس/الاتفاقيات/الفهرس، إلخ)
+│       ├── speccrew-knowledge-graph-*/   # رسم المعرفة (قراءة/كتابة/استعلام)
+│       └── speccrew-*/                   # الأدوات (التشخيص/الطوابع الزمنية/سير العمل، إلخ)
 │
-└── SpecCrew-workspace/              # مساحة العمل (يتم إنشاؤها أثناء التهيئة)
+└── speccrew-workspace/              # مساحة العمل (تُنشأ أثناء التهيئة)
     ├── docs/                        # المستندات الإدارية
+    │   ├── configs/                 # ملفات التكوين (تعيين المنصة، تعيين المكدس التقني، إلخ)
     │   ├── rules/                   # تكوينات القواعد
     │   └── solutions/               # مستندات الحلول
-    │       └── agent-knowledge-map.md
     │
-    ├── iterations/                  # مشاريع التكرار (يتم إنشاؤها ديناميكياً)
-    │   └── {رقم}-{نوع}-{اسم}/       # مثال: 001-feature-order
+    ├── iterations/                  # مشاريع التكرار (تُنشأ ديناميكياً)
+    │   └── {رقم}-{نوع}-{اسم}/
     │       ├── 00.docs/             # المتطلبات الأصلية
     │       ├── 01.product-requirement/ # متطلبات المنتج
     │       ├── 02.feature-design/   # تصميم الميزات
     │       ├── 03.system-design/    # تصميم النظام
     │       ├── 04.development/      # مرحلة التطوير
-    │       ├── 05.test/             # مرحلة الاختبار
+    │       ├── 05.system-test/      # اختبار النظام
     │       └── 06.delivery/         # مرحلة التسليم
     │
     ├── iteration-archives/          # أرشيف التكرار
-    │   └── {رقم}-{نوع}-{اسم}-{تاريخ}/
     │
     └── knowledges/                  # قاعدة المعرفة
-        ├── base/                    # البيانات الوصفية الأساسية
+        ├── base/                    # الأساس/البيانات الوصفية
         │   ├── diagnosis-reports/   # تقارير التشخيص
         │   ├── sync-state/          # حالة المزامنة
         │   └── tech-debts/          # الديون التقنية
-        │
-        ├── bizs/                    # المعرفة التجارية
-        │   └── {نوع-المنصة}/
-        │       └── {اسم-الوحدة}/
-        │
+        ├── bizs/                    # معرفة الأعمال
+        │   └── {نوع-المنصة}/{اسم-الوحدة}/
         └── techs/                   # المعرفة التقنية
             └── {معرف-المنصة}/
 ```
@@ -304,9 +310,10 @@ your-project/
 
 ## مزيد من المعلومات
 
-- **خريطة معرفة الوكيل**: [SpecCrew-workspace/docs/agent-knowledge-map.md](./SpecCrew-workspace/docs/agent-knowledge-map.md)
-- **GitHub**: https://github.com/charlesmu99/SpecCrew
-- **Gitee**: https://gitee.com/amutek/SpecCrew
+- **خريطة معرفة الوكيل**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
+- **GitHub**: https://github.com/charlesmu99/speccrew
+- **Gitee**: https://gitee.com/amutek/speccrew
 - **Qoder IDE**: https://qoder.com/
 
 ---

package/README.bn.md

@@ -0,0 +1,122 @@
+# SpecCrew - AI-চালিত সফ্টওয়্যার ইঞ্জিনিয়ারিং ফ্রেমওয়ার্ক
+
+<p align="center">
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
+  <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
+  <a href="./README.ar.md">العربية</a> |
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
+</p>
+
+> যেকোনো সফ্টওয়্যার প্রকল্পের জন্য দ্রুত ইঞ্জিনিয়ারিং বাস্তবায়ন সক্ষম করে এমন একটি ভার্চুয়াল AI ডেভেলপমেন্ট টিম
+
+## SpecCrew কী?
+
+SpecCrew একটি এম্বেডেড ভার্চুয়াল AI ডেভেলপমেন্ট টিম ফ্রেমওয়ার্ক। এটি পেশাদার সফ্টওয়্যার ইঞ্জিনিয়ারিং ওয়ার্কফ্লো (PRD → Feature Design → System Design → Dev → Test) কে পুনরায় ব্যবহারযোগ্য Agent ওয়ার্কফ্লোতে রূপান্তর করে, ডেভেলপমেন্ট টিমগুলিকে Specification-Driven Development (SDD) অর্জনে সাহায্য করে, বিশেষত বিদ্যমান প্রকল্পগুলির জন্য উপযুক্ত।
+
+বিদ্যমান প্রকল্পগুলিতে Agent এবং Skill সংহত করে, টিমগুলি দ্রুত প্রকল্প ডকুমেন্টেশন সিস্টেম এবং ভার্চুয়াল সফ্টওয়্যার টিম চালু করতে পারে, মানক ইঞ্জিনিয়ারিং ওয়ার্কফ্লো অনুসরণ করে নতুন বৈশিষ্ট্য এবং পরিবর্তন ধাপে ধাপে বাস্তবায়ন করতে পারে।
+
+---
+
+## ৮টি মূল সমস্যা সমাধান
+
+### ১. AI বিদ্যমান প্রকল্প ডকুমেন্টেশন উপেক্ষা করে (জ্ঞান ব্যবধান)
+**সমস্যা**: বিদ্যমান SDD বা Vibe Coding পদ্ধতিগুলি AI-এর রিয়েল-টাইমে প্রকল্প সারাংশ করার উপর নির্ভর করে, সহজেই গুরুত্বপূর্ণ প্রসঙ্গ মিস হয় এবং ডেভেলপমেন্ট ফলাফল প্রত্যাশা থেকে বিচ্যুত হয়।
+
+**সমাধান**: `knowledge/` রিপোজিটরি প্রকল্পের "একমাত্র সত্যের উৎস" হিসাবে কাজ করে, আর্কিটেকচার ডিজাইন, কার্যকরী মডিউল এবং ব্যবসায়িক প্রক্রিয়াগুলি জমা করে নিশ্চিত করে যে প্রয়োজনীয়তাগুলি উৎস থেকে পথে থাকে।
+
+### ২. PRD থেকে সরাসরি প্রযুক্তিগত ডকুমেন্টেশন (বিষয়বস্তু বাদ পড়া)
+**সমস্যা**: PRD থেকে সরাসরি বিস্তারিত ডিজাইনে যাওয়া সহজেই প্রয়োজনীয়তার বিস্তারিত মিস হয়, বাস্তবায়িত বৈশিষ্ট্যগুলি প্রয়োজনীয়তা থেকে বিচ্যুত হয়।
+
+**সমাধান**: প্রযুক্তিগত বিস্তারিত ছাড়াই শুধুমাত্র প্রয়োজনীয়তার কঙ্কালে ফোকাস করে **Feature Design ডকুমেন্ট** পর্যায় প্রবর্তন করুন:
+- কোন পৃষ্ঠা এবং উপাদান অন্তর্ভুক্ত?
+- পৃষ্ঠা অপারেশন প্রবাহ
+- ব্যাকেন্ড প্রক্রিয়াকরণ লজিক
+- ডেটা স্টোরেজ কাঠামো
+
+ডেভেলপমেন্ট শুধুমাত্র নির্দিষ্ট টেক স্ট্যাকের উপর ভিত্তি করে "মাংস পূরণ করতে" হবে, নিশ্চিত করে যে বৈশিষ্ট্যগুলি "হাড়ের কাছাকাছি (প্রয়োজনীয়তা)" বৃদ্ধি পায়।
+
+### ৩. Agent সার্চ সুযোগ অনিশ্চিত (অনিশ্চয়তা)
+**সমস্যা**: জটিল প্রকল্পগুলিতে, AI-এর বিস্তৃত কোড এবং ডকুমেন্ট সার্চ অনিশ্চিত ফলাফল দেয়, সামঞ্জস্যতা নিশ্চিত করা কঠিন করে তোলে।
+
+**সমাধান**: প্রতিটি Agent-এর প্রয়োজনের উপর ভিত্তি করে ডিজাইন করা স্পষ্ট ডকুমেন্ট ডিরেক্টরি কাঠামো এবং টেমপ্লেট, নিশ্চিততা নিশ্চিত করতে **ধাপে ধাপে প্রকাশ এবং চাহিদা অনুযায়ী লোডিং** বাস্তবায়ন করে।
+
+### ৪. ধাপ এবং কাজ অনুপস্থিত (প্রক্রিয়া বিচ্ছেদ)
+**সমস্যা**: সম্পূর্ণ ইঞ্জিনিয়ারিং প্রক্রিয়া কভারেজের অভাব সহজেই গুরুত্বপূর্ণ ধাপ মিস করে, গুণমান নিশ্চিত করা কঠিন করে তোলে।
+
+**সমাধান**: সম্পূর্ণ সফ্টওয়্যার ইঞ্জিনিয়ারিং জীবনচক্র কভার করুন:
+```
+PRD (প্রয়োজনীয়তা) → Feature Design (বৈশিষ্ট্য ডিজাইন) → API Contract (চুক্তি)
+    → System Design (সিস্টেম ডিজাইন) → Dev (ডেভেলপমেন্ট) → Test (পরীক্ষা)
+```
+- প্রতিটি পর্যায়ের আউটপুট পরবর্তী পর্যায়ের ইনপুট
+- প্রতিটি ধাপ এগিয়ে যাওয়ার আগে মানব নিশ্চিতকরণ প্রয়োজন
+- সমস্ত Agent কার্যকরীকরণে সম্পন্ন হওয়ার পরে স্ব-পরীক্ষা সহ todo তালিকা আছে
+
+### ৫. কম টিম সহযোগিতা দক্ষতা (জ্ঞান সিলো)
+**সমস্যা**: AI প্রোগ্রামিং অভিজ্ঞতা টিমগুলির মধ্যে ভাগ করা কঠিন, পুনরাবৃত্ত ত্রুটির দিকে নিয়ে যায়।
+
+**সমাধান**: সমস্ত Agent, Skill এবং সম্পর্কিত ডকুমেন্ট সোর্স কোডের সাথে ভার্সন কন্ট্রোল করা হয়:
+- একজনের অপ্টিমাইজেশন টিম দ্বারা ভাগ করা হয়
+- জ্ঞান কোড বেসে জমা হয়
+- টিম সহযোগিতা দক্ষতা উন্নত হয়
+
+### ৭. একক Agent প্রসঙ্গ খুব দীর্ঘ (পারফরম্যান্স বাধা)
+**সমস্যা**: বড় জটিল কাজগুলি একক Agent প্রসঙ্গ উইন্ডো অতিক্রম করে, বোঝাপড়া বিচ্যুতি এবং আউটপুট গুণমান হ্রাস ঘটায়।
+
+**সমাধান**: **Sub-Agent অটো-ডিসপ্যাচ মেকানিজম**:
+- জটিল কাজগুলি স্বয়ংক্রিয়ভাবে চিহ্নিত হয় এবং সাব-টাস্কে বিভক্ত হয়
+- প্রতিটি সাব-টাস্ক বিচ্ছিন্ন প্রসঙ্গ সহ একটি স্বাধীন Sub-Agent দ্বারা কার্যকর করা হয়
+- প্যারেন্ট Agent সমন্বয় এবং একত্রিত করে সামগ্রিক সামঞ্জস্য নিশ্চিত করে
+- একক Agent প্রসঙ্গ সম্প্রসারণ এড়িয়ে আউটপুট গুণমান নিশ্চিত করে
+
+### ৮. প্রয়োজনীয়তা পুনরাবৃত্তি বিশৃঙ্খলা (ব্যবস্থাপনা অসুবিধা)
+**সমস্যা**: একই শাখায় মিশ্রিত একাধিক প্রয়োজনীয়তা একে অপরকে প্রভাবিত করে, ট্র্যাকিং এবং রোলব্যাক কঠিন করে তোলে।
+
+**সমাধান**: **প্রতিটি প্রয়োজনীয়তা একটি স্বাধীন প্রকল্প হিসাবে**:
+- প্রতিটি প্রয়োজনীয়তা একটি স্বাধীন পুনরাবৃত্তি ডিরেক্টরি তৈরি করে `iterations/iXXX-[প্রয়োজনীয়তা-নাম]/`
+- সম্পূর্ণ বিচ্ছিন্নতা: ডকুমেন্ট, ডিজাইন, কোড এবং পরীক্ষা স্বাধীনভাবে পরিচালিত
+- দ্রুত পুনরাবৃত্তি: ছোট গ্রানুলারিটি ডেলিভারি, দ্রুত যাচাইকরণ, দ্রুত স্থাপন
+- নমনীয় আর্কাইভিং: সম্পন্ন হওয়ার পরে, স্পষ্ট ঐতিহাসিক ট্রেসেবিলিটি সহ `archive/`-এ আর্কাইভ করুন
+
+### ৬. ডকুমেন্ট আপডেট বিলম্ব (জ্ঞান ক্ষয়)
+**সমস্যা**: প্রকল্পগুলি বিকশিত হওয়ার সাথে সাথে ডকুমেন্টগুলি পুরানো হয়ে যায়, AI ভুল তথ্য নিয়ে কাজ করে।
+
+**সমাধান**: Agent-এর স্বয়ংক্রিয় ডকুমেন্ট আপডেট ক্ষমতা আছে, জ্ঞান বেস সঠিক রাখতে রিয়েল-টাইমে প্রকল্প পরিবর্তনগুলি সিঙ্ক্রোনাইজ করে।
+
+---
+
+## আরও তথ্য
+
+- **Agent জ্ঞান মানচিত্র**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
+- **GitHub**: https://github.com/charlesmu99/speccrew
+- **Gitee**: https://gitee.com/amutek/speccrew
+- **Qoder IDE**: https://qoder.com/
+
+---
+
+> **SpecCrew ডেভেলপারদের প্রতিস্থাপন করার লক্ষ্য নয়, বরং বোরিং অংশগুলি স্বয়ংক্রিয় করে যাতে টিমগুলি আরও মূল্যবান কাজে ফোকাস করতে পারে।**