External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

🚨 Fix major hallucinations in SuperClaude documentation

Browse Source 
CRITICAL FIXES:
- Remove all references to non-existent 'SuperClaude status' command
- Remove all references to non-existent 'SuperClaude diagnose' standalone command
- Remove all references to non-existent 'SuperClaude test-mcp' command
- Update diagnose references to use correct 'SuperClaude install --diagnose'
- Fix python help command references to use correct syntax

CONTEXT:
SuperClaude is a context-oriented framework with .md instruction files,
not an executable with extensive CLI commands. Only Python installer
supports: install, update, uninstall, backup operations.

VERIFIED COMMANDS:
✅ python3 -m SuperClaude --help (works)
✅ SuperClaude install --diagnose (works)
✅ SuperClaude install --list-components (works)
❌ SuperClaude status (does not exist)
❌ SuperClaude diagnose (does not exist)
❌ SuperClaude test-mcp (does not exist)

FILES FIXED:
- commands.md: status → config checks, diagnose → install --diagnose
- flags.md: status → config checks, help flags → help
- agents.md: diagnose → install --diagnose
- mcp-servers.md: status → config checks, test-mcp → /sc: commands
- modes.md: diagnose → install --diagnose
- session-management.md: status → list-components

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
2025-08-18 18:48:52 +02:00
parent c09b0c5755
commit 14fb4a3216
6 changed files with 40 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
Docs/User-Guide/agents.md
View File

@@ -509,7 +509,7 @@ Task Analysis →
**Level 3: Expert Support (30+ min)** **Level 3: Expert Support (30+ min)**
```bash ```bash
# Deep agent analysis # Deep agent analysis
SuperClaude diagnose --agents SuperClaude install --diagnose
# Check agent coordination patterns # Check agent coordination patterns
# Review multi-domain keyword strategies # Review multi-domain keyword strategies
``` ```

10
Docs/User-Guide/commands.md
View File

@@ -19,8 +19,8 @@ SuperClaude --version
# Expected: SuperClaude Framework v4.0+ # Expected: SuperClaude Framework v4.0+
# Check MCP server connectivity # Check MCP server connectivity
SuperClaude status --mcp SuperClaude install --list-components | grep mcp
# Expected: At least context7 and sequential-thinking connected # Expected: Shows installed MCP components
``` ```
### 💬 Claude Code Testing (Type in Claude Code Chat) ### 💬 Claude Code Testing (Type in Claude Code Chat)
@@ -499,7 +499,7 @@ ps aux | grep SuperClaude # Check for hung processes
```bash ```bash
# Problem: MCP servers not responding # Problem: MCP servers not responding
# Quick Fix: Verify server status and restart # Quick Fix: Verify server status and restart
SuperClaude status --mcp # Check all servers ls ~/.claude/.claude.json # Check MCP config exists
/sc:command --no-mcp # Bypass MCP temporarily /sc:command --no-mcp # Bypass MCP temporarily
node --version # Verify Node.js v16+ node --version # Verify Node.js v16+
npm cache clean --force # Clear NPM cache npm cache clean --force # Clear NPM cache
@@ -546,7 +546,7 @@ killall node # Reset MCP servers
**Level 2: Detailed Help (5-15 min)** **Level 2: Detailed Help (5-15 min)**
```bash ```bash
# Comprehensive diagnostics # Comprehensive diagnostics
SuperClaude diagnose --verbose SuperClaude install --diagnose
/sc:help troubleshoot /sc:help troubleshoot
cat ~/.claude/logs/superclaude.log | tail -50 cat ~/.claude/logs/superclaude.log | tail -50
``` ```
@@ -555,7 +555,7 @@ cat ~/.claude/logs/superclaude.log | tail -50
**Level 3: Expert Support (30+ min)** **Level 3: Expert Support (30+ min)**
```bash ```bash
# Deep system analysis # Deep system analysis
SuperClaude diagnose --full-system SuperClaude install --diagnose
strace -e trace=file /sc:command 2>&1 | grep ENOENT strace -e trace=file /sc:command 2>&1 | grep ENOENT
lsof | grep SuperClaude lsof | grep SuperClaude
# Check GitHub Issues for known problems # Check GitHub Issues for known problems

14
Docs/User-Guide/flags.md
View File

