diff --git a/skills/specforge-explore/SKILL.md b/skills/specforge-explore/SKILL.md index 0b4a409..4d0fefe 100644 --- a/skills/specforge-explore/SKILL.md +++ b/skills/specforge-explore/SKILL.md @@ -22,7 +22,8 @@ optimization, pushing one solution without comparing alternatives. (no hybrids); for each: core idea, required changes, risks, pros/cons. 3. **Stage 3 — Compare.** Trade-offs against maintainability, blast radius, regression risk, long-term cost. Recommend, but let the user choose. End - with the choice checkpoint and wait. + with the choice checkpoint and wait — use an interactive single-select tool + (e.g. `AskUserQuestion`) if your harness has one, otherwise the text marker. 4. **Stage 4 — Prepare for spec.** After the user picks an option, write the two output files and emit the RESULT block. diff --git a/skills/specforge-explore/references/process.md b/skills/specforge-explore/references/process.md index 68be25c..ad23556 100644 --- a/skills/specforge-explore/references/process.md +++ b/skills/specforge-explore/references/process.md @@ -42,13 +42,20 @@ and wait for the user's response. === WAITING FOR ANSWERS (STAGE 1) === ``` -- After Stages 2–3, end your message with: +- After Stages 2–3, present the choice. If your harness provides an interactive + single-select tool (e.g. `AskUserQuestion`), use it: one option per approach, + with a short label and the trade-off summary in each option's description. The + tool's automatic "Other" choice covers "suggest revisions to options/criteria". + Otherwise, fall back to ending your message with the text marker: ``` === YOUR CHOICE (STAGES 2–3) === Select an option: 1 / 2 / 3 / 4 (or suggest revisions to options/criteria) ``` +Either way, the full Stage 2–3 prose (idea, changes, risks, trade-offs) stays in +the message — the tool only carries the final selection. + If information is insufficient, return to Stage 1 and ask more questions instead of proceeding. @@ -72,8 +79,8 @@ Prohibited: proposing hybrids; leaving options without evaluation. Compare options against maintainability, blast radius, regression risk, and long-term cost of changes. State explicitly what we gain and what we pay. You may give a recommendation, but do not make the final choice — frame it as a user -action ("select option N" or "clarify criteria"). End with the choice -checkpoint. +action ("select option N" or "clarify criteria"). End with the choice checkpoint +(interactive single-select tool if available, otherwise the text marker). ## Stage 4. Preparation for specification