mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
3762d6ab24
Comprehensive restoration of all agents, modes, MCP integrations, and documentation. ## 🤖 Agents Restored (20 total) Added 17 new agent definitions to existing 3: - backend-architect, business-panel-experts, deep-research-agent - devops-architect, frontend-architect, learning-guide - performance-engineer, pm-agent, python-expert - quality-engineer, refactoring-expert, requirements-analyst - root-cause-analyst, security-engineer, socratic-mentor - system-architect, technical-writer ## 🎨 Behavioral Modes (7) - MODE_Brainstorming - Multi-perspective ideation - MODE_Business_Panel - Executive strategic analysis - MODE_DeepResearch - Autonomous research - MODE_Introspection - Meta-cognitive analysis - MODE_Orchestration - Tool coordination - MODE_Task_Management - Systematic organization - MODE_Token_Efficiency - Context optimization ## 🔌 MCP Server Integration (8) Documentation and configs for: - Tavily (web search) - Serena (session persistence) - Sequential (token-efficient reasoning) - Context7 (documentation lookup) - Playwright (browser automation) - Magic (UI components) - Morphllm (model transformation) - Chrome DevTools (performance) ## 📚 Core Documentation (6) - PRINCIPLES.md, RULES.md, FLAGS.md - RESEARCH_CONFIG.md - BUSINESS_PANEL_EXAMPLES.md, BUSINESS_SYMBOLS.md ## 📖 Documentation Restored (152 files) - User-Guide (en, jp, kr, zh) - 24 files - Developer-Guide - 5 files - Development docs - 10 files - Reference docs - 10 files - Getting-Started - 2 files - Plus examples and templates ## 📦 Package Configuration Updated pyproject.toml and MANIFEST.in to include: - modes/**/*.md - mcp/**/*.md, **/*.json - core/**/*.md - examples/**/*.md - Comprehensive docs in distribution ## 📁 Directory Structure plugins/superclaude/ and src/superclaude/: - agents/ (20 files) - modes/ (7 files) - mcp/ (8 docs + 8 configs) - core/ (6 files) - examples/ (workflow examples) docs/: - 152 markdown files - Multi-language support (en, jp, kr, zh) - Comprehensive guides and references ## 📊 Statistics - Commands: 30 - Agents: 20 - Modes: 7 - MCP Servers: 8 - Documentation Files: 152 - Total Resource Files: 200+ Created docs/reference/comprehensive-features.md with complete inventory. Source: commit d4a17fc Total changes: 150+ files added/modified 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
79 lines
1.7 KiB
Markdown
79 lines
1.7 KiB
Markdown
# SuperClaude Common Issues - Quick Reference 🚀
|
|
|
|
**Problem Solving Guide**: Most frequent issues with practical solutions.
|
|
|
|
## Top 5 Quick Fixes (90% of Issues)
|
|
|
|
### 1. Commands Not Working in Claude Code ⚡
|
|
```
|
|
Problem: /sc:brainstorm doesn't work
|
|
Solution: Restart Claude Code completely
|
|
Test: /sc:brainstorm "test" should ask questions
|
|
```
|
|
|
|
### 2. Installation Verification
|
|
```bash
|
|
python3 -m SuperClaude --version # Should show 4.1.5
|
|
|
|
# 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 / PEP 668 errors:
|
|
# Option 1: Use pipx (recommended)
|
|
pipx install SuperClaude
|
|
|
|
# Option 2: Use pip with --user
|
|
pip install --user SuperClaude
|
|
|
|
# Option 3: Fix permissions
|
|
sudo chown -R $USER ~/.claude
|
|
```
|
|
|
|
### 4. MCP Server Issues
|
|
```bash
|
|
/sc:analyze . --no-mcp # Test without MCP servers
|
|
node --version # Check Node.js 16+ if needed
|
|
```
|
|
|
|
### 5. Component Missing
|
|
```bash
|
|
python3 -m SuperClaude install --components core commands agents modes --force
|
|
```
|
|
|
|
## Platform-Specific Issues
|
|
|
|
**Windows:**
|
|
```cmd
|
|
set CLAUDE_CONFIG_DIR=%USERPROFILE%\.claude
|
|
python -m SuperClaude install --install-dir "%CLAUDE_CONFIG_DIR%"
|
|
```
|
|
|
|
**macOS:**
|
|
```bash
|
|
brew install python3 node
|
|
pip3 install SuperClaude
|
|
```
|
|
|
|
**Linux:**
|
|
```bash
|
|
sudo apt install python3 python3-pip nodejs
|
|
pip3 install SuperClaude
|
|
```
|
|
|
|
## Verification Checklist
|
|
- [ ] `python3 -m SuperClaude --version` returns 4.1.5
|
|
- [ ] `/sc:brainstorm "test"` works in Claude Code
|
|
- [ ] `SuperClaude install --list-components` shows components
|
|
|
|
## When Quick Fixes Don't Work
|
|
See [Troubleshooting Guide](troubleshooting.md) for advanced diagnostics. |