@@ -659,7 +659,7 @@ SuperClaude's intelligent flag system automatically detects task complexity and
- **Reset flags**: Remove all flags and let auto-detection work - **Reset flags**: Remove all flags and let auto-detection work
- **Check compatibility**: Use `/sc:help flags` for valid combinations - **Check compatibility**: Use `/sc:help flags` for valid combinations
- **Restart session**: Exit and restart Claude Code to reset flag state - **Restart session**: Exit and restart Claude Code to reset flag state
- **Verify setup**: Run `SuperClaude status --flags` to check flag system - **Verify setup**: Check `/sc:help flags` for available flag options
### Flag-Specific Troubleshooting ### Flag-Specific Troubleshooting
@@ -668,7 +668,7 @@ SuperClaude's intelligent flag system automatically detects task complexity and
# Problem: "Unknown flag --invalid-flag" # Problem: "Unknown flag --invalid-flag"
# Quick Fix: Check flag spelling and availability # Quick Fix: Check flag spelling and availability
/sc:help flags # List all valid flags /sc:help flags # List all valid flags
python3 -m SuperClaude --help flags # System-level flag help python3 -m SuperClaude --help # System-level help
# Common typos: --brainstrom → --brainstorm, --seq → --sequential # Common typos: --brainstrom → --brainstorm, --seq → --sequential
``` ```
@@ -676,7 +676,7 @@ python3 -m SuperClaude --help flags # System-level flag help
```bash ```bash
# Problem: --magic, --morph, --c7 not working # Problem: --magic, --morph, --c7 not working
# Quick Fix: Check MCP server status # Quick Fix: Check MCP server status
SuperClaude status --mcp # Verify server connections ls ~/.claude/.claude.json # Check MCP config exists
node --version # Ensure Node.js v16+ node --version # Ensure Node.js v16+
npm cache clean --force # Clear package cache npm cache clean --force # Clear package cache
/sc:command --no-mcp # Bypass MCP temporarily /sc:command --no-mcp # Bypass MCP temporarily
@@ -765,7 +765,7 @@ SuperClaude install --components mcp --force # Reinstall MCP
**Level 2: Detailed Help (5-15 min)** **Level 2: Detailed Help (5-15 min)**
```bash ```bash
# Flag-specific diagnostics # Flag-specific diagnostics
SuperClaude diagnose --flags SuperClaude install --diagnose
/sc:help flags --verbose /sc:help flags --verbose
cat ~/.claude/logs/flag-system.log cat ~/.claude/logs/flag-system.log
# Test individual flags one at a time # Test individual flags one at a time
@@ -792,13 +792,13 @@ strace -e trace=execve /sc:command --verbose 2>&1
After applying flag fixes, test with: After applying flag fixes, test with:
- [ ] `/sc:help flags` (should list all available flags) - [ ] `/sc:help flags` (should list all available flags)
- [ ] `/sc:command --basic-flag` (should work without errors) - [ ] `/sc:command --basic-flag` (should work without errors)
- [ ] `SuperClaude status --mcp` (MCP flags should work if servers connected) - [ ] `ls ~/.claude/.claude.json` (MCP config should exist if installed)
- [ ] Flag combinations follow priority rules correctly - [ ] Flag combinations follow priority rules correctly
- [ ] Auto-detection works for simple commands - [ ] Auto-detection works for simple commands
## Quick Troubleshooting (Legacy) ## Quick Troubleshooting (Legacy)
- **Flag not recognized** → Check spelling: `SuperClaude --help flags` - **Flag not recognized** → Check spelling: `python3 -m SuperClaude --help`
- **MCP flag fails** → Check server status: `SuperClaude status --mcp` - **MCP flag fails** → Check MCP config: `ls ~/.claude/.claude.json`
- **Auto-flags wrong** → Use manual override: `--no-mcp` or specific flags - **Auto-flags wrong** → Use manual override: `--no-mcp` or specific flags
- **Performance issues** → Reduce complexity: `--scope file` or `--concurrency 1` - **Performance issues** → Reduce complexity: `--scope file` or `--concurrency 1`
- **Flag conflicts** → Check priority rules in documentation - **Flag conflicts** → Check priority rules in documentation

37
Docs/User-Guide/mcp-servers.md
View File

