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

Standardize internal markdown references with explicit relative paths

Browse Source 
• Updated troubleshooting.md, optimization-guide.md, mcp-server-guide.md, diagnostic-reference.md, and README.md
• Changed internal references from (filename.md) to (./filename.md) format
• Improved link robustness and portability across different viewing contexts
• Completed cross-reference standardization throughout Reference directory

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK 2025-08-18 13:01:14 +02:00
parent f614560964
commit 0e856a9975
8 changed files with 93 additions and 93 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
Docs/Reference/README.md
View File

@ -21,17 +21,17 @@ This documentation is organized for **progressive learning** with multiple entry
| Document | Purpose | Target Audience | Complexity | Time Investment | | Document | Purpose | Target Audience | Complexity | Time Investment |
|----------|---------|-----------------|------------|-----------------| |----------|---------|-----------------|------------|-----------------|
| **[quick-start-practices.md](quick-start-practices.md)** | Essential foundations and first steps | New users, onboarding | **Basic** | 30-60 minutes | | **[quick-start-practices.md](./quick-start-practices.md)** | Essential foundations and first steps | New users, onboarding | **Basic** | 30-60 minutes |
| **[basic-examples.md](basic-examples.md)** | Copy-paste ready commands and patterns | All users, quick reference | **Basic** | 15-30 minutes | | **[basic-examples.md](./basic-examples.md)** | Copy-paste ready commands and patterns | All users, quick reference | **Basic** | 15-30 minutes |
| **[examples-cookbook.md](examples-cookbook.md)** | Recipe collection hub and organization | All users, navigation | **Reference** | 5 minutes | | **[examples-cookbook.md](./examples-cookbook.md)** | Recipe collection hub and organization | All users, navigation | **Reference** | 5 minutes |
| **[common-issues.md](common-issues.md)** | Essential troubleshooting and solutions | All users, problem-solving | **Basic** | As needed | | **[common-issues.md](./common-issues.md)** | Essential troubleshooting and solutions | All users, problem-solving | **Basic** | As needed |
| **[mcp-server-guide.md](mcp-server-guide.md)** | MCP server configuration and usage | Technical users, integration | **Intermediate** | 45-90 minutes | | **[mcp-server-guide.md](./mcp-server-guide.md)** | MCP server configuration and usage | Technical users, integration | **Intermediate** | 45-90 minutes |
| **[optimization-guide.md](optimization-guide.md)** | Performance tuning and efficiency | All levels, improvement | **Variable** | 60-120 minutes | | **[optimization-guide.md](./optimization-guide.md)** | Performance tuning and efficiency | All levels, improvement | **Variable** | 60-120 minutes |
| **[advanced-patterns.md](advanced-patterns.md)** | Expert coordination and orchestration | Experienced users | **Advanced** | 90-150 minutes | | **[advanced-patterns.md](./advanced-patterns.md)** | Expert coordination and orchestration | Experienced users | **Advanced** | 90-150 minutes |
| **[advanced-workflows.md](advanced-workflows.md)** | Complex multi-agent orchestration | Expert users | **Advanced** | 120-180 minutes | | **[advanced-workflows.md](./advanced-workflows.md)** | Complex multi-agent orchestration | Expert users | **Advanced** | 120-180 minutes |
| **[integration-patterns.md](integration-patterns.md)** | Framework and system integration | Architects, experts | **Advanced** | 90-150 minutes | | **[integration-patterns.md](./integration-patterns.md)** | Framework and system integration | Architects, experts | **Advanced** | 90-150 minutes |
| **[troubleshooting.md](troubleshooting.md)** | Comprehensive diagnostic guide | All levels, deep debugging | **Variable** | As needed | | **[troubleshooting.md](./troubleshooting.md)** | Comprehensive diagnostic guide | All levels, deep debugging | **Variable** | As needed |
| **[diagnostic-reference.md](diagnostic-reference.md)** | Advanced debugging and analysis | Expert users, complex issues | **Advanced** | 60-120 minutes | | **[diagnostic-reference.md](./diagnostic-reference.md)** | Advanced debugging and analysis | Expert users, complex issues | **Advanced** | 60-120 minutes |
--- ---
@ -159,19 +159,19 @@ Advanced Analysis: diagnostic-reference.md
## Problem-Solving Quick Reference ## Problem-Solving Quick Reference
### Immediate Issues (< 5 minutes) ### Immediate Issues (< 5 minutes)
- **Command not working**: Check [common-issues.md](common-issues.md) → Common SuperClaude Problems - **Command not working**: Check [common-issues.md](./common-issues.md) → Common SuperClaude Problems
- **Session lost**: Use `/sc:load` → See [quick-start-practices.md](quick-start-practices.md) → Session Management - **Session lost**: Use `/sc:load` → See [quick-start-practices.md](./quick-start-practices.md) → Session Management
- **Flag confusion**: Check [basic-examples.md](basic-examples.md) → Flag Usage Examples - **Flag confusion**: Check [basic-examples.md](./basic-examples.md) → Flag Usage Examples
### Development Blockers (15-30 minutes) ### Development Blockers (15-30 minutes)
- **Performance slow**: See [optimization-guide.md](optimization-guide.md) → Performance Patterns - **Performance slow**: See [optimization-guide.md](./optimization-guide.md) → Performance Patterns
- **Complex debugging**: Use [troubleshooting.md](troubleshooting.md) → Systematic Debugging - **Complex debugging**: Use [troubleshooting.md](./troubleshooting.md) → Systematic Debugging
- **Integration issues**: Check [integration-patterns.md](integration-patterns.md) → Framework Patterns - **Integration issues**: Check [integration-patterns.md](./integration-patterns.md) → Framework Patterns
### System-Level Issues (45+ minutes) ### System-Level Issues (45+ minutes)
- **Architecture problems**: Use [advanced-workflows.md](advanced-workflows.md) → System Design - **Architecture problems**: Use [advanced-workflows.md](./advanced-workflows.md) → System Design
- **Expert debugging**: Apply [diagnostic-reference.md](diagnostic-reference.md) → Advanced Analysis - **Expert debugging**: Apply [diagnostic-reference.md](./diagnostic-reference.md) → Advanced Analysis
- **Custom workflow needs**: Study [advanced-patterns.md](advanced-patterns.md) → Custom Orchestration - **Custom workflow needs**: Study [advanced-patterns.md](./advanced-patterns.md) → Custom Orchestration
--- ---
@ -192,7 +192,7 @@ Advanced Analysis: diagnostic-reference.md
### Reporting Issues ### Reporting Issues
Found outdated information or broken examples? Found outdated information or broken examples?
1. **Quick Fixes**: Check [common-issues.md](common-issues.md) first 1. **Quick Fixes**: Check [common-issues.md](./common-issues.md) first
2. **Documentation Bugs**: Report via project issues with specific file and line 2. **Documentation Bugs**: Report via project issues with specific file and line
3. **Missing Patterns**: Suggest additions with use case description 3. **Missing Patterns**: Suggest additions with use case description
4. **Verification Requests**: Request re-testing of specific examples 4. **Verification Requests**: Request re-testing of specific examples
@ -214,7 +214,7 @@ Found outdated information or broken examples?
4. **Community Learning**: Share discoveries and learn from others' approaches 4. **Community Learning**: Share discoveries and learn from others' approaches
### Troubleshooting Mastery ### Troubleshooting Mastery
1. **Systematic Approach**: Always start with [common-issues.md](common-issues.md) 1. **Systematic Approach**: Always start with [common-issues.md](./common-issues.md)
2. **Evidence Gathering**: Use `--think` for complex problem analysis 2. **Evidence Gathering**: Use `--think` for complex problem analysis
3. **Root Cause Focus**: Address underlying issues, not just symptoms 3. **Root Cause Focus**: Address underlying issues, not just symptoms
4. **Documentation First**: Check official docs before experimental solutions 4. **Documentation First**: Check official docs before experimental solutions
@ -224,16 +224,16 @@ Found outdated information or broken examples?
## Advanced Resources & Integration ## Advanced Resources & Integration
### Framework-Specific Guides ### Framework-Specific Guides
- **React/Next.js**: See [integration-patterns.md](integration-patterns.md) → React Integration - **React/Next.js**: See [integration-patterns.md](./integration-patterns.md) → React Integration
- **Vue/Nuxt**: See [integration-patterns.md](integration-patterns.md) → Vue Ecosystem - **Vue/Nuxt**: See [integration-patterns.md](./integration-patterns.md) → Vue Ecosystem
- **Node.js/Express**: See [integration-patterns.md](integration-patterns.md) → Backend Patterns - **Node.js/Express**: See [integration-patterns.md](./integration-patterns.md) → Backend Patterns
- **Python/Django**: See [integration-patterns.md](integration-patterns.md) → Python Workflows - **Python/Django**: See [integration-patterns.md](./integration-patterns.md) → Python Workflows
### Specialized Workflows ### Specialized Workflows
- **DevOps Integration**: [advanced-workflows.md](advanced-workflows.md) → CI/CD Patterns - **DevOps Integration**: [advanced-workflows.md](./advanced-workflows.md) → CI/CD Patterns
- **Testing Strategies**: [advanced-patterns.md](advanced-patterns.md) → Testing Orchestration - **Testing Strategies**: [advanced-patterns.md](./advanced-patterns.md) → Testing Orchestration
- **Performance Engineering**: [optimization-guide.md](optimization-guide.md) → Advanced Optimization - **Performance Engineering**: [optimization-guide.md](./optimization-guide.md) → Advanced Optimization
- **Security Implementation**: [integration-patterns.md](integration-patterns.md) → Security Patterns - **Security Implementation**: [integration-patterns.md](./integration-patterns.md) → Security Patterns
### Community & Support ### Community & Support
- **Best Practices**: Continuously updated based on community feedback - **Best Practices**: Continuously updated based on community feedback
@ -243,8 +243,8 @@ Found outdated information or broken examples?
--- ---
**Start Your Journey**: New to SuperClaude? Begin with [quick-start-practices.md](quick-start-practices.md) for immediate productivity gains. **Start Your Journey**: New to SuperClaude? Begin with [quick-start-practices.md](./quick-start-practices.md) for immediate productivity gains.
**Need Answers Now**: Jump to [basic-examples.md](basic-examples.md) for copy-paste solutions. **Need Answers Now**: Jump to [basic-examples.md](./basic-examples.md) for copy-paste solutions.
**Ready for Advanced**: Explore [advanced-patterns.md](advanced-patterns.md) for expert-level orchestration. **Ready for Advanced**: Explore [advanced-patterns.md](./advanced-patterns.md) for expert-level orchestration.

