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
|
-
**
|
|
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
|
-
**
|
|
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-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
-
|
|
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
|
-
**
|
|
149
|
+
**Loop Termination Conditions:**
|
|
150
|
+
- ALL 4 sufficiency checks pass, OR
|
|
151
|
+
- User explicitly states no more questions needed
|
|
140
152
|
|
|
141
|
-
|
|
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
|
|
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
|
|
181
|
-
[Same format]
|
|
198
|
+
### Round 2
|
|
199
|
+
[Same format, if conducted]
|
|
182
200
|
|
|
183
|
-
|
|
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
|