# 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**
