@tgoodington/intuition 10.7.0 → 10.8.0

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tgoodington/intuition",
3
- "version": "10.7.0",
3
+ "version": "10.8.0",
4
4
  "description": "Domain-adaptive workflow system for Claude Code: prompt, outline, assemble specialist teams, detail with domain experts, build with format producers, test code output. Supports v8 compat (design, engineer, build) and v9 specialist workflows with 14 domain specialists and 6 format producers.",
5
5
  "keywords": [
6
6
  "claude-code",
@@ -132,12 +132,27 @@ Every question in REFINE follows these principles:
132
132
 
133
133
  **Derive from their words.** Your options come from what the user said, not from external research or generic categories.
134
134
 
135
- **ANTI-PATTERN: Always presenting 3 options.** This is the most common failure mode. You must count the actual distinct possibilities the user's words imply sometimes that's 2, sometimes 5, sometimes 6. Three is not a safe default; it's a lazy one. Before presenting options, explicitly list the distinct possibilities you've identified and use ALL of them.
135
+ **MANDATORY OPTION ENUMERATIONexecute this before EVERY AskUserQuestion call:**
136
+
137
+ ```
138
+ STEP 1: In your thinking, brainstorm EVERY distinct possibility the user's
139
+ words and context imply. Write them all out. Do not stop at 3.
140
+ STEP 2: Count them. If you have exactly 3, you are almost certainly anchored.
141
+ Go back to Step 1 and ask: "What am I collapsing together that is
142
+ actually two distinct things? What possibility am I forgetting?"
143
+ STEP 3: Only proceed when your count genuinely reflects the decision space.
144
+ 2 is fine. 4 is fine. 7 is fine. 3 is fine ONLY if you passed Step 2
145
+ and confirmed the space truly has exactly 3 distinct options.
146
+ STEP 4: Use ALL the possibilities from your enumeration as AskUserQuestion
147
+ options. Do not trim to fit a round number.
148
+ ```
149
+
150
+ If you skip this procedure or present 3 options without passing Step 2, the protocol has failed.
136
151
 
137
152
  Examples at different scales:
138
153
 
139
154
  - 2 options: "You said 'handle transfers' — does that mean (a) bulk migration when someone leaves, or (b) real-time co-ownership?"
140
- - 3 options: "You mentioned 'fast' — is that (a) sub-second response times, (b) same-day turnaround, or (c) perceived speed through progressive loading?"
155
+ - 3 options (verified): "You mentioned 'fast' — is that (a) sub-second response times, (b) same-day turnaround, or (c) perceived speed through progressive loading?"
141
156
  - 4 options: "The notification system could be (a) email-only, (b) in-app real-time, (c) digest-based batching, or (d) user-configured per event type."
142
157
  - 5 options: "For auth you've got (a) email/password, (b) SSO via existing provider, (c) magic links, (d) OAuth social login, or (e) passkeys."
143
158
  - 6+ options: "The dashboard layout could be (a) single KPI grid, (b) tabbed by department, (c) role-based views, (d) customizable drag-and-drop, (e) narrative/report style, or (f) a combined feed with filters."
@@ -366,6 +381,7 @@ These are banned. If you catch yourself doing any of these, stop and correct cou
366
381
  - Asking questions you could have asked in turn one (generic background)
367
382
  - Staying on the same sub-topic for more than 2 follow-ups when the user is uncertain — flag it as an open question and move on
368
383
  - Producing a brief with sections the outline phase doesn't consume
384
+ - **Presenting exactly 3 options without running the Mandatory Option Enumeration procedure** — this is the single most persistent failure mode. If you have 3 options, you MUST have verified via Step 2 that you aren't collapsing or omitting possibilities
369
385
 
370
386
  ## RESUME LOGIC
371
387