speccrew 0.1.0 → 0.1.2

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 (52) hide show
  1. package/README.ar.md +98 -91
  2. package/README.bn.md +122 -0
  3. package/README.bs.md +321 -0
  4. package/README.da.md +321 -0
  5. package/README.de.md +321 -0
  6. package/README.el.md +122 -0
  7. package/README.en.md +92 -85
  8. package/README.es.md +96 -89
  9. package/README.fr.md +321 -0
  10. package/README.it.md +321 -0
  11. package/README.ja.md +321 -0
  12. package/README.ko.md +321 -0
  13. package/README.md +92 -109
  14. package/README.no.md +321 -0
  15. package/README.pl.md +321 -0
  16. package/README.pt-BR.md +321 -0
  17. package/README.ru.md +321 -0
  18. package/README.th.md +239 -0
  19. package/README.tr.md +239 -0
  20. package/README.uk.md +239 -0
  21. package/README.vi.md +122 -0
  22. package/README.zh-TW.md +321 -0
  23. package/bin/cli.js +5 -1
  24. package/bin/postinstall.js +157 -0
  25. package/docs/GETTING-STARTED.ar.md +452 -0
  26. package/docs/GETTING-STARTED.bn.md +449 -0
  27. package/docs/GETTING-STARTED.bs.md +449 -0
  28. package/docs/GETTING-STARTED.da.md +448 -0
  29. package/docs/GETTING-STARTED.de.md +448 -0
  30. package/docs/GETTING-STARTED.el.md +449 -0
  31. package/docs/GETTING-STARTED.en.md +448 -0
  32. package/docs/GETTING-STARTED.es.md +448 -0
  33. package/docs/GETTING-STARTED.fr.md +448 -0
  34. package/docs/GETTING-STARTED.it.md +448 -0
  35. package/docs/GETTING-STARTED.ja.md +448 -0
  36. package/docs/GETTING-STARTED.ko.md +448 -0
  37. package/docs/GETTING-STARTED.md +448 -0
  38. package/docs/GETTING-STARTED.no.md +449 -0
  39. package/docs/GETTING-STARTED.pl.md +449 -0
  40. package/docs/GETTING-STARTED.pt-BR.md +449 -0
  41. package/docs/GETTING-STARTED.ru.md +449 -0
  42. package/docs/GETTING-STARTED.th.md +449 -0
  43. package/docs/GETTING-STARTED.tr.md +449 -0
  44. package/docs/GETTING-STARTED.uk.md +449 -0
  45. package/docs/GETTING-STARTED.vi.md +449 -0
  46. package/docs/GETTING-STARTED.zh-TW.md +448 -0
  47. package/lib/commands/init.js +238 -41
  48. package/lib/commands/uninstall.js +150 -32
  49. package/lib/commands/update.js +159 -24
  50. package/lib/ide-adapters.js +257 -3
  51. package/lib/utils.js +23 -7
  52. package/package.json +16 -5
