speccrew 0.6.20 → 0.6.21

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.
@@ -83,7 +83,11 @@ Applies ISA-95 Stage 1 (Domain Description) for clarification:
83
83
 
84
84
  > ⚠️ **All rounds use file-based interaction, NOT chat-based.**
85
85
 
86
- **Round 1: Core Understanding**
86
+ **Clarification Loop Condition-Driven, No Round Limit**
87
+
88
+ The clarification process continues until ALL sufficiency checks pass. There is NO fixed round limit.
89
+
90
+ **Initial Round: Core Understanding**
87
91
 
88
92
  Create `.clarification-questions-round-1.md`:
89
93
  ```markdown
@@ -129,16 +133,25 @@ Please fill answers after each "**Answer:**" marker, save, and notify me.
129
133
 
130
134
  **HARD STOP** — Wait for user confirmation, then read file.
131
135
 
132
- **Round 2: Scope & Boundaries (if needed)**
136
+ **Subsequent Rounds Continue Until Sufficiency Checks Pass**
137
+
138
+ After each round:
139
+ 1. Read the answered file
140
+ 2. Perform sufficiency check (see Step 5)
141
+ 3. If ALL 4 checks pass → Proceed to Step 6
142
+ 4. If ANY check fails → Generate next round with targeted follow-up questions
133
143
 
134
- Create `.clarification-questions-round-2.md` with:
135
- - Out-of-Scope Items confirmation
136
- - Integration Boundaries (external systems)
137
- - Business Rules & Constraints
144
+ Create `.clarification-questions-round-N.md` (N = current round number) with:
145
+ - Follow-up questions based on gaps identified in sufficiency check
146
+ - Focus on unanswered items, ambiguities, or new questions raised by user's answers
147
+ - Maintain same file format with "**Answer:**" markers
138
148
 
139
- **Round 3: Detail & Acceptance (if still needed)**
149
+ **Loop Termination Conditions:**
150
+ - ALL 4 sufficiency checks pass, OR
151
+ - User explicitly states no more questions needed
140
152
 
141
- Same pattern with focused follow-up questions.
153
+ > ⚠️ **Do NOT terminate early.** Continue clarification rounds until sufficiency is achieved.
154
+ > The round counter (N) has NO upper limit.
142
155
 
143
156
  ## Step 5: Sufficiency Check
144
157
 
@@ -151,7 +164,10 @@ Same pattern with focused follow-up questions.
151
164
  | 3 | Priority/phasing decisions are made | Phase 1 scope is clear |
152
165
  | 4 | Integration boundaries are identified | Integration points listed or "none" confirmed |
153
166
 
154
- **Logic:** If all 4 pass → Step 6. Else if round < 3 next round. Else → proceed with gaps noted.
167
+ **Logic:** If all 4 pass → Step 6. Else continue to next clarification round.
168
+
169
+ > ⚠️ **No round limit.** Continue generating clarification rounds until ALL checks pass.
170
+ > Each round should focus on the specific gaps identified in the sufficiency check.
155
171
 
156
172
  ## Step 6: Generate .clarification-summary.md
157
173
 
@@ -172,16 +188,17 @@ Same pattern with focused follow-up questions.
172
188
 
173
189
  ## Clarification Q&A
174
190
 
191
+ <!-- List all rounds that were conducted. Round count is dynamic. -->
192
+
175
193
  ### Round 1
176
194
  | # | Question | Answer | Impact |
177
195
  |---|----------|--------|--------|
178
196
  | 1 | [Q] | [A] | [Impact] |
179
197
 
180
- ### Round 2 (if applicable)
181
- [Same format]
198
+ ### Round 2
199
+ [Same format, if conducted]
182
200
 
183
- ### Round 3 (if applicable)
184
- [Same format]
201
+ <!-- Add more rounds as needed until sufficiency checks pass -->
185
202
 
186
203
  ## Sufficiency Checks
187
204
  - [x] Scope boundaries are clear
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "speccrew",
3
- "version": "0.6.20",
3
+ "version": "0.6.21",
4
4
  "description": "Spec-Driven Development toolkit for AI-powered IDEs",
5
5
  "author": "charlesmu99",
6
6
  "repository": {