Explorar o código

feat: strengthen stuck-handling discovery and improve trigger clarity

**Discovery enhancement:**
- Add Mandatory Workflow 4 to getting-started: "When Stuck"
- Creates path: getting-started → when-stuck dispatch → specific technique
- Prevents spinning wheels without seeking help

**Trigger clarity:**
- Replace phrase examples with pattern descriptions
- "Partner reveals constraint you didn't consider" (pattern) not "Oh, I forgot..." (phrase)
- Emphasizes NEW information that invalidates current context
- Prevents ambiguity between new constraints vs clarifications

Tested: All skills verified with subagents, triggers work correctly.
Jesse Vincent hai 11 meses
pai
achega
3c26a7f875

+ 2 - 2
skills/collaboration/brainstorming/SKILL.md

@@ -30,11 +30,11 @@ digraph brainstorming_modes {
 
     UNDERSTANDING -> EXPLORING [label="Have enough context to propose alternatives\n(gathered purpose, constraints, success criteria)"];
 
-    EXPLORING -> UNDERSTANDING [label="Partner reveals new constraint\n(compliance requirement, infrastructure limit, security need, forgotten requirement)"];
+    EXPLORING -> UNDERSTANDING [label="Partner reveals constraint you didn't consider\n(wasn't part of context when proposing approaches,\nchanges viability or trade-offs of proposed options)"];
 
     EXPLORING -> DESIGNING [label="Approach selected and validated\n(partner chose an approach, have all critical constraints)"];
 
-    DESIGNING -> UNDERSTANDING [label="Partner reveals fundamental gap\n(missing critical constraint, core assumption questioned)"];
+    DESIGNING -> UNDERSTANDING [label="Partner reveals gap in requirements\n(constraint you didn't know about,\nassumption that doesn't hold)"];
 
     DESIGNING -> EXPLORING [label="Need to reconsider approach\n(trade-offs too significant, partner questions approach)"];
 }

+ 28 - 0
skills/getting-started/SKILL.md

@@ -89,6 +89,34 @@ You: Searching past conversations...
 
 **Pattern:** Search → Subagent synthesizes → Apply. Fast, focused, context-efficient.
 
+## Mandatory Workflow 4: When Stuck
+
+**When:** Not making progress, conventional approaches failing, same problem recurring, complexity spiraling, can't decide between options
+
+**DON'T:**
+- Keep trying same approach
+- Force through without help
+- Assume you'll figure it out
+- Skip searching because "I should know this"
+
+**DO:**
+1. **Search for problem-solving skills:**
+   ```bash
+   ${CLAUDE_PLUGIN_ROOT}/skills/getting-started/skills-search stuck simplification pattern
+   ```
+
+2. **Start with dispatch skill:**
+   - Read skills/problem-solving/when-stuck
+   - Use flowchart to identify stuck-type
+   - Load recommended technique skill
+
+3. **Apply the technique:**
+   - Follow the process
+   - Document what you tried
+   - If still stuck, try different technique
+
+**Pattern:** Recognize stuck → Search skills → Load technique → Apply. Don't spin your wheels.
+
 ## Announcing Skill Usage
 
 **Every time you start using a skill, announce it:**