speccrew 0.7.45 → 0.7.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/.speccrew/agents/speccrew-team-leader.md +6 -6
  2. package/README.ar.md +5 -17
  3. package/README.de.md +5 -17
  4. package/README.en.md +5 -17
  5. package/README.es.md +5 -17
  6. package/README.fr.md +5 -17
  7. package/README.hi.md +384 -0
  8. package/README.ja.md +5 -17
  9. package/README.md +5 -17
  10. package/README.pt-BR.md +5 -17
  11. package/README.ru.md +5 -17
  12. package/docs/GETTING-STARTED.ar.md +39 -40
  13. package/docs/GETTING-STARTED.de.md +39 -40
  14. package/docs/GETTING-STARTED.en.md +39 -40
  15. package/docs/GETTING-STARTED.es.md +39 -40
  16. package/docs/GETTING-STARTED.fr.md +39 -40
  17. package/docs/GETTING-STARTED.hi.md +636 -0
  18. package/docs/GETTING-STARTED.ja.md +39 -40
  19. package/docs/GETTING-STARTED.md +39 -40
  20. package/docs/GETTING-STARTED.pt-BR.md +25 -26
  21. package/docs/GETTING-STARTED.ru.md +37 -38
  22. package/lib/commands/init.js +3 -3
  23. package/package.json +1 -1
  24. package/README.bn.md +0 -174
  25. package/README.bs.md +0 -394
  26. package/README.da.md +0 -394
  27. package/README.el.md +0 -174
  28. package/README.it.md +0 -394
  29. package/README.ko.md +0 -394
  30. package/README.no.md +0 -394
  31. package/README.pl.md +0 -394
  32. package/README.th.md +0 -311
  33. package/README.tr.md +0 -306
  34. package/README.uk.md +0 -306
  35. package/README.vi.md +0 -174
  36. package/README.zh-TW.md +0 -394
  37. package/docs/GETTING-STARTED.bn.md +0 -219
  38. package/docs/GETTING-STARTED.bs.md +0 -219
  39. package/docs/GETTING-STARTED.da.md +0 -637
  40. package/docs/GETTING-STARTED.el.md +0 -633
  41. package/docs/GETTING-STARTED.it.md +0 -639
  42. package/docs/GETTING-STARTED.ko.md +0 -639
  43. package/docs/GETTING-STARTED.no.md +0 -563
  44. package/docs/GETTING-STARTED.pl.md +0 -597
  45. package/docs/GETTING-STARTED.th.md +0 -219
  46. package/docs/GETTING-STARTED.tr.md +0 -597
  47. package/docs/GETTING-STARTED.uk.md +0 -597
  48. package/docs/GETTING-STARTED.vi.md +0 -217
  49. package/docs/GETTING-STARTED.zh-TW.md +0 -639
@@ -1,17 +1,16 @@
1
- # SpecCrew - Руководство по быстрому запуску
1
+ # SpecCrew - Руководство по быстрому запуску
2
2
 
3
3
  <p align="center">
4
4
  <a href="./GETTING-STARTED.md">简体中文</a> |
5
- <a href="./GETTING-STARTED.zh-TW.md">繁體中文</a> |
6
5
  <a href="./GETTING-STARTED.en.md">English</a> |
7
- <a href="./GETTING-STARTED.ko.md">한국어</a> |
8
- <a href="./GETTING-STARTED.de.md">Deutsch</a> |
6
+ <a href="./GETTING-STARTED.ja.md">日本語</a> |
7
+ <a href="./GETTING-STARTED.ru.md">Русский</a> |
9
8
  <a href="./GETTING-STARTED.es.md">Español</a> |
9
+ <a href="./GETTING-STARTED.de.md">Deutsch</a> |
10
10
  <a href="./GETTING-STARTED.fr.md">Français</a> |
11
- <a href="./GETTING-STARTED.it.md">Italiano</a> |
12
- <a href="./GETTING-STARTED.da.md">Dansk</a> |
13
- <a href="./GETTING-STARTED.ja.md">日本語</a> |
14
- <a href="./GETTING-STARTED.ar.md">العربية</a>
11
+ <a href="./GETTING-STARTED.pt-BR.md">Português (Brasil)</a> |
12
+ <a href="./GETTING-STARTED.ar.md">العربية</a> |
13
+ <a href="./GETTING-STARTED.hi.md">हिन्दी</a>
15
14
  </p>