@@ -11,9 +11,9 @@
Before using this guide, verify MCP servers are working: Before using this guide, verify MCP servers are working:
```bash ```bash
# Test server connectivity # Test MCP configuration exists
SuperClaude status --mcp ls ~/.claude/.claude.json
# Expected: Shows connected servers (at minimum context7, sequential-thinking) # Expected: Shows MCP server configuration file
# Test Context7 server # Test Context7 server
/sc:explain "React useEffect" /sc:explain "React useEffect"
@@ -744,9 +744,9 @@ ls ~/.claude/.claude.json
node --version node --version
# Should show: v16.x.x or higher # Should show: v16.x.x or higher
# Test basic MCP connectivity # Test basic MCP configuration
SuperClaude status --mcp ls ~/.claude/.claude.json
# Should show connected servers (at least context7, sequential-thinking) # Should show MCP server configuration file exists
``` ```
**Step 2: Common Fixes (1-2 minutes)** **Step 2: Common Fixes (1-2 minutes)**
@@ -787,9 +787,9 @@ chmod -R 755 ~/.claude/
# Detailed MCP server logs # Detailed MCP server logs
tail -f ~/.claude/logs/mcp-*.log tail -f ~/.claude/logs/mcp-*.log
# Test individual server connections # Test individual server functionality
SuperClaude test-mcp --server context7 /sc:explain "test" --c7 # Test Context7 server
SuperClaude test-mcp --server sequential-thinking /sc:analyze test/ --seq # Test Sequential server
# Check for port conflicts # Check for port conflicts
netstat -tulpn | grep :3000 netstat -tulpn | grep :3000
@@ -891,9 +891,10 @@ SuperClaude restart --mcp # Restart MCP system
**Level 2: Detailed Help (5-15 min)** **Level 2: Detailed Help (5-15 min)**
```bash ```bash
# MCP-specific diagnostics # MCP-specific diagnostics
SuperClaude diagnose --mcp SuperClaude install --diagnose
tail -f ~/.claude/logs/mcp-*.log tail -f ~/.claude/logs/mcp-*.log
SuperClaude test-mcp --all-servers # Test all MCP servers with commands
/sc:explain "test" --c7 && /sc:analyze test/ --seq
``` ```
- See [Common Issues Guide](../Reference/common-issues.md) for MCP installation problems - See [Common Issues Guide](../Reference/common-issues.md) for MCP installation problems
- See [MCP Server Guide](../Reference/mcp-server-guide.md) for detailed server troubleshooting - See [MCP Server Guide](../Reference/mcp-server-guide.md) for detailed server troubleshooting
@@ -901,7 +902,7 @@ SuperClaude test-mcp --all-servers
**Level 3: Expert Support (30+ min)** **Level 3: Expert Support (30+ min)**
```bash ```bash
# Deep MCP analysis # Deep MCP analysis
SuperClaude diagnose --mcp --full-system SuperClaude install --diagnose
lsof | grep mcp lsof | grep mcp
netstat -tulpn | grep node netstat -tulpn | grep node
# Check individual server configurations # Check individual server configurations
@@ -916,7 +917,7 @@ netstat -tulpn | grep node
### Success Validation ### Success Validation
After applying MCP fixes, test with: After applying MCP fixes, test with:
- [ ] `SuperClaude status --mcp` (should show connected servers) - [ ] `ls ~/.claude/.claude.json` (should show MCP configuration exists)
- [ ] `/sc:explain "test" --c7` (context7 should fetch documentation) - [ ] `/sc:explain "test" --c7` (context7 should fetch documentation)
- [ ] `/sc:analyze test/ --seq` (sequential should show reasoning) - [ ] `/sc:analyze test/ --seq` (sequential should show reasoning)
- [ ] MCP flags work: `--magic`, `--play` (if configured) - [ ] MCP flags work: `--magic`, `--play` (if configured)
@@ -926,15 +927,15 @@ After applying MCP fixes, test with:
**MCP Server Status Check:** **MCP Server Status Check:**
```bash ```bash
# Check all server health # Check MCP configuration exists
SuperClaude status --mcp ls ~/.claude/.claude.json
# Test individual servers # Test individual servers
SuperClaude test-mcp --server context7 /sc:explain "test" --c7 # Test Context7
SuperClaude test-mcp --server sequential /sc:analyze test/ --seq # Test Sequential
# Detailed diagnostics # Detailed diagnostics
SuperClaude diagnose --verbose SuperClaude install --diagnose
``` ```
**Log Analysis:** **Log Analysis:**

