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

.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