mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-18 02:06:36 +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>
124 lines
2.9 KiB
Markdown
124 lines
2.9 KiB
Markdown
# SuperClaude Troubleshooting Guide 🔧
|
|
|
|
Quick fixes to advanced diagnostics for SuperClaude Framework issues.
|
|
|
|
## Quick Fixes (90% of problems)
|
|
|
|
**Installation Verification:**
|
|
```bash
|
|
python3 -m SuperClaude --version # Should show 4.1.5
|
|
SuperClaude install --list-components
|
|
```
|
|
|
|
**Command Issues:**
|
|
```bash
|
|
# Test in Claude Code:
|
|
/sc:brainstorm "test project" # Should ask discovery questions
|
|
|
|
# If no response: Restart Claude Code session
|
|
```
|
|
|
|
**Resolution Checklist:**
|
|
- [ ] Version commands work and show 4.1.5
|
|
- [ ] `/sc:` commands respond in Claude Code
|
|
- [ ] MCP servers listed: `SuperClaude install --list-components | grep mcp`
|
|
|
|
## Common Issues
|
|
|
|
### Installation Problems
|
|
|
|
**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 / PEP 668 Error:**
|
|
```bash
|
|
# Option 1: Use pipx (recommended)
|
|
pipx install SuperClaude
|
|
|
|
# Option 2: Use pip with --user flag
|
|
pip install --user SuperClaude
|
|
|
|
# Option 3: Fix permissions
|
|
sudo chown -R $USER ~/.claude
|
|
|
|
# Option 4: Force installation (use with caution)
|
|
pip install --break-system-packages SuperClaude
|
|
```
|
|
|
|
**Component Missing:**
|
|
```bash
|
|
python3 -m SuperClaude install --components core commands agents modes --force
|
|
```
|
|
|
|
### Command Issues
|
|
|
|
**Commands Not Recognized:**
|
|
1. Restart Claude Code completely
|
|
2. Verify: `python3 -m SuperClaude --version`
|
|
3. Test: `/sc:brainstorm "test"`
|
|
|
|
**Agents Not Activating:**
|
|
- Use specific keywords: `/sc:implement "secure JWT authentication"`
|
|
- Manual activation: `@agent-security "review auth code"`
|
|
|
|
**Slow Performance:**
|
|
```bash
|
|
/sc:analyze . --no-mcp # Test without MCP servers
|
|
/sc:analyze src/ --scope file # Limit scope
|
|
```
|
|
|
|
### MCP Server Issues
|
|
|
|
**Server Connection Fails:**
|
|
```bash
|
|
ls ~/.claude/.claude.json # Check config exists
|
|
node --version # Verify Node.js 16+
|
|
SuperClaude install --components mcp --force
|
|
```
|
|
|
|
**API Key Required (Magic/Morphllm):**
|
|
```bash
|
|
export TWENTYFIRST_API_KEY="your_key"
|
|
export MORPH_API_KEY="your_key"
|
|
# Or use: /sc:command --no-mcp
|
|
```
|
|
|
|
## Advanced Diagnostics
|
|
|
|
**System Analysis:**
|
|
```bash
|
|
SuperClaude install --diagnose
|
|
cat ~/.claude/logs/superclaude.log | tail -50
|
|
```
|
|
|
|
**Component Analysis:**
|
|
```bash
|
|
ls -la ~/.claude/ # Check installed files
|
|
grep -r "@" ~/.claude/CLAUDE.md # Verify imports
|
|
```
|
|
|
|
**Reset Installation:**
|
|
```bash
|
|
SuperClaude backup --create # Backup first
|
|
SuperClaude uninstall
|
|
SuperClaude install --fresh
|
|
```
|
|
|
|
## Get Help
|
|
|
|
**Documentation:**
|
|
- [Installation Guide](../Getting-Started/installation.md) - Setup issues
|
|
- [Commands Guide](../User-Guide/commands.md) - Usage issues
|
|
|
|
**Community:**
|
|
- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)
|
|
- Include: OS, Python version, error message, steps to reproduce |