8
Docs/Reference/advanced-patterns.md
View File

@ -22,8 +22,8 @@
- [Adaptive Learning Patterns](#adaptive-learning-patterns) - Continuous improvement strategies - [Adaptive Learning Patterns](#adaptive-learning-patterns) - Continuous improvement strategies
### See Also ### See Also
- [Quick Start Practices](quick-start-practices.md) - Foundation skills and basic workflows - [Quick Start Practices](./quick-start-practices.md) - Foundation skills and basic workflows
- [Optimization Guide](optimization-guide.md) - Performance and efficiency strategies - [Optimization Guide](./optimization-guide.md) - Performance and efficiency strategies
## Agent Coordination Excellence ## Agent Coordination Excellence
@ -699,7 +699,7 @@ Master these advanced patterns to become a SuperClaude expert:
- Apply complex orchestration patterns to enterprise scenarios - Apply complex orchestration patterns to enterprise scenarios
**Skill Development:** **Skill Development:**
- [Optimization Guide](optimization-guide.md) - Performance and efficiency mastery - [Optimization Guide](./optimization-guide.md) - Performance and efficiency mastery
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding - [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding
**Leadership and Mentoring:** **Leadership and Mentoring:**
@ -711,7 +711,7 @@ Master these advanced patterns to become a SuperClaude expert:
**Share Your Patterns:** **Share Your Patterns:**
- Document successful coordination strategies - Document successful coordination strategies
- Contribute to [Examples Cookbook](examples-cookbook.md) - Contribute to [Examples Cookbook](./examples-cookbook.md)
- Share insights in [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Share insights in [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions)
**Advanced Learning:** **Advanced Learning:**

4
Docs/Reference/diagnostic-reference.md
View File

@ -997,8 +997,8 @@ EOF
- **Log Analysis**: `journalctl`, `tail`, `grep`, `awk` - **Log Analysis**: `journalctl`, `tail`, `grep`, `awk`
### SuperClaude-Specific Resources ### SuperClaude-Specific Resources
- **Common Issues**: [common-issues.md](common-issues.md) - Basic troubleshooting procedures - **Common Issues**: [common-issues.md](./common-issues.md) - Basic troubleshooting procedures
- **MCP Server Guide**: [mcp-server-guide.md](mcp-server-guide.md) - MCP-specific diagnostics - **MCP Server Guide**: [mcp-server-guide.md](./mcp-server-guide.md) - MCP-specific diagnostics
- **Installation Guide**: [../Getting-Started/installation.md](../Getting-Started/installation.md) - Setup procedures - **Installation Guide**: [../Getting-Started/installation.md](../Getting-Started/installation.md) - Setup procedures
- **User Guide**: [../User-Guide/](../User-Guide/) - Operational documentation - **User Guide**: [../User-Guide/](../User-Guide/) - Operational documentation

62
Docs/Reference/examples-cookbook.md
View File

@ -6,7 +6,7 @@
## Recipe Collections Overview ## Recipe Collections Overview
### [Basic Examples Collection](basic-examples.md) ### [Basic Examples Collection](./basic-examples.md)
**Essential commands and single-agent workflows** **Essential commands and single-agent workflows**
- Copy-paste ready commands for immediate use - Copy-paste ready commands for immediate use
- Essential SuperClaude patterns and fundamentals - Essential SuperClaude patterns and fundamentals
@ -15,7 +15,7 @@
**Best for**: New users, quick task execution, learning fundamentals **Best for**: New users, quick task execution, learning fundamentals
### [Advanced Workflows Collection](advanced-workflows.md) ### [Advanced Workflows Collection](./advanced-workflows.md)
**Multi-agent coordination and complex orchestration** **Multi-agent coordination and complex orchestration**
- Multi-agent collaboration patterns - Multi-agent collaboration patterns
- Enterprise-scale project workflows - Enterprise-scale project workflows
@ -24,7 +24,7 @@
**Best for**: Experienced users, enterprise projects, complex coordination **Best for**: Experienced users, enterprise projects, complex coordination
### [Integration Patterns Collection](integration-patterns.md) ### [Integration Patterns Collection](./integration-patterns.md)
**Framework integration and cross-tool coordination** **Framework integration and cross-tool coordination**
- Framework-specific integration patterns - Framework-specific integration patterns
- Performance optimization recipes - Performance optimization recipes
@ -37,40 +37,40 @@
### By Experience Level ### By Experience Level
**Beginner (Week 1-2)** **Beginner (Week 1-2)**
→ Start with [Basic Examples](basic-examples.md) → Start with [Basic Examples](./basic-examples.md)
- Essential commands and patterns - Essential commands and patterns
- Simple troubleshooting workflows - Simple troubleshooting workflows
- Copy-paste solutions for common tasks - Copy-paste solutions for common tasks
**Intermediate (Week 3-6)** **Intermediate (Week 3-6)**
→ Progress to [Advanced Workflows](advanced-workflows.md) → Progress to [Advanced Workflows](./advanced-workflows.md)
- Multi-agent coordination - Multi-agent coordination
- Complex project orchestration - Complex project orchestration
- Session management patterns - Session management patterns
**Expert (Month 2+)** **Expert (Month 2+)**
→ Master [Integration Patterns](integration-patterns.md) → Master [Integration Patterns](./integration-patterns.md)
- Framework integration strategies - Framework integration strategies
- Performance optimization recipes - Performance optimization recipes
- Enterprise-scale architecture patterns - Enterprise-scale architecture patterns
### By Use Case ### By Use Case
**Web Development** **Web Development**
- Frontend: [Basic Examples](basic-examples.md#frontend-component-development) → [Integration Patterns](integration-patterns.md#react-ecosystem-integration) - Frontend: [Basic Examples](./basic-examples.md#frontend-component-development) → [Integration Patterns](./integration-patterns.md#react-ecosystem-integration)
- Backend: [Basic Examples](basic-examples.md#api-development-basics) → [Integration Patterns](integration-patterns.md#nodejs-backend-integration) - Backend: [Basic Examples](./basic-examples.md#api-development-basics) → [Integration Patterns](./integration-patterns.md#nodejs-backend-integration)
- Full-Stack: [Advanced Workflows](advanced-workflows.md#complete-e-commerce-platform-development) - Full-Stack: [Advanced Workflows](./advanced-workflows.md#complete-e-commerce-platform-development)
**Mobile Development** **Mobile Development**
- React Native: [Basic Examples](basic-examples.md#copy-paste-quick-solutions) → [Integration Patterns](integration-patterns.md#mobile-and-web-integration) - React Native: [Basic Examples](./basic-examples.md#copy-paste-quick-solutions) → [Integration Patterns](./integration-patterns.md#mobile-and-web-integration)
- Cross-Platform: [Integration Patterns](integration-patterns.md#cross-platform-integration-patterns) - Cross-Platform: [Integration Patterns](./integration-patterns.md#cross-platform-integration-patterns)
**DevOps & Infrastructure** **DevOps & Infrastructure**
- CI/CD: [Basic Examples](basic-examples.md#copy-paste-quick-solutions) → [Integration Patterns](integration-patterns.md#devops-and-infrastructure-integration) - CI/CD: [Basic Examples](./basic-examples.md#copy-paste-quick-solutions) → [Integration Patterns](./integration-patterns.md#devops-and-infrastructure-integration)
- Monitoring: [Advanced Workflows](advanced-workflows.md#advanced-monitoring-and-observability) → [Integration Patterns](integration-patterns.md#monitoring-and-observability-patterns) - Monitoring: [Advanced Workflows](./advanced-workflows.md#advanced-monitoring-and-observability) → [Integration Patterns](./integration-patterns.md#monitoring-and-observability-patterns)
**Performance & Security** **Performance & Security**
- Security: [Basic Examples](basic-examples.md#basic-troubleshooting-examples) → [Advanced Workflows](advanced-workflows.md#enterprise-scale-security-implementation) - Security: [Basic Examples](./basic-examples.md#basic-troubleshooting-examples) → [Advanced Workflows](./advanced-workflows.md#enterprise-scale-security-implementation)
- Performance: [Integration Patterns](integration-patterns.md#performance-optimization-recipes) - Performance: [Integration Patterns](./integration-patterns.md#performance-optimization-recipes)
## Verified Commands Reference ## Verified Commands Reference
@ -96,20 +96,20 @@
### Phase 1: Foundation (Week 1-2) ### Phase 1: Foundation (Week 1-2)
1. **Setup**: Complete [Installation Guide](../Getting-Started/installation.md) 1. **Setup**: Complete [Installation Guide](../Getting-Started/installation.md)
2. **Basics**: Practice [Basic Examples](basic-examples.md#essential-one-liner-commands) 2. **Basics**: Practice [Basic Examples](./basic-examples.md#essential-one-liner-commands)
3. **Patterns**: Learn [Basic Usage Patterns](basic-examples.md#basic-usage-patterns) 3. **Patterns**: Learn [Basic Usage Patterns](./basic-examples.md#basic-usage-patterns)
4. **Success**: Can execute common development tasks independently 4. **Success**: Can execute common development tasks independently
### Phase 2: Coordination (Week 3-6) ### Phase 2: Coordination (Week 3-6)
1. **Agents**: Understand [Multi-Agent Patterns](advanced-workflows.md#multi-agent-collaboration-patterns) 1. **Agents**: Understand [Multi-Agent Patterns](./advanced-workflows.md#multi-agent-collaboration-patterns)
2. **Workflows**: Practice [Complex Project Workflows](advanced-workflows.md#complex-project-workflows) 2. **Workflows**: Practice [Complex Project Workflows](./advanced-workflows.md#complex-project-workflows)
3. **Orchestration**: Master [Advanced Orchestration](advanced-workflows.md#advanced-orchestration-patterns) 3. **Orchestration**: Master [Advanced Orchestration](./advanced-workflows.md#advanced-orchestration-patterns)
4. **Success**: Can coordinate complex multi-step projects 4. **Success**: Can coordinate complex multi-step projects
### Phase 3: Integration (Month 2+) ### Phase 3: Integration (Month 2+)
1. **Frameworks**: Learn [Framework Integration](integration-patterns.md#framework-integration-patterns) 1. **Frameworks**: Learn [Framework Integration](./integration-patterns.md#framework-integration-patterns)
2. **Performance**: Master [Optimization Recipes](integration-patterns.md#performance-optimization-recipes) 2. **Performance**: Master [Optimization Recipes](./integration-patterns.md#performance-optimization-recipes)
3. **Troubleshooting**: Advanced [Debugging Workflows](integration-patterns.md#advanced-troubleshooting-workflows) 3. **Troubleshooting**: Advanced [Debugging Workflows](./integration-patterns.md#advanced-troubleshooting-workflows)
4. **Success**: Can integrate SuperClaude with any development stack 4. **Success**: Can integrate SuperClaude with any development stack
### Phase 4: Expertise (Month 3+) ### Phase 4: Expertise (Month 3+)
@ -122,11 +122,11 @@
| Task Type | Beginner | Intermediate | Expert | | Task Type | Beginner | Intermediate | Expert |
|-----------|----------|--------------|--------| |-----------|----------|--------------|--------|
| **Analysis** | [Basic Analysis](basic-examples.md#quick-analysis-commands) | [Multi-Agent Analysis](advanced-workflows.md#performance-optimization-team) | [Integration Analysis](integration-patterns.md#distributed-system-debugging) | | **Analysis** | [Basic Analysis](./basic-examples.md#quick-analysis-commands) | [Multi-Agent Analysis](./advanced-workflows.md#performance-optimization-team) | [Integration Analysis](./integration-patterns.md#distributed-system-debugging) |
| **Implementation** | [Simple Features](basic-examples.md#simple-feature-implementation) | [Complex Projects](advanced-workflows.md#complex-project-workflows) | [Framework Integration](integration-patterns.md#framework-integration-patterns) | | **Implementation** | [Simple Features](./basic-examples.md#simple-feature-implementation) | [Complex Projects](./advanced-workflows.md#complex-project-workflows) | [Framework Integration](./integration-patterns.md#framework-integration-patterns) |
| **Testing** | [Basic Testing](basic-examples.md#copy-paste-quick-solutions) | [Comprehensive Testing](advanced-workflows.md#advanced-workflows) | [Testing Integration](integration-patterns.md#advanced-testing-integration) | | **Testing** | [Basic Testing](./basic-examples.md#copy-paste-quick-solutions) | [Comprehensive Testing](./advanced-workflows.md#advanced-workflows) | [Testing Integration](./integration-patterns.md#advanced-testing-integration) |
| **Troubleshooting** | [Common Issues](basic-examples.md#basic-troubleshooting-examples) | [System Debugging](advanced-workflows.md#advanced-workflows) | [Distributed Debugging](integration-patterns.md#advanced-troubleshooting-workflows) | | **Troubleshooting** | [Common Issues](./basic-examples.md#basic-troubleshooting-examples) | [System Debugging](./advanced-workflows.md#advanced-workflows) | [Distributed Debugging](./integration-patterns.md#advanced-troubleshooting-workflows) |
| **Performance** | [Basic Optimization](basic-examples.md#quick-quality-improvements) | [System Optimization](advanced-workflows.md#performance-optimization-strategies) | [Expert Optimization](integration-patterns.md#performance-optimization-recipes) | | **Performance** | [Basic Optimization](./basic-examples.md#quick-quality-improvements) | [System Optimization](./advanced-workflows.md#performance-optimization-strategies) | [Expert Optimization](./integration-patterns.md#performance-optimization-recipes) |
## Success Milestones ## Success Milestones
@ -154,7 +154,7 @@
- [Commands Reference](../User-Guide/commands.md) - Complete command documentation - [Commands Reference](../User-Guide/commands.md) - Complete command documentation
- [Agents Guide](../User-Guide/agents.md) - Multi-agent coordination - [Agents Guide](../User-Guide/agents.md) - Multi-agent coordination
- [MCP Servers](../User-Guide/mcp-servers.md) - Enhanced capabilities - [MCP Servers](../User-Guide/mcp-servers.md) - Enhanced capabilities
- [Best Practices](quick-start-practices.md) - Optimization strategies - [Best Practices](./quick-start-practices.md) - Optimization strategies
**Community**: **Community**:
- [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community support - [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community support
@ -163,10 +163,10 @@
**Advanced**: **Advanced**:
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding - [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding
- [Troubleshooting Guide](troubleshooting.md) - Common issues and solutions - [Troubleshooting Guide](./troubleshooting.md) - Common issues and solutions
--- ---
**Your Journey**: Start with [Basic Examples](basic-examples.md), progress through [Advanced Workflows](advanced-workflows.md), and master [Integration Patterns](integration-patterns.md). SuperClaude grows with you from simple commands to sophisticated development orchestration. **Your Journey**: Start with [Basic Examples](./basic-examples.md), progress through [Advanced Workflows](./advanced-workflows.md), and master [Integration Patterns](./integration-patterns.md). SuperClaude grows with you from simple commands to sophisticated development orchestration.
**Remember**: Every expert was once a beginner. Focus on practical application, experiment with different approaches, and leverage the community for support and learning. **Remember**: Every expert was once a beginner. Focus on practical application, experiment with different approaches, and leverage the community for support and learning.

4
Docs/Reference/mcp-server-guide.md
View File

@ -729,8 +729,8 @@ echo "Test MCP servers in Claude Code after restart"
### MCP-Specific Documentation ### MCP-Specific Documentation
- **Core SuperClaude Guide**: [../User-Guide/mcp-servers.md](../User-Guide/mcp-servers.md) - MCP server overview and usage - **Core SuperClaude Guide**: [../User-Guide/mcp-servers.md](../User-Guide/mcp-servers.md) - MCP server overview and usage
- **Common Issues**: [common-issues.md](common-issues.md) - General troubleshooting procedures - **Common Issues**: [common-issues.md](./common-issues.md) - General troubleshooting procedures
- **Diagnostic Reference**: [diagnostic-reference.md](diagnostic-reference.md) - Advanced diagnostic procedures - **Diagnostic Reference**: [diagnostic-reference.md](./diagnostic-reference.md) - Advanced diagnostic procedures
### External Resources ### External Resources
- **Node.js Official**: [https://nodejs.org/](https://nodejs.org/) - Node.js installation and documentation - **Node.js Official**: [https://nodejs.org/](https://nodejs.org/) - Node.js installation and documentation

6
Docs/Reference/optimization-guide.md
View File

@ -22,8 +22,8 @@
- [Recovery Strategies](#recovery-strategies) - Issue resolution and optimization - [Recovery Strategies](#recovery-strategies) - Issue resolution and optimization
### See Also ### See Also
- [Quick Start Practices](quick-start-practices.md) - Foundation skills and basic workflows - [Quick Start Practices](./quick-start-practices.md) - Foundation skills and basic workflows
- [Advanced Patterns](advanced-patterns.md) - Multi-agent coordination and expert techniques - [Advanced Patterns](./advanced-patterns.md) - Multi-agent coordination and expert techniques
## Speed and Efficiency Strategies ## Speed and Efficiency Strategies
@ -745,7 +745,7 @@ Optimize your SuperClaude usage with these advanced strategies:
**Learn from Others:** **Learn from Others:**
- [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community optimization sharing - [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community optimization sharing
- [Examples Cookbook](examples-cookbook.md) - Optimization examples and patterns - [Examples Cookbook](./examples-cookbook.md) - Optimization examples and patterns
--- ---

14
Docs/Reference/quick-start-practices.md
View File

@ -18,8 +18,8 @@
- [Common Quick Fixes](#common-quick-fixes) - Immediate problem resolution - [Common Quick Fixes](#common-quick-fixes) - Immediate problem resolution
### See Also ### See Also
- [Advanced Patterns](advanced-patterns.md) - Multi-agent coordination and expert techniques - [Advanced Patterns](./advanced-patterns.md) - Multi-agent coordination and expert techniques
- [Optimization Guide](optimization-guide.md) - Performance and efficiency strategies - [Optimization Guide](./optimization-guide.md) - Performance and efficiency strategies
## Getting Started Right ## Getting Started Right
@ -617,11 +617,11 @@ For detailed flag documentation, see [Flags Guide](../User-Guide/flags.md).
Once you've mastered these quick start practices, explore more advanced capabilities: Once you've mastered these quick start practices, explore more advanced capabilities:
**Intermediate Level:** **Intermediate Level:**
- [Advanced Patterns](advanced-patterns.md) - Multi-agent coordination and complex workflows - [Advanced Patterns](./advanced-patterns.md) - Multi-agent coordination and complex workflows
- [Examples Cookbook](examples-cookbook.md) - Real-world scenario practice - [Examples Cookbook](./examples-cookbook.md) - Real-world scenario practice
**Advanced Level:** **Advanced Level:**
- [Optimization Guide](optimization-guide.md) - Performance and efficiency mastery - [Optimization Guide](./optimization-guide.md) - Performance and efficiency mastery
- [MCP Servers Guide](../User-Guide/mcp-servers.md) - Enhanced tool integration - [MCP Servers Guide](../User-Guide/mcp-servers.md) - Enhanced tool integration
**Expert Level:** **Expert Level:**
@ -632,10 +632,10 @@ Once you've mastered these quick start practices, explore more advanced capabili
**Learning Support:** **Learning Support:**
- [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community help and tips - [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community help and tips
- [Troubleshooting Guide](troubleshooting.md) - Common issue resolution - [Troubleshooting Guide](./troubleshooting.md) - Common issue resolution
**Practice Materials:** **Practice Materials:**
- [Examples Cookbook](examples-cookbook.md) - Copy-paste solutions for common scenarios - [Examples Cookbook](./examples-cookbook.md) - Copy-paste solutions for common scenarios
- [User Guide](../User-Guide/) - Comprehensive feature documentation - [User Guide](../User-Guide/) - Comprehensive feature documentation
--- ---

22
Docs/Reference/troubleshooting.md
View File

@ -1,16 +1,16 @@
# SuperClaude Troubleshooting Guide # SuperClaude Troubleshooting Guide
> **Need a Quick Fix?** For the top 10 most common issues with rapid 2-minute solutions, see the [Common Issues Quick Reference](common-issues.md) first. > **Need a Quick Fix?** For the top 10 most common issues with rapid 2-minute solutions, see the [Common Issues Quick Reference](./common-issues.md) first.
> **Command Context**: This guide covers both **Terminal Commands** (for installation issues) and **Claude Code Commands** (`/sc:` for development issues). Look for section headers to know which type to use. > **Command Context**: This guide covers both **Terminal Commands** (for installation issues) and **Claude Code Commands** (`/sc:` for development issues). Look for section headers to know which type to use.
**Comprehensive Problem Resolution**: Step-by-step solutions for complex SuperClaude issues, from installation problems to advanced configuration challenges. Each solution includes diagnosis steps, resolution procedures, and prevention strategies. **Comprehensive Problem Resolution**: Step-by-step solutions for complex SuperClaude issues, from installation problems to advanced configuration challenges. Each solution includes diagnosis steps, resolution procedures, and prevention strategies.
**When to Use This Guide**: Use this comprehensive guide when the [quick fixes](common-issues.md) don't resolve your issue, or when you need detailed diagnosis and prevention strategies. **When to Use This Guide**: Use this comprehensive guide when the [quick fixes](./common-issues.md) don't resolve your issue, or when you need detailed diagnosis and prevention strategies.
## Installation Issues ## Installation Issues
> **🚀 Quick Fix**: For common installation problems like permission denied, Python version issues, or component failures, try the [Common Issues Quick Reference](common-issues.md#top-10-quick-fixes) first. > **🚀 Quick Fix**: For common installation problems like permission denied, Python version issues, or component failures, try the [Common Issues Quick Reference](./common-issues.md#top-10-quick-fixes) first.
### Advanced Installation Diagnosis ### Advanced Installation Diagnosis
@ -140,7 +140,7 @@ pip install --user SuperClaude
## Command Issues ## Command Issues
> **🚀 Quick Fix**: For command recognition problems, timeouts, or basic execution issues, try the [Common Issues Quick Reference](common-issues.md#4--commands-not-working-in-claude-code) first. > **🚀 Quick Fix**: For command recognition problems, timeouts, or basic execution issues, try the [Common Issues Quick Reference](./common-issues.md#4--commands-not-working-in-claude-code) first.
### Advanced Command Diagnosis ### Advanced Command Diagnosis
@ -386,7 +386,7 @@ echo "Requirements: vague project, needs discovery"
## MCP Server Issues ## MCP Server Issues
> **🚀 Quick Fix**: For Node.js missing or MCP connection problems, see [Common Issues Quick Reference](common-issues.md#8--nodejs-missing-for-mcp-servers) for rapid solutions. > **🚀 Quick Fix**: For Node.js missing or MCP connection problems, see [Common Issues Quick Reference](./common-issues.md#8--nodejs-missing-for-mcp-servers) for rapid solutions.
### Advanced MCP Diagnosis ### Advanced MCP Diagnosis
@ -750,7 +750,7 @@ python3 -m SuperClaude install --components core agents modes
## Performance Issues ## Performance Issues
> **🚀 Quick Fix**: For memory errors or resource issues, see [Common Issues Quick Reference](common-issues.md#9--memoryresource-errors) for immediate solutions. > **🚀 Quick Fix**: For memory errors or resource issues, see [Common Issues Quick Reference](./common-issues.md#9--memoryresource-errors) for immediate solutions.
### Advanced Performance Optimization ### Advanced Performance Optimization
@ -1024,7 +1024,7 @@ cat ~/.claude/CLAUDE.md | head -20
3. **Documentation** (Self-Service) 3. **Documentation** (Self-Service)
- Installation Guide: [../Getting-Started/installation.md](../Getting-Started/installation.md) - Installation Guide: [../Getting-Started/installation.md](../Getting-Started/installation.md)
- Troubleshooting: This guide - Troubleshooting: This guide
- Examples: [examples-cookbook.md](examples-cookbook.md) - Examples: [examples-cookbook.md](./examples-cookbook.md)
**Community Support:** **Community Support:**
- Community-maintained FAQ and tips - Community-maintained FAQ and tips
@ -1195,8 +1195,8 @@ time /sc:analyze . --scope module # Module-scoped analysis
- [Behavioral Modes](../User-Guide/modes.md) - Mode selection and behavioral troubleshooting - [Behavioral Modes](../User-Guide/modes.md) - Mode selection and behavioral troubleshooting
**Advanced Topics:** **Advanced Topics:**
- [Examples Cookbook](examples-cookbook.md) - Working examples and practical troubleshooting scenarios - [Examples Cookbook](./examples-cookbook.md) - Working examples and practical troubleshooting scenarios
- [Best Practices](quick-start-practices.md) - Performance optimization and efficiency troubleshooting - [Best Practices](./quick-start-practices.md) - Performance optimization and efficiency troubleshooting
- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding for complex issues - [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding for complex issues
### Developer Resources ### Developer Resources
@ -1215,12 +1215,12 @@ time /sc:analyze . --scope module # Module-scoped analysis
**Immediate Help:** **Immediate Help:**
- Installation Issues → [Installation Guide](../Getting-Started/installation.md) - Installation Issues → [Installation Guide](../Getting-Started/installation.md)
- Command Problems → [Commands Reference](../User-Guide/commands.md) - Command Problems → [Commands Reference](../User-Guide/commands.md)
- Performance Issues → [Best Practices](quick-start-practices.md) - Performance Issues → [Best Practices](./quick-start-practices.md)
- Configuration Issues → [MCP Servers](../User-Guide/mcp-servers.md) - Configuration Issues → [MCP Servers](../User-Guide/mcp-servers.md)
**Learning Resources:** **Learning Resources:**
- New Users → [Quick Start Guide](../Getting-Started/quick-start.md) - New Users → [Quick Start Guide](../Getting-Started/quick-start.md)
- Practical Examples → [Examples Cookbook](examples-cookbook.md) - Practical Examples → [Examples Cookbook](./examples-cookbook.md)
- Advanced Usage → [Technical Architecture](../Developer-Guide/technical-architecture.md) - Advanced Usage → [Technical Architecture](../Developer-Guide/technical-architecture.md)
--- ---