Skip to content

đź’« Toolkit to help you get started with SDD or any other process!

Update clarify.md

den (work)df4d7fa06295
diff --git a/templates/commands/clarify.md b/templates/commands/clarify.md
index 6fe439cb9..4eb8e7cd8 100644
--- a/templates/commands/clarify.md
+++ b/templates/commands/clarify.md
@@ -97,7 +97,15 @@ Execution steps:
4. Sequential questioning loop (interactive):
- Present EXACTLY ONE question at a time.
- - For multiple‑choice questions render options as a Markdown table:
+ - For multiple‑choice questions:
+ * **Analyze all options** and determine the **most suitable option** based on:
+ - Best practices for the project type
+ - Common patterns in similar implementations
+ - Risk reduction (security, performance, maintainability)
+ - Alignment with any explicit project goals or constraints visible in the spec
+ * Present your **recommended option prominently** at the top with clear reasoning (1-2 sentences explaining why this is the best choice).
+ * Format as: `**Recommended:** Option [X] - <reasoning>`
+ * Then render all options as a Markdown table:
| Option | Description |
|--------|-------------|
@@ -106,9 +114,14 @@ Execution steps:
| C | <Option C description> | (add D/E as needed up to 5)
| Short | Provide a different short answer (<=5 words) | (Include only if free-form alternative is appropriate)
- - For short‑answer style (no meaningful discrete options), output a single line after the question: `Format: Short answer (<=5 words)`.
+ * After the table, add: `You can reply with the option letter (e.g., "A"), accept the recommendation by saying "yes" or "recommended", or provide your own short answer.`
+ - For short‑answer style (no meaningful discrete options):
+ * Provide your **suggested answer** based on best practices and context.
+ * Format as: `**Suggested:** <your proposed answer> - <brief reasoning>`
+ * Then output: `Format: Short answer (<=5 words). You can accept the suggestion by saying "yes" or "suggested", or provide your own answer.`
- After the user answers:
- * Validate the answer maps to one option or fits the <=5 word constraint.
+ * If the user replies with "yes", "recommended", or "suggested", use your previously stated recommendation/suggestion as the answer.
+ * Otherwise, validate the answer maps to one option or fits the <=5 word constraint.
* If ambiguous, ask for a quick disambiguation (count still belongs to same question; do not advance).
* Once satisfactory, record it in working memory (do not yet write to disk) and move to the next queued question.
- Stop asking further questions when: