📚 Update documentation with pipx installation instructions

- Added pipx as recommended installation method across all docs
- Updated troubleshooting guides with PEP 668 error solutions
- Added multiple installation options with clear hierarchy
- Enhanced error handling instructions with fallback options
- Consistent installation instructions throughout documentation

Docs/Reference/common-issues.md

@@ -16,15 +16,27 @@ Test: /sc:brainstorm "test" should ask questions
 python3 -m SuperClaude --version    # Should show 4.0.4
 
 # If not working:
+# For pipx users
+pipx upgrade SuperClaude
+
+# For pip users
 pip install --upgrade SuperClaude
+
+# Then reinstall
 python3 -m SuperClaude install
 ```
 
 ### 3. Permission Issues
 ```bash
-# Permission denied errors:
+# Permission denied / PEP 668 errors:
+# Option 1: Use pipx (recommended)
+pipx install SuperClaude
+
+# Option 2: Use pip with --user
 pip install --user SuperClaude
-# Or: sudo chown -R $USER ~/.claude
+
+# Option 3: Fix permissions
+sudo chown -R $USER ~/.claude
 ```
 
 ### 4. MCP Server Issues

Docs/Reference/troubleshooting.md

@@ -29,15 +29,29 @@ SuperClaude install --list-components
 
 **Package Installation Fails:**
 ```bash
+# For pipx users
+pipx uninstall SuperClaude
+pipx install SuperClaude
+
+# For pip users
 pip uninstall SuperClaude
 pip install --upgrade pip
 pip install SuperClaude
 ```
 
-**Permission Denied:**
+**Permission Denied / PEP 668 Error:**
 ```bash
+# Option 1: Use pipx (recommended)
+pipx install SuperClaude
+
+# Option 2: Use pip with --user flag
 pip install --user SuperClaude
-# Or: sudo chown -R $USER ~/.claude
+
+# Option 3: Fix permissions
+sudo chown -R $USER ~/.claude
+
+# Option 4: Force installation (use with caution)
+pip install --break-system-packages SuperClaude
 ```
 
 **Component Missing:**