@@ -0,0 +1,449 @@
1
+ # SpecCrew - দ্রুত শুরু করার নির্দেশিকা
2
+
3
+ <p align="center">
4
+ <a href="./GETTING-STARTED.md">简体中文</a> |
5
+ <a href="./GETTING-STARTED.zh-TW.md">繁體中文</a> |
6
+ <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> |
9
+ <a href="./GETTING-STARTED.es.md">Español</a> |
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> |
15
+ <a href="./GETTING-STARTED.bn.md">বাংলা</a>
16
+ </p>
17
+
18
+ এই নথিটি আপনাকে SpecCrew এজেন্ট টিম কীভাবে ব্যবহার করে প্রয়োজনীয়তা থেকে ডেলিভারি পর্যন্ত সম্পূর্ণ উন্নয়ন চক্র সম্পন্ন করতে সাহায্য করে, মানক ইঞ্জিনিয়ারিং প্রক্রিয়া অনুসরণ করে।
19
+
20
+ ---
21
+
22
+ ## 1. প্রাকশর্ত
23
+
24
+ ### SpecCrew ইনস্টল করুন
25
+
26
+ ```bash
27
+ npm install -g speccrew
28
+ ```
29
+
30
+ ### প্রজেক্ট শুরু করুন
31
+
32
+ ```bash
33
+ speccrew init --ide qoder
34
+ ```
35
+
36
+ সমর্থিত IDE: `qoder`, `cursor`, `claude`, `codex`
37
+
38
+ ### শুরু করার পরে ডিরেক্টরি কাঠামো
39
+
40
+ ```
41
+ .
42
+ ├── .qoder/
43
+ │ ├── agents/ # এজেন্ট সংজ্ঞা ফাইল
44
+ │ └── skills/ # স্কিল সংজ্ঞা ফাইল
45
+ ├── speccrew-workspace/ # ওয়ার্কস্পেস
46
+ │ ├── docs/ # কনফিগারেশন, নিয়ম, টেমপ্লেট, সমাধান
47
+ │ ├── iterations/ # বর্তমান ইটারেশন
48
+ │ ├── iteration-archives/ # আর্কাইভ করা ইটারেশন
49
+ │ └── knowledges/ # জ্ঞান ভিত্তি
50
+ │ ├── base/ # মূল তথ্য (ডায়াগনস্টিক রিপোর্ট, প্রযুক্তিগত ঋণ)
51
+ │ ├── bizs/ # ব্যবসায়িক জ্ঞান ভিত্তি
52
+ │ └── techs/ # প্রযুক্তিগত জ্ঞান ভিত্তি
53
+ ```
54
+
55
+ ### CLI কমান্ড দ্রুত রেফারেন্স
56
+
57
+ | কমান্ড | বিবরণ |
58
+ |---------|-------------|
59
+ | `speccrew list` | উপলব্ধ সমস্ত এজেন্ট এবং স্কিল তালিকাভুক্ত করুন |
60
+ | `speccrew doctor` | ইনস্টলেশনের অখণ্ডতা পরীক্ষা করুন |
61
+ | `speccrew update` | প্রজেক্ট কনফিগারেশন সর্বশেষ সংস্করণে আপডেট করুন |
62
+ | `speccrew uninstall` | SpecCrew আনইনস্টল করুন |
63
+
64
+ ---
65
+
66
+ ## 2. ওয়ার্কফ্লো ওভারভিউ
67
+
68
+ ### সম্পূর্ণ ফ্লো ডায়াগ্রাম
69
+
70
+ ```mermaid
71
+ flowchart LR
72
+ PRD[পর্যায় 1<br/>প্রয়োজনীয়তা বিশ্লেষণ<br/>Product Manager] --> FD[পর্যায় 2<br/>ফিচার ডিজাইন<br/>Feature Designer]
73
+ FD --> SD[পর্যায় 3<br/>সিস্টেম ডিজাইন<br/>System Designer]
74
+ SD --> DEV[পর্যায় 4<br/>উন্নয়ন<br/>System Developer]
75
+ DEV --> TEST[পর্যায় 5<br/>সিস্টেম পরীক্ষা<br/>Test Manager]
76
+ TEST --> ARCHIVE[পর্যায় 6<br/>আর্কাইভ]
77
+
78
+ KB[(জ্ঞান ভিত্তি<br/>সমগ্র প্রক্রিয়া জুড়ে)] -.-> PRD
79
+ KB -.-> FD
80
+ KB -.-> SD
81
+ KB -.-> DEV
82
+ KB -.-> TEST
83
+ ```
84
+
85
+ ### মূল নীতিমালা
86
+
87
+ 1. **পর্যায় নির্ভরতা**: প্রতিটি পর্যায়ের আউটপুট পরবর্তী পর্যায়ের ইনপুট
88
+ 2. **চেকপয়েন্ট নিশ্চিতকরণ**: প্রতিটি পর্যায়ে একটি নিশ্চিতকরণ বিন্দু আছে যা চালিয়ে যাওয়ার আগে ব্যবহারকারীর অনুমোদন প্রয়োজন
89
+ 3. **জ্ঞান ভিত্তি চালিত**: জ্ঞান ভিত্তি সমগ্র প্রক্রিয়া জুড়ে প্রবাহিত হয়, সমস্ত পর্যায়ের জন্য প্রসঙ্গ প্রদান করে
90
+
91
+ ---
92
+
93
+ ## 3. শূন্য পদক্ষেপ: প্রজেক্ট ডায়াগনস্টিক্স এবং জ্ঞান ভিত্তি শুরু করা
94
+
95
+ আনুষ্ঠানিক ইঞ্জিনিয়ারিং প্রক্রিয়া শুরু করার আগে, আপনাকে প্রজেক্টের জ্ঞান ভিত্তি শুরু করতে হবে।
96
+
97
+ ### 3.1 প্রজেক্ট ডায়াগনস্টিক্স
98
+
99
+ **কথোপকথন উদাহরণ**:
100
+ ```
101
+ @speccrew-team-leader প্রজেক্ট ডায়াগনস্টিক্স
102
+ ```
103
+
104
+ **এজেন্ট কী করবে**:
105
+ - প্রজেক্ট কাঠামো স্ক্যান করুন
106
+ - প্রযুক্তি স্ট্যাক সনাক্ত করুন
107
+ - ব্যবসায়িক মডিউল চিহ্নিত করুন
108
+
109
+ **ডেলিভারেবল**:
110
+ ```
111
+ speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
112
+ ```
113
+
114
+ ### 3.2 প্রযুক্তিগত জ্ঞান ভিত্তি শুরু করা
115
+
116
+ **কথোপকথন উদাহরণ**:
117
+ ```
118
+ @speccrew-team-leader প্রযুক্তিগত জ্ঞান ভিত্তি শুরু করুন
119
+ ```
120
+
121
+ **তিন-পর্যায় প্রক্রিয়া**:
122
+ 1. প্ল্যাটফর্ম সনাক্তকরণ — প্রজেক্টে প্রযুক্তি প্ল্যাটফর্ম চিহ্নিত করুন
123
+ 2. প্রযুক্তিগত ডকুমেন্টেশন তৈরি — প্রতিটি প্ল্যাটফর্মের জন্য প্রযুক্তিগত স্পেসিফিকেশন নথি তৈরি করুন
124
+ 3. সূচক তৈরি — জ্ঞান ভিত্তি সূচক প্রতিষ্ঠা করুন
125
+
126
+ **ডেলিভারেবল**:
127
+ ```
128
+ speccrew-workspace/knowledges/techs/{platform-id}/
129
+ ├── tech-stack.md # প্রযুক্তি স্ট্যাক সংজ্ঞা
130
+ ├── architecture.md # আর্কিটেকচার সম্মেলন
131
+ ├── dev-spec.md # উন্নয়ন স্পেসিফিকেশন
132
+ ├── test-spec.md # পরীক্ষার স্পেসিফিকেশন
133
+ └── INDEX.md # সূচক ফাইল
134
+ ```
135
+
136
+ ### 3.3 ব্যবসায়িক জ্ঞান ভিত্তি শুরু করা
137
+
138
+ **কথোপকথন উদাহরণ**:
139
+ ```
140
+ @speccrew-team-leader ব্যবসায়িক জ্ঞান ভিত্তি শুরু করুন
141
+ ```
142
+
143
+ **চার-পর্যায় প্রক্রিয়া**:
144
+ 1. ফিচার ইনভেন্টরি — সমস্ত ফিচার চিহ্নিত করতে কোড স্ক্যান করুন
145
+ 2. ফিচার বিশ্লেষণ — প্রতিটি ফিচারের ব্যবসায়িক যুক্তি বিশ্লেষণ করুন
146
+ 3. মডিউল সারসংক্ষেপ — মডিউল অনুযায়ী ফিচার সারসংক্ষেপ করুন
147
+ 4. সিস্টেম সারসংক্ষেপ — সিস্টেম স্তরে ব্যবসায়িক ওভারভিউ তৈরি করুন
148
+
149
+ **ডেলিভারেবল**:
150
+ ```
151
+ speccrew-workspace/knowledges/bizs/
152
+ ├── {platform-type}/
153
+ │ └── {module-name}/
154
+ │ └── feature-spec.md
155
+ └── system-overview.md
156
+ ```
157
+
158
+ ---
159
+
160
+ ## 4. পর্যায়-ক্রমিক কথোপকথন নির্দেশিকা
161
+
162
+ ### 4.1 পর্যায় 1: প্রয়োজনীয়তা বিশ্লেষণ (Product Manager)
163
+
164
+ **কীভাবে শুরু করবেন**:
165
+ ```
166
+ @speccrew-product-manager আমার একটি নতুন প্রয়োজনীয়তা আছে: [আপনার প্রয়োজনীয়তা বর্ণনা করুন]
167
+ ```
168
+
169
+ **এজেন্ট ওয়ার্কফ্লো**:
170
+ 1. বিদ্যমান মডিউল বোঝার জন্য সিস্টেম ওভারভিউ পড়ুন
171
+ 2. ব্যবহারকারীর প্রয়োজনীয়তা বিশ্লেষণ করুন
172
+ 3. কাঠামোগত PRD নথি তৈরি করুন
173
+
174
+ **ডেলিভারেবল**:
175
+ ```
176
+ iterations/{নম্বর}-{টাইপ}-{নাম}/01.product-requirement/
177
+ ├── [feature-name]-prd.md # প্রোডাক্ট রিকোয়ারমেন্ট ডকুমেন্ট
178
+ └── [feature-name]-bizs-modeling.md # ব্যবসায়িক মডেলিং (জটিল প্রয়োজনীয়তার জন্য)
179
+ ```
180
+
181
+ **নিশ্চিতকরণ চেকলিস্ট**:
182
+ - [ ] প্রয়োজনীয়তার বিবরণ ব্যবহারকারীর উদ্দেশ্য সঠিকভাবে প্রতিফলিত করে?
183
+ - [ ] ব্যবসায়িক নিয়ম সম্পূর্ণ?
184
+ - [ ] বিদ্যমান সিস্টেমের সাথে ইন্টিগ্রেশন পয়েন্ট স্পষ্ট?
185
+ - [ ] গ্রহণযোগ্যতার মান পরিমাপযোগ্য?
186
+
187
+ ---
188
+
189
+ ### 4.2 পর্যায় 2: ফিচার ডিজাইন (Feature Designer)
190
+
191
+ **কীভাবে শুরু করবেন**:
192
+ ```
193
+ @speccrew-feature-designer ফিচার ডিজাইন শুরু করুন
194
+ ```
195
+
196
+ **এজেন্ট ওয়ার্কফ্লো**:
197
+ 1. স্বয়ংক্রিয়ভাবে নিশ্চিত করা PRD নথি খুঁজুন
198
+ 2. ব্যবসায়িক জ্ঞান ভিত্তি লোড করুন
199
+ 3. ফিচার ডিজাইন তৈরি করুন (UI ওয়্যারফ্রেম, ইন্টারঅ্যাকশন ফ্লো, ডেটা সংজ্ঞা, API কন্ট্রাক্ট সহ)
200
+ 4. একাধিক PRD এর জন্য সমান্তরাল ডিজাইনের জন্য Task Worker ব্যবহার করুন
201
+
202
+ **ডেলিভারেবল**:
203
+ ```
204
+ iterations/{iter}/02.feature-design/
205
+ └── [feature-name]-feature-spec.md # ফিচার ডিজাইন ডকুমেন্ট
206
+ ```
207
+
208
+ **নিশ্চিতকরণ চেকলিস্ট**:
209
+ - [ ] সমস্ত ব্যবহারকারী পরিস্থিতি কভার করা হয়েছে?
210
+ - [ ] ইন্টারঅ্যাকশন ফ্লো স্পষ্ট?
211
+ - [ ] ডেটা ফিল্ড সংজ্ঞা সম্পূর্ণ?
212
+ - [ ] ব্যতিক্রম পরিচালনা ব্যাপক?
213
+
214
+ ---
215
+
216
+ ### 4.3 পর্যায় 3: সিস্টেম ডিজাইন (System Designer)
217
+
218
+ **কীভাবে শুরু করবেন**:
219
+ ```
220
+ @speccrew-system-designer সিস্টেম ডিজাইন শুরু করুন
221
+ ```
222
+
223
+ **এজেন্ট ওয়ার্কফ্লো**:
224
+ 1. Feature Spec এবং API Contract খুঁজুন
225
+ 2. প্রযুক্তিগত জ্ঞান ভিত্তি লোড করুন (প্রযুক্তি স্ট্যাক, আর্কিটেকচার, প্রতিটি প্ল্যাটফর্মের স্পেসিফিকেশন)
226
+ 3. **চেকপয়েন্ট A**: ফ্রেমওয়ার্ক মূল্যায়ন — প্রযুক্তিগত ফাঁক বিশ্লেষণ, নতুন ফ্রেমওয়ার্ক সুপারিশ (প্রয়োজনে), ব্যবহারকারীর নিশ্চিতকরণের জন্য অপেক্ষা করুন
227
+ 4. DESIGN-OVERVIEW.md তৈরি করুন
228
+ 5. প্রতিটি প্ল্যাটফর্মের জন্য সমান্তরাল ডিজাইন ডিসপ্যাচের জন্য Task Worker ব্যবহার করুন (frontend/backend/mobile/desktop)
229
+ 6. **চেকপয়েন্ট B**: যৌথ নিশ্চিতকরণ — সমস্ত প্ল্যাটফর্ম ডিজাইনের সারসংক্ষেপ দেখান, ব্যবহারকারীর নিশ্চিতকরণের জন্য অপেক্ষা করুন
230
+
231
+ **ডেলিভারেবল**:
232
+ ```
233
+ iterations/{iter}/03.system-design/
234
+ ├── DESIGN-OVERVIEW.md # ডিজাইন ওভারভিউ
235
+ ├── {platform-id}/
236
+ │ ├── INDEX.md # প্ল্যাটফর্ম ডিজাইন সূচক
237
+ │ └── {module}-design.md # সিউডোকোড স্তরে মডিউল ডিজাইন
238
+ ```
239
+
240
+ **নিশ্চিতকরণ চেকলিস্ট**:
241
+ - [ ] সিউডোকোড বাস্তব ফ্রেমওয়ার্ক সিনট্যাক্স ব্যবহার করে?
242
+ - [ ] ক্রস-প্ল্যাটফর্ম API কন্ট্রাক্ট সামঞ্জস্যপূর্ণ?
243
+ - [ ] ত্রুটি পরিচালনা কৌশল ঐক্যবদ্ধ?
244
+
245
+ ---
246
+
247
+ ### 4.4 পর্যায় 4: উন্নয়ন বাস্তবায়ন (System Developer)
248
+
249
+ **কীভাবে শুরু করবেন**:
250
+ ```
251
+ @speccrew-system-developer উন্নয়ন শুরু করুন
252
+ ```
253
+
254
+ **এজেন্ট ওয়ার্কফ্লো**:
255
+ 1. সিস্টেম ডিজাইন নথি পড়ুন
256
+ 2. প্রতিটি প্ল্যাটফর্মের জন্য প্রযুক্তিগত জ্ঞান লোড করুন
257
+ 3. **চেকপয়েন্ট A**: পরিবেশ প্রি-ভেরিফিকেশন — রানটাইম সংস্করণ, নির্ভরতা, পরিষেবা প্রাপ্যতা যাচাই করুন; ব্যর্থ হলে ব্যবহারকারীর সমাধানের জন্য অপেক্ষা করুন
258
+ 4. প্রতিটি প্ল্যাটফর্মের জন্য সমান্তরাল উন্নয়ন ডিসপ্যাচের জন্য Task Worker ব্যবহার করুন
259
+ 5. ইন্টিগ্রেশন যাচাইকরণ: API কন্ট্রাক্ট প্রান্তিককরণ, ডেটা সামঞ্জস্য
260
+ 6. ডেলিভারি রিপোর্ট আউটপুট করুন
261
+
262
+ **ডেলিভারেবল**:
263
+ ```
264
+ # সোর্স কোড প্রকৃত প্রজেক্ট সোর্স কোড ডিরেক্টরিতে লেখা হয়
265
+ iterations/{iter}/04.development/
266
+ ├── {platform-id}/
267
+ │ └── tasks/ # উন্নয়ন টাস্ক রেকর্ড
268
+ └── delivery-report.md
269
+ ```
270
+
271
+ **নিশ্চিতকরণ চেকলিস্ট**:
272
+ - [ ] পরিবেশ প্রস্তুত?
273
+ - [ ] ইন্টিগ্রেশন সমস্যা গ্রহণযোগ্য পরিসরে?
274
+ - [ ] কোড উন্নয়ন স্পেসিফিকেশন মেনে চলে?
275
+
276
+ ---
277
+
278
+ ### 4.5 পর্যায় 5: সিস্টেম পরীক্ষা (Test Manager)
279
+
280
+ **কীভাবে শুরু করবেন**:
281
+ ```
282
+ @speccrew-test-manager পরীক্ষা শুরু করুন
283
+ ```
284
+
285
+ **তিন-পর্যায় পরীক্ষা প্রক্রিয়া**:
286
+
287
+ | পর্যায় | বিবরণ | চেকপয়েন্ট |
288
+ |------|----------|-------------------|
289
+ | পরীক্ষার কেস ডিজাইন | PRD এবং Feature Spec এর উপর ভিত্তি করে পরীক্ষার কেস তৈরি করুন | A: কেস কভারেজ পরিসংখ্যান এবং ট্রেসেবিলিটি ম্যাট্রিক্স দেখান, পর্যাপ্ত কভারেজের জন্য ব্যবহারকারীর নিশ্চিতকরণের জন্য অপেক্ষা করুন |
290
+ | পরীক্ষার কোড তৈরি | এক্সিকিউটেবল পরীক্ষার কোড তৈরি করুন | B: তৈরি করা পরীক্ষার ফাইল এবং কেস ম্যাপিং দেখান, ব্যবহারকারীর নিশ্চিতকরণের জন্য অপেক্ষা করুন |
291
+ | পরীক্ষা সম্পাদন এবং বাগ রিপোর্ট | স্বয়ংক্রিয়ভাবে পরীক্ষা সম্পাদন এবং রিপোর্ট তৈরি করুন | নেই (স্বয়ংক্রিয় সম্পাদন) |
292
+
293
+ **ডেলিভারেবল**:
294
+ ```
295
+ iterations/{iter}/05.system-test/
296
+ ├── cases/
297
+ │ └── {platform-id}/ # পরীক্ষার কেস নথি
298
+ ├── code/
299
+ │ └── {platform-id}/ # পরীক্ষার কোড পরিকল্পনা
300
+ ├── reports/
301
+ │ └── test-report-{date}.md # পরীক্ষার রিপোর্ট
302
+ └── bugs/
303
+ └── BUG-{id}-{title}.md # বাগ রিপোর্ট (প্রতিটি বাগের জন্য একটি ফাইল)
304
+ ```
305
+
306
+ **নিশ্চিতকরণ চেকলিস্ট**:
307
+ - [ ] কেস কভারেজ সম্পূর্ণ?
308
+ - [ ] পরীক্ষার কোড এক্সিকিউটেবল?
309
+ - [ ] বাগ গুরুত্ব মূল্যায়ন সঠিক?
310
+
311
+ ---
312
+
313
+ ### 4.6 পর্যায় 6: আর্কাইভিং
314
+
315
+ ইটারেশন সম্পন্ন হলে স্বয়ংক্রিয়ভাবে আর্কাইভ করা হয়:
316
+
317
+ ```
318
+ speccrew-workspace/iteration-archives/
319
+ └── {নম্বর}-{টাইপ}-{নাম}-{তারিখ}/
320
+ ├── 01.product-requirement/
321
+ ├── 02.feature-design/
322
+ ├── 03.system-design/
323
+ ├── 04.development/
324
+ └── 05.system-test/
325
+ ```
326
+
327
+ ---
328
+
329
+ ## 5. জ্ঞান ভিত্তি ওভারভিউ
330
+
331
+ ### 5.1 ব্যবসায়িক জ্ঞান ভিত্তি (bizs)
332
+
333
+ **উদ্দেশ্য**: প্রজেক্টের ব্যবসায়িক ফাংশন বিবরণ, মডিউল বিভাজন, API বৈশিষ্ট্য সংরক্ষণ করুন
334
+
335
+ **ডিরেক্টরি কাঠামো**:
336
+ ```
337
+ knowledges/bizs/
338
+ ├── {platform-type}/
339
+ │ └── {module-name}/
340
+ │ └── feature-spec.md
341
+ └── system-overview.md
342
+ ```
343
+
344
+ **ব্যবহারের পরিস্থিতি**: Product Manager, Feature Designer
345
+
346
+ ### 5.2 প্রযুক্তিগত জ্ঞান ভিত্তি (techs)
347
+
348
+ **উদ্দেশ্য**: প্রজেক্টের প্রযুক্তি স্ট্যাক, আর্কিটেকচার সম্মেলন, উন্নয়ন স্পেসিফিকেশন, পরীক্ষার স্পেসিফিকেশন সংরক্ষণ করুন
349
+
350
+ **ডিরেক্টরি কাঠামো**:
351
+ ```
352
+ knowledges/techs/{platform-id}/
353
+ ├── tech-stack.md
354
+ ├── architecture.md
355
+ ├── dev-spec.md
356
+ ├── test-spec.md
357
+ └── INDEX.md
358
+ ```
359
+
360
+ **ব্যবহারের পরিস্থিতি**: System Designer, System Developer, Test Manager
361
+
362
+ ---
363
+
364
+ ## 6. প্রায়শই জিজ্ঞাসিত প্রশ্ন (FAQ)
365
+
366
+ ### প্র১: এজেন্ট প্রত্যাশিতভাবে কাজ না করলে কী করবেন?
367
+
368
+ 1. ইনস্টলেশনের অখণ্ডতা পরীক্ষা করতে `speccrew doctor` চালান
369
+ 2. জ্ঞান ভিত্তি শুরু করা হয়েছে তা নিশ্চিত করুন
370
+ 3. পূর্ববর্তী পর্যায়ের ডেলিভারেবল বর্তমান ইটারেশন ডিরেক্টরিতে存在 তা নিশ্চিত করুন
371
+
372
+ ### প্র২: একটি পর্যায় কীভাবে এড়িয়ে যাবেন?
373
+
374
+ **সুপারিশ করা হয় না** — প্রতিটি পর্যায়ের আউটপুট পরবর্তী পর্যায়ের ইনপুট।
375
+
376
+ এড়াতে হলে, সংশ্লিষ্ট পর্যায়ের ইনপুট নথি ম্যানুয়ালি প্রস্তুত করুন এবং এটি ফরম্যাট স্পেসিফিকেশন মেনে চলে তা নিশ্চিত করুন।
377
+
378
+ ### প্র৩: একাধিক সমান্তরাল প্রয়োজনীয়তা কীভাবে পরিচালনা করবেন?
379
+
380
+ প্রতিটি প্রয়োজনীয়তার জন্য স্বতন্ত্র ইটারেশন ডিরেক্টরি তৈরি করুন:
381
+ ```
382
+ iterations/
383
+ ├── 001-feature-xxx/
384
+ ├── 002-feature-yyy/
385
+ └── 003-feature-zzz/
386
+ ```
387
+
388
+ প্রতিটি ইটারেশন সম্পূর্ণ বিচ্ছিন্ন এবং অন্যদের প্রভাবিত করে না।
389
+
390
+ ### প্র৪: SpecCrew সংস্করণ কীভাবে আপডেট করবেন?
391
+
392
+ - **গ্লোবাল আপডেট**: `npm update -g speccrew`
393
+ - **প্রজেক্ট আপডেট**: প্রজেক্ট ডিরেক্টরিতে `speccrew update` চালান
394
+
395
+ ### প্র৫: ঐতিহাসিক ইটারেশন কীভাবে দেখবেন?
396
+
397
+ আর্কাইভ করার পরে, `speccrew-workspace/iteration-archives/` এ দেখুন, `{নম্বর}-{টাইপ}-{নাম}-{তারিখ}/` ফরম্যাটে সংগঠিত।
398
+
399
+ ### প্র৬: জ্ঞান ভিত্তির নিয়মিত আপডেট প্রয়োজন?
400
+
401
+ নিম্নলিখিত পরিস্থিতিতে পুনরায় শুরু করা প্রয়োজন:
402
+ - প্রজেক্ট কাঠামোতে উল্লেখযোগ্য পরিবর্তন
403
+ - প্রযুক্তি স্ট্যাক আপডেট বা প্রতিস্থাপন
404
+ - ব্যবসায়িক মডিউল যোগ/অপসারণ
405
+
406
+ ---
407
+
408
+ ## 7. দ্রুত রেফারেন্স
409
+
410
+ ### এজেন্ট শুরু করার দ্রুত রেফারেন্স
411
+
412
+ | পর্যায় | এজেন্ট | শুরুর কথোপকথন |
413
+ |------|-------|-------------------|
414
+ | ডায়াগনস্টিক্স | Team Leader | `@speccrew-team-leader প্রজেক্ট ডায়াগনস্টিক্স` |
415
+ | শুরু করা | Team Leader | `@speccrew-team-leader প্রযুক্তিগত জ্ঞান ভিত্তি শুরু করুন` |
416
+ | প্রয়োজনীয়তা বিশ্লেষণ | Product Manager | `@speccrew-product-manager আমার একটি নতুন প্রয়োজনীয়তা আছে: [বিবরণ]` |
417
+ | ফিচার ডিজাইন | Feature Designer | `@speccrew-feature-designer ফিচার ডিজাইন শুরু করুন` |
418
+ | সিস্টেম ডিজাইন | System Designer | `@speccrew-system-designer সিস্টেম ডিজাইন শুরু করুন` |
419
+ | উন্নয়ন | System Developer | `@speccrew-system-developer উন্নয়ন শুরু করুন` |
420
+ | সিস্টেম পরীক্ষা | Test Manager | `@speccrew-test-manager পরীক্ষা শুরু করুন` |
421
+
422
+ ### চেকপয়েন্ট চেকলিস্ট
423
+
424
+ | পর্যায় | চেকপয়েন্ট সংখ্যা | মূল যাচাইকরণ উপাদান |
425
+ |------|------------------------|------------------------|
426
+ | প্রয়োজনীয়তা বিশ্লেষণ | 1 | প্রয়োজনীয়তা নির্ভুলতা, ব্যবসায়িক নিয়ম সম্পূর্ণতা, গ্রহণযোগ্যতার মান পরিমাপযোগ্যতা |
427
+ | ফিচার ডিজাইন | 1 | পরিস্থিতি কভারেজ, ইন্টারঅ্যাকশন স্বচ্ছতা, ডেটা সম্পূর্ণতা, ব্যতিক্রম পরিচালনা |
428
+ | সিস্টেম ডিজাইন | 2 | A: ফ্রেমওয়ার্ক মূল্যায়ন; B: সিউডোকোড সিনট্যাক্স, ক্রস-প্ল্যাটফর্ম সামঞ্জস্য, ত্রুটি পরিচালনা |
429
+ | উন্নয়ন | 1 | A: পরিবেশ প্রস্তুতি, ইন্টিগ্রেশন সমস্যা, কোড স্পেসিফিকেশন |
430
+ | সিস্টেম পরীক্ষা | 2 | A: কেস কভারেজ; B: পরীক্ষার কোড এক্সিকিউটেবিলিটি |
431
+
432
+ ### ডেলিভারেবল পথ দ্রুত রেফারেন্স
433
+
434
+ | পর্যায় | আউটপুট ডিরেক্টরি | ফাইল ফরম্যাট |
435
+ |------|------------------|-------------|
436
+ | প্রয়োজনীয়তা বিশ্লেষণ | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
437
+ | ফিচার ডিজাইন | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
438
+ | সিস্টেম ডিজাইন | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
439
+ | উন্নয়ন | `iterations/{iter}/04.development/` | সোর্স কোড + `delivery-report.md` |
440
+ | সিস্টেম পরীক্ষা | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
441
+ | আর্কাইভিং | `iteration-archives/{iter}-{তারিখ}/` | ইটারেশনের সম্পূর্ণ কপি |
442
+
443
+ ---
444
+
445
+ ## পরবর্তী পদক্ষেপ
446
+
447
+ 1. আপনার প্রজেক্ট শুরু করতে `speccrew init --ide qoder` চালান
448
+ 2. শূন্য পদক্ষেপ সম্পাদন করুন: প্রজেক্ট ডায়াগনস্টিক্স এবং জ্ঞান ভিত্তি শুরু করা
449
+ 3. ওয়ার্কফ্লো অনুসরণ করে প্রতিটি পর্যায়ের মধ্যে এগিয়ে যান, স্পেসিফিকেশন-চালিত উন্নয়ন অভিজ্ঞতা উপভোগ করুন!