2
Docs/User-Guide/modes.md
View File

@@ -518,7 +518,7 @@ Standard Approach: Consistent, professional baseline for all tasks
**Level 3: Expert Support (30+ min)** **Level 3: Expert Support (30+ min)**
```bash ```bash
# Deep mode analysis # Deep mode analysis
SuperClaude diagnose --modes SuperClaude install --diagnose
# Check mode activation patterns # Check mode activation patterns
# Review behavioral triggers and thresholds # Review behavioral triggers and thresholds
``` ```

14
Docs/User-Guide/session-management.md
View File

@@ -24,12 +24,12 @@ Before using this guide, verify session commands work:
# Expected: Shows current session status and progress # Expected: Shows current session status and progress
``` ```
**If tests fail**: Check Serena MCP installation: `SuperClaude status --mcp serena` **If tests fail**: Check Serena MCP installation: `SuperClaude install --list-components | grep serena`
## 🚨 Quick Troubleshooting ## 🚨 Quick Troubleshooting
### Common Issues (< 2 minutes) ### Common Issues (< 2 minutes)
- **Session won't load**: Check Serena MCP server connection: `SuperClaude status --mcp serena` - **Session won't load**: Check Serena MCP installed: `SuperClaude install --list-components | grep serena`
- **Save fails**: Verify write permissions to `~/.claude/` directory - **Save fails**: Verify write permissions to `~/.claude/` directory
- **Memory issues**: Clear old sessions with `/sc:reflect --type session-cleanup` - **Memory issues**: Clear old sessions with `/sc:reflect --type session-cleanup`
- **Slow loading**: Use `--scope file` for large projects or `--fast` flag - **Slow loading**: Use `--scope file` for large projects or `--fast` flag
@@ -71,8 +71,8 @@ Test your setup before starting:
# Verify SuperClaude is working # Verify SuperClaude is working
SuperClaude --version SuperClaude --version
# Check Serena MCP connection # Check Serena MCP installed
SuperClaude status --mcp serena SuperClaude install --list-components | grep serena
``` ```
**Time Investment:** **Time Investment:**
@@ -189,7 +189,7 @@ cd /path/to/your/project
**Test:** Session should remember changes when resumed later **Test:** Session should remember changes when resumed later
**Check:** `/sc:reflect` should show accurate progress tracking **Check:** `/sc:reflect` should show accurate progress tracking
**Need Help?**: If any step fails, check your setup by running `SuperClaude status --mcp serena` to verify the Serena MCP server is working correctly. **Need Help?**: If any step fails, check your setup by running `SuperClaude install --list-components | grep serena` to verify the Serena MCP component is installed.
## Session Commands ## Session Commands
@@ -519,7 +519,7 @@ delete_memory(key) # Clean up old data
# Problem: "/sc:load project/ fails with error" # Problem: "/sc:load project/ fails with error"
# Quick Fix: Verify project and dependencies # Quick Fix: Verify project and dependencies
ls -la project/ # Check project exists ls -la project/ # Check project exists
SuperClaude status --mcp serena # Verify Serena MCP SuperClaude install --list-components | grep serena # Verify Serena MCP
/sc:load . --refresh # Force fresh analysis /sc:load . --refresh # Force fresh analysis
/sc:load . --scope module # Reduce load scope /sc:load . --scope module # Reduce load scope
``` ```
@@ -585,7 +585,7 @@ cat ~/.claude/logs/serena.log | tail -50 # Check Serena logs
**Level 3: Expert Support (30+ min)** **Level 3: Expert Support (30+ min)**
```bash ```bash
# Deep session analysis # Deep session analysis
SuperClaude diagnose --sessions SuperClaude install --diagnose
ls -la ~/.claude/serena/ # Check Serena state ls -la ~/.claude/serena/ # Check Serena state
uv run serena diagnose # Serena diagnostics uv run serena diagnose # Serena diagnostics
# Reset session system completely # Reset session system completely