16
15
 
17
16
  Этот документ поможет вам быстро понять, как использовать команду Agent SpecCrew для завершения полной разработки от требований до поставки в соответствии со стандартными инженерными процессами.
@@ -80,22 +79,22 @@ speccrew init --ide qoder
80
79
  Для проектов с существующим исходным кодом рекомендуется сначала инициализировать базу знаний, чтобы агенты понимали вашу кодовую базу:
81
80
 
82
81
  ```
83
- @speccrew-team-leader инициализировать техническую базу знаний
82
+ /speccrew-team-leader инициализировать техническую базу знаний
84
83
  ```
85
84
 
86
85
  Затем:
87
86
 
88
87
  ```
89
- @speccrew-team-leader инициализировать бизнес-базу знаний
88
+ /speccrew-team-leader инициализировать бизнес-базу знаний
90
89
  ```
91
90
 
92
91
  ### Шаг 3: Начните вашу первую задачу
93
92
 
94
93
  ```
95
- @speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]
94
+ /speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]
96
95
  ```
97
96
 
98
- > **Совет**: Если вы не уверены, что делать, просто скажите `@speccrew-team-leader помогите мне начать` — Team Leader автоматически определит статус вашего проекта и направит вас.
97
+ > **Совет**: Если вы не уверены, что делать, просто скажите `/speccrew-team-leader помогите мне начать` — Team Leader автоматически определит статус вашего проекта и направит вас.
99
98
 
100
99
  ---
101
100
 
@@ -104,20 +103,20 @@ speccrew init --ide qoder
104
103
  Не уверены, что делать? Найдите ваш сценарий ниже:
105
104
 
106
105
  - **У меня новое функциональное требование**
107
- `@speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]`
106
+ `/speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]`
108
107
 
109
108
  - **Я хочу сканировать знания существующего проекта**
110
- `@speccrew-team-leader инициализировать техническую базу знаний`
111
- → Затем: `@speccrew-team-leader инициализировать бизнес-базу знаний`
109
+ `/speccrew-team-leader инициализировать техническую базу знаний`
110
+ → Затем: `/speccrew-team-leader инициализировать бизнес-базу знаний`
112
111
 
113
112
  - **Я хочу продолжить предыдущую работу**
114
- `@speccrew-team-leader каков текущий прогресс?`
113
+ `/speccrew-team-leader каков текущий прогресс?`
115
114
 
116
115
  - **Я хочу проверить состояние здоровья системы**
117
116
  → Выполнить в терминале: `speccrew doctor`
118
117
 
119
118
  - **Я не уверен, что делать**
120
- `@speccrew-team-leader помогите мне начать`
119
+ `/speccrew-team-leader помогите мне начать`
121
120
  → Team Leader автоматически определит статус вашего проекта и направит вас
122
121
 
123
122
  ---
@@ -126,14 +125,14 @@ speccrew init --ide qoder
126
125
 
127
126
  | Роль | Agent | Обязанности | Пример команды |
128
127
  |------|-------|-----------------|-----------------|
129
- | Лидер команды | `@speccrew-team-leader` | Навигация по проекту, инициализация базы знаний, проверка статуса | "Помогите мне начать" |
130
- | Менеджер продукта | `@speccrew-product-manager` | Анализ требований, генерация PRD | "У меня новое требование: ..." |
131
- | Дизайнер функций | `@speccrew-feature-designer` | Анализ функций, проектирование спецификаций, API контракты | "Начать проектирование функций для итерации X" |
132
- | Системный дизайнер | `@speccrew-system-designer` | Проектирование архитектуры, детальное проектирование платформы | "Начать системное проектирование для итерации X" |
133
- | Системный разработчик | `@speccrew-system-developer` | Координация разработки, генерация кода | "Начать разработку для итерации X" |
134
- | Менеджер тестирования | `@speccrew-test-manager` | Планирование тестирования, проектирование случаев, выполнение | "Начать тестирование для итерации X" |
128
+ | Лидер команды | `/speccrew-team-leader` | Навигация по проекту, инициализация базы знаний, проверка статуса | "Помогите мне начать" |
129
+ | Менеджер продукта | `/speccrew-product-manager` | Анализ требований, генерация PRD | "У меня новое требование: ..." |
130
+ | Дизайнер функций | `/speccrew-feature-designer` | Анализ функций, проектирование спецификаций, API контракты | "Начать проектирование функций для итерации X" |
131
+ | Системный дизайнер | `/speccrew-system-designer` | Проектирование архитектуры, детальное проектирование платформы | "Начать системное проектирование для итерации X" |
132
+ | Системный разработчик | `/speccrew-system-developer` | Координация разработки, генерация кода | "Начать разработку для итерации X" |
133
+ | Менеджер тестирования | `/speccrew-test-manager` | Планирование тестирования, проектирование случаев, выполнение | "Начать тестирование для итерации X" |
135
134
 
