SuperCharged-Claude-Code-Upgrade/always-use-superpowers/INTEGRATION_GUIDE.md

Always-Use-Superpowers Integration Guide

✅ What Was Fixed

Problem:

The original always-use-superpowers skill referenced non-existent superpowers:* skills:

• superpowers:using-superpowers ❌
• superpowers:brainstorming ❌
• superpowers:systematic-debugging ❌
• etc.

Solution:

Rewrote the skill to work with your actually available skills:

• ✅ ui-ux-pro-max - UI/UX design intelligence
• ✅ cognitive-planner - Task planning and strategy
• ✅ cognitive-context - Context awareness
• ✅ cognitive-safety - Security and safety

🎯 How It Works Now

Automatic Skill Selection Flow:

User sends ANY message
    ↓
Check: Is this UI/UX work?
    ↓ YES → Invoke ui-ux-pro-max
    ↓ NO
Check: Is this planning/strategy?
    ↓ YES → Invoke cognitive-planner
    ↓ NO
Check: Is this context/analysis needed?
    ↓ YES → Invoke cognitive-context
    ↓ NO
Check: Any security/safety concerns?
    ↓ YES → Invoke cognitive-safety
    ↓ NO
Proceed with task

Quick Reference Table:

Situation	Skill to Invoke	Priority
UI/UX design, HTML/CSS, visual work	ui-ux-pro-max	HIGH
Planning, strategy, implementation	cognitive-planner	HIGH
Understanding code, context, analysis	cognitive-context	HIGH
Security, validation, error handling	cognitive-safety	CRITICAL
Any design work	ui-ux-pro-max	HIGH
Any frontend work	ui-ux-pro-max	HIGH
Any database changes	cognitive-safety	CRITICAL
Any user input handling	cognitive-safety	CRITICAL
Any API endpoints	cognitive-safety	CRITICAL
Complex multi-step tasks	cognitive-planner	HIGH
Code analysis/reviews	cognitive-context	HIGH

📝 Usage Examples

Example 1: UI/UX Work

User: "Make the button look better"

Claude automatically:
1. ✅ Recognizes: UI/UX work
2. ✅ Invokes: ui-ux-pro-max
3. ✅ Follows: Design guidelines (accessibility, interactions, styling)
4. ✅ Result: Professional, accessible button

Example 2: Feature Implementation

User: "Implement user authentication"

Claude automatically:
1. ✅ Recognizes: Planning work → Invokes cognitive-planner
2. ✅ Recognizes: UI affected → Invokes ui-ux-pro-max
3. ✅ Recognizes: Context needed → Invokes cognitive-context
4. ✅ Recognizes: Security critical → Invokes cognitive-safety
5. ✅ Follows: All skill guidance
6. ✅ Result: Secure, planned, well-designed auth system

Example 3: Security Concern

User: "Update database credentials"

Claude automatically:
1. ✅ Recognizes: Security concern
2. ✅ Invokes: cognitive-safety
3. ✅ Follows: Security guidelines
4. ✅ Result: Safe credential updates

Example 4: Code Analysis

User: "What does this code do?"

Claude automatically:
1. ✅ Recognizes: Context needed
2. ✅ Invokes: cognitive-context
3. ✅ Follows: Context guidance
4. ✅ Result: Accurate analysis with proper context

🔧 How to Manually Invoke Skills

If automatic invocation doesn't work, you can manually invoke:

Skill: ui-ux-pro-max
Skill: cognitive-planner
Skill: cognitive-context
Skill: cognitive-safety

⚙️ Configuration Files

Main Skill:

• /home/uroma/.claude/skills/always-use-superpowers/SKILL.md

Available Skills:

• /home/uroma/.claude/skills/ui-ux-pro-max/SKILL.md
• /home/uroma/.claude/skills/cognitive-planner/SKILL.md
• /home/uroma/.claude/skills/cognitive-context/SKILL.md
• /home/uroma/.claude/skills/cognitive-safety/SKILL.md

✨ Key Improvements

1. No More Broken References: Removed all superpowers:* references
2. Works With Available Skills: Integrates with your actual skill set
3. Clear Decision Tree: Easy-to-follow flowchart for skill selection
4. Quick Reference Table: Fast lookup for when to use each skill
5. Real Examples: Practical usage scenarios
6. Priority System: CRITICAL vs HIGH priority guidance

🚀 Next Steps

The skill is now ready to use. It will automatically:

1. Detect which skills apply to your request
2. Invoke them before taking action
3. Follow their guidance precisely
4. Provide better, more informed responses

📊 Testing

To test if it's working:

1. Ask a UI/UX question → Should invoke ui-ux-pro-max
2. Ask for planning → Should invoke cognitive-planner
3. Ask about code → Should invoke cognitive-context
4. Ask about security → Should invoke cognitive-safety

---

Status: ✅ Fully Integrated and Ready to Use