Standardize internal markdown references with explicit relative paths

• 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

View File

@@ -6,7 +6,7 @@
## Recipe Collections Overview
### [Basic Examples Collection](basic-examples.md)
### [Basic Examples Collection](./basic-examples.md)
**Essential commands and single-agent workflows**
- Copy-paste ready commands for immediate use
- Essential SuperClaude patterns and fundamentals
@@ -15,7 +15,7 @@
**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 collaboration patterns
- Enterprise-scale project workflows
@@ -24,7 +24,7 @@
**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-specific integration patterns
- Performance optimization recipes
@@ -37,40 +37,40 @@
### By Experience Level
**Beginner (Week 1-2)**
→ Start with [Basic Examples](basic-examples.md)
→ Start with [Basic Examples](./basic-examples.md)
- Essential commands and patterns
- Simple troubleshooting workflows
- Copy-paste solutions for common tasks
**Intermediate (Week 3-6)**
→ Progress to [Advanced Workflows](advanced-workflows.md)
→ Progress to [Advanced Workflows](./advanced-workflows.md)
- Multi-agent coordination
- Complex project orchestration
- Session management patterns
**Expert (Month 2+)**
→ Master [Integration Patterns](integration-patterns.md)
→ Master [Integration Patterns](./integration-patterns.md)
- Framework integration strategies
- Performance optimization recipes
- Enterprise-scale architecture patterns
### By Use Case
**Web Development**
- 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)
- Full-Stack: [Advanced Workflows](advanced-workflows.md#complete-e-commerce-platform-development)
- 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)
- Full-Stack: [Advanced Workflows](./advanced-workflows.md#complete-e-commerce-platform-development)
**Mobile Development**
- 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)
- 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)
**DevOps & Infrastructure**
- 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)
- 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)
**Performance & Security**
- 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)
- 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)
## Verified Commands Reference
@@ -96,20 +96,20 @@
### Phase 1: Foundation (Week 1-2)
1. **Setup**: Complete [Installation Guide](../Getting-Started/installation.md)
2. **Basics**: Practice [Basic Examples](basic-examples.md#essential-one-liner-commands)
3. **Patterns**: Learn [Basic Usage Patterns](basic-examples.md#basic-usage-patterns)
2. **Basics**: Practice [Basic Examples](./basic-examples.md#essential-one-liner-commands)
3. **Patterns**: Learn [Basic Usage Patterns](./basic-examples.md#basic-usage-patterns)
4. **Success**: Can execute common development tasks independently
### Phase 2: Coordination (Week 3-6)
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)
3. **Orchestration**: Master [Advanced Orchestration](advanced-workflows.md#advanced-orchestration-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)
3. **Orchestration**: Master [Advanced Orchestration](./advanced-workflows.md#advanced-orchestration-patterns)
4. **Success**: Can coordinate complex multi-step projects
### Phase 3: Integration (Month 2+)
1. **Frameworks**: Learn [Framework Integration](integration-patterns.md#framework-integration-patterns)
2. **Performance**: Master [Optimization Recipes](integration-patterns.md#performance-optimization-recipes)
3. **Troubleshooting**: Advanced [Debugging Workflows](integration-patterns.md#advanced-troubleshooting-workflows)
1. **Frameworks**: Learn [Framework Integration](./integration-patterns.md#framework-integration-patterns)
2. **Performance**: Master [Optimization Recipes](./integration-patterns.md#performance-optimization-recipes)
3. **Troubleshooting**: Advanced [Debugging Workflows](./integration-patterns.md#advanced-troubleshooting-workflows)
4. **Success**: Can integrate SuperClaude with any development stack
### Phase 4: Expertise (Month 3+)
@@ -122,11 +122,11 @@
| 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) |
| **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) |
| **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) |
| **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) |
| **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) |
| **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
@@ -154,7 +154,7 @@
- [Commands Reference](../User-Guide/commands.md) - Complete command documentation
- [Agents Guide](../User-Guide/agents.md) - Multi-agent coordination
- [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**:
- [GitHub Discussions](https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions) - Community support
@@ -163,10 +163,10 @@
**Advanced**:
- [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.