136
- > **Примечание**: Вам не нужно запоминать всех агентов. Просто поговорите с `@speccrew-team-leader`, и он направит ваш запрос к правильному агенту.
135
+ > **Примечание**: Вам не нужно запоминать всех агентов. Просто поговорите с `/speccrew-team-leader`, и он направит ваш запрос к правильному агенту.
137
136
 
138
137
  ---
139
138
 
@@ -172,7 +171,7 @@ flowchart LR
172
171
 
173
172
  **Пример разговора**:
174
173
  ```
175
- @speccrew-team-leader инициализировать техническую базу знаний
174
+ /speccrew-team-leader инициализировать техническую базу знаний
176
175
  ```
177
176
 
178
177
  **Трехфазный процесс**:
@@ -194,7 +193,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
194
193
 
195
194
  **Пример разговора**:
196
195
  ```
197
- @speccrew-team-leader инициализировать бизнес-базу знаний
196
+ /speccrew-team-leader инициализировать бизнес-базу знаний
198
197
  ```
199
198
 
200
199
  **Четырехфазный процесс**:
@@ -220,7 +219,7 @@ speccrew-workspace/knowledges/bizs/
220
219
 
221
220
  **Как начать**:
222
221
  ```
223
- @speccrew-product-manager У меня новое требование: [опишите ваше требование]
222
+ /speccrew-product-manager У меня новое требование: [опишите ваше требование]
224
223
  ```
225
224
 
226
225
  **Рабочий процесс Agent**:
@@ -247,7 +246,7 @@ iterations/{номер}-{тип}-{имя}/01.product-requirement/
247
246
 
248
247
  **Как начать**:
249
248
  ```
250
- @speccrew-feature-designer начать feature design
249
+ /speccrew-feature-designer начать feature design
251
250
  ```
252
251
 
253
252
  **Рабочий процесс Agent**:
@@ -274,7 +273,7 @@ iterations/{iter}/02.feature-design/
274
273
 
275
274
  **Как начать**:
276
275
  ```
277
- @speccrew-system-designer начать system design
276
+ /speccrew-system-designer начать system design
278
277
  ```
279
278
 
280
279
  **Рабочий процесс Agent**:
@@ -305,7 +304,7 @@ iterations/{iter}/03.system-design/
305
304
 
306
305
  **Как начать**:
307
306
  ```
308
- @speccrew-system-developer начать разработку
307
+ /speccrew-system-developer начать разработку
309
308
  ```
310
309
 
311
310
  **Рабочий процесс Agent**:
@@ -336,7 +335,7 @@ iterations/{iter}/04.development/
336
335
 
337
336
  **Как начать**:
338
337
  ```
339
- @speccrew-test-manager начать тестирование
338
+ /speccrew-test-manager начать тестирование
340
339
  ```
341
340
 
342
341
  **Трехфазный процесс тестирования**:
@@ -458,7 +457,7 @@ pending → in_progress → completed → confirmed
458
457
  Просмотр статуса panorama pipeline через Agent Team Leader:
459
458
 
460
459
  ```
461
- @speccrew-team-leader просмотреть текущий прогресс итерации
460
+ /speccrew-team-leader просмотреть текущий прогресс итерации
462
461
  ```
463
462
 
464
463
  Team Leader прочитает файлы прогресса и покажет обзор статуса, подобный:
@@ -560,12 +559,12 @@ npm install -g speccrew@0.5.6
560
559
 
561
560
  | Фаза | Agent | Начальный разговор |
562
561
  |-------|-------|-------------------|
