feat: update usage recommendations across multiple workflow commands to require user confirmation and improve clarity

.claude/commands/ccw-debug.md

@@ -837,15 +837,28 @@ Selected items call: `/issue:new "{issue summary} - {dimension}"`
 
 ---
 
-## Usage Recommendations
+## Usage Recommendations (Requires User Confirmation)
 
-1. **First Time**: Use default mode (debug-first), observe workflow
-2. **Quick Decision**: Use CLI Quick (--mode cli) for immediate recommendations
-3. **Quick Fix**: Use `--hotfix --yes` for minimal diagnostics (debug mode)
-4. **Learning**: Use debug-first, read `understanding.md`
-5. **Complete Validation**: Use bidirectional for multi-dimensional insights
-6. **Auto Repair**: Use test-first for automatic iteration
-7. **Escalation**: Start with CLI Quick, escalate to other modes as needed
+**Use `Skill(skill="ccw-debug", args="\"bug description\"")` when:**
+- First time: Use default mode (debug-first), observe workflow
+
+**Use `Skill(skill="ccw-debug", args="--mode cli \"issue\"")` when:**
+- Quick Decision: Immediate recommendations without full workflow
+
+**Use `Skill(skill="ccw-debug", args="--hotfix --yes \"issue\"")` when:**
+- Quick Fix: Minimal diagnostics for production issues
+
+**Use `Skill(skill="ccw-debug", args="--mode debug \"issue\"")` when:**
+- Learning: Read `understanding.md` for debugging insights
+
+**Use `Skill(skill="ccw-debug", args="--mode bidirectional \"issue\"")` when:**
+- Complete Validation: Multi-dimensional insights from parallel workflows
+
+**Use `Skill(skill="ccw-debug", args="--mode test \"issue\"")` when:**
+- Auto Repair: Automatic iteration with test-first approach
+
+**Use `Skill(skill="ccw-debug", args="--mode cli \"issue\"")` when:**
+- Escalation: Start with CLI Quick, then escalate to other modes as needed
 
 ---
 

.claude/commands/workflow/analyze-with-file.md

@@ -515,29 +515,35 @@ User agrees with current direction, wants deeper code analysis
 - Current design allows horizontal scaling without session affinity
 ```
 
-## Usage Recommendations
+## Usage Recommendations (Requires User Confirmation)
 
-**Use `/workflow:analyze-with-file` when:**
+**Use `Skill(skill="workflow:analyze-with-file", args="\"topic\"")` when:**
 - Exploring a complex topic collaboratively
 - Need documented discussion trail
 - Decision-making requires multiple perspectives
 - Want to iterate on understanding with user input
 - Building shared understanding before implementation
 
-**Use `/workflow:debug-with-file` when:**
+**Use `Skill(skill="workflow:debug-with-file", args="\"bug description\"")` when:**
 - Diagnosing specific bugs
 - Need hypothesis-driven investigation
 - Focus on evidence and verification
 
-**Use `/workflow:brainstorm-with-file` when:**
+**Use `Skill(skill="workflow:brainstorm-with-file", args="\"topic or question\"")` when:**
 - Generating new ideas or solutions
 - Need creative exploration
 - Want divergent thinking before convergence
 
-**Use `/workflow:lite-plan` when:**
+**Use `Skill(skill="workflow:collaborative-plan-with-file", args="\"task description\"")` when:**
+- Complex planning requiring multiple perspectives
+- Large scope needing parallel sub-domain analysis
+- Want shared collaborative planning document
+- Need structured task breakdown with agent coordination
+
+**Use `Skill(skill="workflow:lite-plan", args="\"task description\"")` when:**
 - Ready to implement (past analysis phase)
-- Need structured task breakdown
-- Focus on execution planning
+- Need simple task breakdown
+- Focus on quick execution planning
 
 ---
 

.claude/commands/workflow/brainstorm-with-file.md

@@ -745,25 +745,31 @@ Dimensions matched against topic keywords to identify focus areas:
 
 See full markdown template in original file (lines 955-1161).
 
-## Usage Recommendations
+## Usage Recommendations (Requires User Confirmation)
 
-**Use `/workflow:brainstorm-with-file` when:**
+**Use `Skill(skill="workflow:brainstorm-with-file", args="\"topic or question\"")` when:**
 - Starting a new feature/product without clear direction
 - Facing a complex problem with multiple possible solutions
 - Need to explore alternatives before committing
 - Want documented thinking process for team review
 - Combining multiple stakeholder perspectives
 
-**Use `/workflow:analyze-with-file` when:**
+**Use `Skill(skill="workflow:analyze-with-file", args="\"topic\"")` when:**
 - Investigating existing code/system
 - Need factual analysis over ideation
 - Debugging or troubleshooting
 - Understanding current state
 
-**Use `/workflow:plan` when:**
+**Use `Skill(skill="workflow:collaborative-plan-with-file", args="\"task description\"")` when:**
+- Complex planning requiring multiple perspectives
+- Large scope needing parallel sub-domain analysis
+- Want shared collaborative planning document
+- Need structured task breakdown with agent coordination
+
+**Use `Skill(skill="workflow:lite-plan", args="\"task description\"")` when:**
 - Direction is already clear
 - Ready to move from ideas to execution
-- Need implementation breakdown
+- Need simple implementation breakdown
 
 ---
 

.claude/commands/workflow/debug-with-file.md

@@ -658,15 +658,15 @@ Why is config value None during update?
 | Hypothesis history | ❌ | ✅ hypotheses.json |
 | Gemini validation | ❌ | ✅ At key decision points |
 
-## Usage Recommendations
+## Usage Recommendations (Requires User Confirmation)
 
-Use `/workflow:debug-with-file` when:
+**Use `Skill(skill="workflow:debug-with-file", args="\"bug description\"")` when:**
 - Complex bugs requiring multiple investigation rounds
 - Learning from debugging process is valuable
 - Team needs to understand debugging rationale
 - Bug might recur, documentation helps prevention
 
-Use `/workflow:debug` when:
+**Use `Skill(skill="ccw-debug", args="--mode cli \"issue\"")` when:**
 - Simple, quick bugs
 - One-off issues
 - Documentation overhead not needed