563
- | Инициализация | Team Leader | `@speccrew-team-leader инициализировать техническую базу знаний` |
564
- | Анализ требований | Product Manager | `@speccrew-product-manager У меня новое требование: [описание]` |
565
- | Feature Design | Feature Designer | `@speccrew-feature-designer начать feature design` |
566
- | System Design | System Designer | `@speccrew-system-designer начать system design` |
567
- | Разработка | System Developer | `@speccrew-system-developer начать разработку` |
568
- | Системное тестирование | Test Manager | `@speccrew-test-manager начать тестирование` |
562
+ | Инициализация | Team Leader | `/speccrew-team-leader инициализировать техническую базу знаний` |
563
+ | Анализ требований | Product Manager | `/speccrew-product-manager У меня новое требование: [описание]` |
564
+ | Feature Design | Feature Designer | `/speccrew-feature-designer начать feature design` |
565
+ | System Design | System Designer | `/speccrew-system-designer начать system design` |
566
+ | Разработка | System Developer | `/speccrew-system-developer начать разработку` |
567
+ | Системное тестирование | Test Manager | `/speccrew-test-manager начать тестирование` |
569
568
 
570
569
  ### Контрольный список Checkpoint
571
570
 
@@ -422,13 +422,13 @@ async function runInit(options = {}) {
422
422
  console.log(' 1. Open your project in your IDE (Qoder/Cursor/Claude Code)');
423
423
  console.log('');
424
424
  console.log(' 2. Initialize knowledge base (recommended for existing projects):');
425
- console.log(' → Tell @speccrew-team-leader: "Initialize technical knowledge base"');
425
+ console.log(' → Tell /speccrew-team-leader: "Initialize technical knowledge base"');
426
426
  console.log(' → Then: "Initialize business knowledge base"');
427
427
  console.log('');
428
428
  console.log(' 3. Start your first requirement:');
429
- console.log(' → Tell @speccrew-product-manager: "I have a new requirement: [describe it]"');
429
+ console.log(' → Tell /speccrew-product-manager: "I have a new requirement: [describe it]"');
430
430
  console.log('');
431
- console.log(' Need help? → Tell @speccrew-team-leader: "Help me get started"');
431
+ console.log(' Need help? → Tell /speccrew-team-leader: "Help me get started"');
432
432
  console.log(' Troubleshooting? → Run: speccrew doctor');
433
433
  console.log('');
434
434
  console.log(' Documentation: speccrew-workspace/docs/GETTING-STARTED.md');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "speccrew",
3
- "version": "0.7.45",
3
+ "version": "0.7.46",
4
4
  "description": "Spec-Driven Development toolkit for AI-powered IDEs",
5
5
  "author": "charlesmu99",
6
6
  "repository": {
package/README.bn.md DELETED
@@ -1,174 +0,0 @@
1
- # SpecCrew - AI-চালিত সফ্টওয়্যার ইঞ্জিনিয়ারিং ফ্রেমওয়ার্ক
2
-
3
- <p align="center">
4
- <a href="./README.md">简体中文</a> |
5
- <a href="./README.zh-TW.md">繁體中文</a> |
6
- <a href="./README.en.md">English</a> |
7
- <a href="./README.ko.md">한국어</a> |
8
- <a href="./README.de.md">Deutsch</a> |
9
- <a href="./README.es.md">Español</a> |
10
- <a href="./README.fr.md">Français</a> |
11
- <a href="./README.it.md">Italiano</a> |
12
- <a href="./README.da.md">Dansk</a> |
13
- <a href="./README.ja.md">日本語</a> |
14
- <a href="./README.pl.md">Polski</a> |
15
- <a href="./README.ru.md">Русский</a> |
16
- <a href="./README.bs.md">Bosanski</a> |
17
- <a href="./README.ar.md">العربية</a> |
18
- <a href="./README.no.md">Norsk</a> |
19
- <a href="./README.pt-BR.md">Português (Brasil)</a> |
20
- <a href="./README.th.md">ไทย</a> |
21
- <a href="./README.tr.md">Türkçe</a> |
22
- <a href="./README.uk.md">Українська</a> |
23
- <a href="./README.bn.md">বাংলা</a> |
24
- <a href="./README.el.md">Ελληνικά</a> |
25
- <a href="./README.vi.md">Tiếng Việt</a>
26
- </p>
27
-
28
- <p align="center">
29
- <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
30
- <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
31
- <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
32
- </p>
33
-
34
- > যেকোনো সফ্টওয়্যার প্রকল্পের জন্য দ্রুত ইঞ্জিনিয়ারিং বাস্তবায়ন সক্ষম করে এমন একটি ভার্চুয়াল AI ডেভেলপমেন্ট টিম
35
-
36
- ## SpecCrew কী?
37
-
38
- SpecCrew একটি এম্বেডেড ভার্চুয়াল AI ডেভেলপমেন্ট টিম ফ্রেমওয়ার্ক। এটি পেশাদার সফ্টওয়্যার ইঞ্জিনিয়ারিং ওয়ার্কফ্লো (PRD → Feature Design → System Design → Dev → Deployment → Test) কে পুনরায় ব্যবহারযোগ্য Agent ওয়ার্কফ্লোতে রূপান্তর করে, ডেভেলপমেন্ট টিমগুলিকে Specification-Driven Development (SDD) অর্জনে সাহায্য করে, বিশেষত বিদ্যমান প্রকল্পগুলির জন্য উপযুক্ত।
39
-
40
- বিদ্যমান প্রকল্পগুলিতে Agent এবং Skill সংহত করে, টিমগুলি দ্রুত প্রকল্প ডকুমেন্টেশন সিস্টেম এবং ভার্চুয়াল সফ্টওয়্যার টিম চালু করতে পারে, মানক ইঞ্জিনিয়ারিং ওয়ার্কফ্লো অনুসরণ করে নতুন বৈশিষ্ট্য এবং পরিবর্তন ধাপে ধাপে বাস্তবায়ন করতে পারে।
41
-
42
- ---
43
-
44
- ## ✨ মূল বৈশিষ্ট্য
45
-
46
- ### 🏭 ভার্চুয়াল সফ্টওয়্যার টিম
47
- এক ক্লিকে **7টি পেশাদার Agent ভূমিকা** + **30+টি Skill ওয়ার্কফ্লো** তৈরি, একটি সম্পূর্ণ ভার্চুয়াল সফ্টওয়্যার টিম গঠন:
48
- - **Team Leader** - গ্লোবাল পরিকল্পনা এবং ইটারেশন ব্যবস্থাপনা
49
- - **Product Manager** - প্রয়োজনীয়তা বিশ্লেষণ এবং PRD আউটপুট
50
- - **Feature Designer** - বৈশিষ্ট্য ডিজাইন + API চুক্তি
51
- - **System Designer** - Frontend/Backend/Mobile/Desktop সিস্টেম ডিজাইন
52
- - **System Developer** - মাল্টিপ্ল্যাটফর্ম সমান্তরাল উন্নয়ন
53
- - **Test Manager** - তিন-পর্যায়ের পরীক্ষা সমন্বয়
54
- - **Task Worker** - সমান্তরাল উপ-কার্য সম্পাদন
55
-
56
- ### 📐 ISA-95 ছয়-পর্যায়ের মডেলিং
57
- আন্তর্জাতিক **ISA-95** মডেলিং পদ্ধতির উপর ভিত্তি করে, ব্যবসায়িক প্রয়োজনীয়তা থেকে সফ্টওয়্যার সিস্টেমে রূপান্তরের মানকায়ন:
58
- ```
59
- Domain Descriptions → Functions in Domains → Functions of Interest
60
- ↓ ↓ ↓
61
- Information Flows → Categories of Information → Information Descriptions
62
- ```
63
- - প্রতিটি পর্যায় নির্দিষ্ট UML ডায়াগ্রামের সাথে সামঞ্জস্যপূর্ণ (use case, sequence, class)
64
- - ব্যবসায়িক প্রয়োজনীয়তা "ধাপে ধাপে পরিশোধিত" হয়, তথ্য ক্ষতি ছাড়াই
65
- - আউটপুটগুলি উন্নয়নের জন্য সরাসরি ব্যবহারযোগ্য
66
-
67
- ### 📚 জ্ঞান ভিত্তি সিস্টেম
68
- তিন-স্তরের জ্ঞান ভিত্তি আর্কিটেকচার নিশ্চিত করে যে AI সর্বদা "একক সত্যের উৎস" এর উপর ভিত্তি করে কাজ করে:
69
-
70
- | স্তর | ডিরেক্টরি | বিষয়বস্তু | উদ্দেশ্য |
71
- |------|-----------|-----------|----------|
72
- | L1 সিস্টেম জ্ঞান | `knowledge/techs/` | টেক স্ট্যাক, আর্কিটেকচার, কনভেনশন | AI প্রকল্পের প্রযুক্তিগত সীমানা বোঝে |
73
- | L2 ব্যবসায়িক জ্ঞান | `knowledge/bizs/` | মডিউল ফাংশন, ব্যবসায়িক প্রবাহ, সত্তা | AI ব্যবসায়িক যুক্তি বোঝে |
74
- | L3 ইটারেশন আর্টিফ্যাক্ট | `iterations/iXXX/` | PRD, ডিজাইন ডকুমেন্ট, পরীক্ষার প্রতিবেদন | বর্তমান প্রয়োজনীয়তার জন্য সম্পূর্ণ ট্রেসেবিলিটি চেইন |
75
-
76
- ### 🔄 চার-পর্যায়ের জ্ঞান পাইপলাইন
77
- **স্বয়ংক্রিয় জ্ঞান উৎপাদন আর্কিটেকচার**, সোর্স কোড থেকে ব্যবসায়িক/প্রযুক্তিগত ডকুমেন্টেশনের স্বয়ংক্রিয় উৎপাদন:
78
- ```
79
- পর্যায় 1: সোর্স কোড স্ক্যান → মডিউল তালিকা তৈরি
80
- পর্যায় 2: সমান্তরাল বিশ্লেষণ → বৈশিষ্ট্য বের করা (মাল্টি-ওয়ার্কার সমান্তরাল)
81
- পর্যায় 3: সমান্তরাল সারাংশ → মডিউল ওভারভিউ সম্পূর্ণ করা (মাল্টি-ওয়ার্কার সমান্তরাল)
82
- পর্যায় 4: সিস্টেম সংযোজন → সিস্টেম প্যানোরামা তৈরি
83
- ```
84
- - **পূর্ণ সিঙ্কronization** এবং **ইনক্রিমেন্টাল সিঙ্কronization** সমর্থন করে (Git diff ভিত্তিক)
85
- - একজন ব্যক্তি অপ্টিমাইজ করে, টিম শেয়ার করে
86
-
87
- ### 🔧 Harness বাস্তবায়ন কাঠামো
88
- **স্ট্যান্ডার্ডাইজড এক্সিকিউশন ফ্রেমওয়ার্ক**, ডিজাইন ডকুমেন্টকে নির্ভুলভাবে এক্সিকিউটেবল ডেভেলপমেন্ট নির্দেশাবলীতে রূপান্তর নিশ্চিত করে:
89
- - **অপারেশন ম্যানুয়াল নীতি**: Skill হল SOP, ধাপগুলি স্পষ্ট, ধারাবাহিক, স্বয়ংসম্পূর্ণ
90
- - **ইনপুট-আউটপুট চুক্তি**: ইন্টারফেস স্পষ্টভাবে সংজ্ঞায়িত, সিউডোকোডের মতো কঠোরভাবে কার্যকর
91
- - **গ্র্যাডুয়াল ডিসক্লোজার আর্কিটেকচার**: তথ্য স্তরে স্তরে লোড হয়, একবারে অত্যধিক প্রসঙ্গ এড়ায়
92
- - **সাব-এজেন্ট ডেলিগেশন**: জটিল কাজ স্বয়ংক্রিয়ভাবে বিভক্ত হয়, সমান্তরাল কার্যকরীকরণ গুণমান নিশ্চিত করে
93
-
94
- ---
95
-
96
- ## ৮টি মূল সমস্যা সমাধান
97
-
98
- ### ১. AI বিদ্যমান প্রকল্প ডকুমেন্টেশন উপেক্ষা করে (জ্ঞান ব্যবধান)
99
- **সমস্যা**: বিদ্যমান SDD বা Vibe Coding পদ্ধতিগুলি AI-এর রিয়েল-টাইমে প্রকল্প সারাংশ করার উপর নির্ভর করে, সহজেই গুরুত্বপূর্ণ প্রসঙ্গ মিস হয় এবং ডেভেলপমেন্ট ফলাফল প্রত্যাশা থেকে বিচ্যুত হয়।
100
-
101
- **সমাধান**: `knowledge/` রিপোজিটরি প্রকল্পের "একমাত্র সত্যের উৎস" হিসাবে কাজ করে, আর্কিটেকচার ডিজাইন, কার্যকরী মডিউল এবং ব্যবসায়িক প্রক্রিয়াগুলি জমা করে নিশ্চিত করে যে প্রয়োজনীয়তাগুলি উৎস থেকে পথে থাকে।
102
-
103
- ### ২. PRD থেকে সরাসরি প্রযুক্তিগত ডকুমেন্টেশন (বিষয়বস্তু বাদ পড়া)
104
- **সমস্যা**: PRD থেকে সরাসরি বিস্তারিত ডিজাইনে যাওয়া সহজেই প্রয়োজনীয়তার বিস্তারিত মিস হয়, বাস্তবায়িত বৈশিষ্ট্যগুলি প্রয়োজনীয়তা থেকে বিচ্যুত হয়।
105
-
106
- **সমাধান**: প্রযুক্তিগত বিস্তারিত ছাড়াই শুধুমাত্র প্রয়োজনীয়তার কঙ্কালে ফোকাস করে **Feature Design ডকুমেন্ট** পর্যায় প্রবর্তন করুন:
107
- - কোন পৃষ্ঠা এবং উপাদান অন্তর্ভুক্ত?
108
- - পৃষ্ঠা অপারেশন প্রবাহ
109
- - ব্যাকেন্ড প্রক্রিয়াকরণ লজিক
110
- - ডেটা স্টোরেজ কাঠামো
111
-
112
- ডেভেলপমেন্ট শুধুমাত্র নির্দিষ্ট টেক স্ট্যাকের উপর ভিত্তি করে "মাংস পূরণ করতে" হবে, নিশ্চিত করে যে বৈশিষ্ট্যগুলি "হাড়ের কাছাকাছি (প্রয়োজনীয়তা)" বৃদ্ধি পায়।
113
-
114
- ### ৩. Agent সার্চ সুযোগ অনিশ্চিত (অনিশ্চয়তা)
115
- **সমস্যা**: জটিল প্রকল্পগুলিতে, AI-এর বিস্তৃত কোড এবং ডকুমেন্ট সার্চ অনিশ্চিত ফলাফল দেয়, সামঞ্জস্যতা নিশ্চিত করা কঠিন করে তোলে।
116
-
117
- **সমাধান**: প্রতিটি Agent-এর প্রয়োজনের উপর ভিত্তি করে ডিজাইন করা স্পষ্ট ডকুমেন্ট ডিরেক্টরি কাঠামো এবং টেমপ্লেট, নিশ্চিততা নিশ্চিত করতে **ধাপে ধাপে প্রকাশ এবং চাহিদা অনুযায়ী লোডিং** বাস্তবায়ন করে।
118
-
119
- ### ৪. ধাপ এবং কাজ অনুপস্থিত (প্রক্রিয়া বিচ্ছেদ)
120
- **সমস্যা**: সম্পূর্ণ ইঞ্জিনিয়ারিং প্রক্রিয়া কভারেজের অভাব সহজেই গুরুত্বপূর্ণ ধাপ মিস করে, গুণমান নিশ্চিত করা কঠিন করে তোলে।
121
-
122
- **সমাধান**: সম্পূর্ণ সফ্টওয়্যার ইঞ্জিনিয়ারিং জীবনচক্র কভার করুন:
123
- ```
124
- PRD (প্রয়োজনীয়তা) → Feature Design (বৈশিষ্ট্য ডিজাইন) → API Contract (চুক্তি)
125
- → System Design (সিস্টেম ডিজাইন) → Dev (ডেভেলপমেন্ট) → Deployment (স্থাপনা) → Test (পরীক্ষা)
126
- ```
127
- - প্রতিটি পর্যায়ের আউটপুট পরবর্তী পর্যায়ের ইনপুট
128
- - প্রতিটি ধাপ এগিয়ে যাওয়ার আগে মানব নিশ্চিতকরণ প্রয়োজন
129
- - সমস্ত Agent কার্যকরীকরণে সম্পন্ন হওয়ার পরে স্ব-পরীক্ষা সহ todo তালিকা আছে
130
-
131
- ### ৫. কম টিম সহযোগিতা দক্ষতা (জ্ঞান সিলো)
132
- **সমস্যা**: AI প্রোগ্রামিং অভিজ্ঞতা টিমগুলির মধ্যে ভাগ করা কঠিন, পুনরাবৃত্ত ত্রুটির দিকে নিয়ে যায়।
133
-
134
- **সমাধান**: সমস্ত Agent, Skill এবং সম্পর্কিত ডকুমেন্ট সোর্স কোডের সাথে ভার্সন কন্ট্রোল করা হয়:
135
- - একজনের অপ্টিমাইজেশন টিম দ্বারা ভাগ করা হয়
136
- - জ্ঞান কোড বেসে জমা হয়
137
- - টিম সহযোগিতা দক্ষতা উন্নত হয়
138
-
139
- ### ৭. একক Agent প্রসঙ্গ খুব দীর্ঘ (পারফরম্যান্স বাধা)
140
- **সমস্যা**: বড় জটিল কাজগুলি একক Agent প্রসঙ্গ উইন্ডো অতিক্রম করে, বোঝাপড়া বিচ্যুতি এবং আউটপুট গুণমান হ্রাস ঘটায়।
141
-
142
- **সমাধান**: **Sub-Agent অটো-ডিসপ্যাচ মেকানিজম**:
143
- - জটিল কাজগুলি স্বয়ংক্রিয়ভাবে চিহ্নিত হয় এবং সাব-টাস্কে বিভক্ত হয়
144
- - প্রতিটি সাব-টাস্ক বিচ্ছিন্ন প্রসঙ্গ সহ একটি স্বাধীন Sub-Agent দ্বারা কার্যকর করা হয়
145
- - প্যারেন্ট Agent সমন্বয় এবং একত্রিত করে সামগ্রিক সামঞ্জস্য নিশ্চিত করে
146
- - একক Agent প্রসঙ্গ সম্প্রসারণ এড়িয়ে আউটপুট গুণমান নিশ্চিত করে
147
-
148
- ### ৮. প্রয়োজনীয়তা পুনরাবৃত্তি বিশৃঙ্খলা (ব্যবস্থাপনা অসুবিধা)
149
- **সমস্যা**: একই শাখায় মিশ্রিত একাধিক প্রয়োজনীয়তা একে অপরকে প্রভাবিত করে, ট্র্যাকিং এবং রোলব্যাক কঠিন করে তোলে।
150
-
151
- **সমাধান**: **প্রতিটি প্রয়োজনীয়তা একটি স্বাধীন প্রকল্প হিসাবে**:
152
- - প্রতিটি প্রয়োজনীয়তা একটি স্বাধীন পুনরাবৃত্তি ডিরেক্টরি তৈরি করে `iterations/iXXX-[প্রয়োজনীয়তা-নাম]/`
153
- - সম্পূর্ণ বিচ্ছিন্নতা: ডকুমেন্ট, ডিজাইন, কোড এবং পরীক্ষা স্বাধীনভাবে পরিচালিত
154
- - দ্রুত পুনরাবৃত্তি: ছোট গ্রানুলারিটি ডেলিভারি, দ্রুত যাচাইকরণ, দ্রুত স্থাপন
155
- - নমনীয় আর্কাইভিং: সম্পন্ন হওয়ার পরে, স্পষ্ট ঐতিহাসিক ট্রেসেবিলিটি সহ `archive/`-এ আর্কাইভ করুন
156
-
157
- ### ৬. ডকুমেন্ট আপডেট বিলম্ব (জ্ঞান ক্ষয়)
158
- **সমস্যা**: প্রকল্পগুলি বিকশিত হওয়ার সাথে সাথে ডকুমেন্টগুলি পুরানো হয়ে যায়, AI ভুল তথ্য নিয়ে কাজ করে।
159
-
160
- **সমাধান**: Agent-এর স্বয়ংক্রিয় ডকুমেন্ট আপডেট ক্ষমতা আছে, জ্ঞান বেস সঠিক রাখতে রিয়েল-টাইমে প্রকল্প পরিবর্তনগুলি সিঙ্ক্রোনাইজ করে।
161
-
162
- ---
163
-
164
- ## আরও তথ্য
165
-
166
- - **Agent জ্ঞান মানচিত্র**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
167
- - **npm**: https://www.npmjs.com/package/speccrew
168
- - **GitHub**: https://github.com/charlesmu99/speccrew
169
- - **Gitee**: https://gitee.com/amutek/speccrew
170
- - **Qoder IDE**: https://qoder.com/
171
-
172
- ---
173
-
174
- > **SpecCrew ডেভেলপারদের প্রতিস্থাপন করার লক্ষ্য নয়, বরং বোরিং অংশগুলি স্বয়ংক্রিয় করে যাতে টিমগুলি আরও মূল্যবান কাজে ফোকাস করতে পারে।**