Restructure documentation: Create focused guide ecosystem from oversized user guide

- Transform 28K+ token superclaude-user-guide.md into 4.5K token overview (84% reduction)
- Extract specialized guides: examples-cookbook.md, troubleshooting-guide.md, best-practices.md, session-management.md, technical-architecture.md
- Add comprehensive cross-references between all guides for improved navigation
- Maintain professional documentation quality with technical-writer agent approach
- Remove template files and consolidate agent naming (backend-engineer → backend-architect, etc.)
- Update all existing guides with cross-references and related guides sections
- Create logical learning paths from beginner to advanced users
- Eliminate content duplication while preserving all valuable information

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
2025-08-15 21:30:29 +02:00
parent 9a5e2a01ff
commit 40840dae0b
91 changed files with 7666 additions and 15055 deletions

View File

@@ -38,7 +38,7 @@
/sc:improve --uc legacy-code/ # → Uses symbols, abbreviations, stays clear
```
**See the pattern?** You just say what you want to do. SuperClaude figures out the best way to help. The modes are the "how" - you focus on the "what". 🎯
**See the pattern?** You just say what you want to do. SuperClaude figures out the best way to help. The modes are the "how" - you focus on the "what". See [Examples Cookbook](examples-cookbook.md) for more working examples. 🎯
---
@@ -688,8 +688,26 @@ Modes determine the behavioral approach, agents provide domain expertise. A secu
---
**Related Guides:**
- 🤖 [Agent System Guide](agents-guide.md) - Understanding the 13 specialized agents
- 🛠️ [Commands Guide](commands-guide.md) - All 21 commands with mode integration
- 🏳️ [Flags Guide](flags-guide.md) - Manual mode control and behavioral flags
- 📖 [SuperClaude User Guide](superclaude-user-guide.md) - Complete framework overview
## Related Guides
**🚀 Getting Started (Essential)**
- [SuperClaude User Guide](superclaude-user-guide.md) - Framework overview and philosophy
- [Examples Cookbook](examples-cookbook.md) - See modes in action with real examples
**🛠️ Working with Modes (Recommended)**
- [Commands Guide](commands-guide.md) - Commands that trigger different modes
- [Agents Guide](agents-guide.md) - How agents work within different modes
- [Session Management Guide](session-management.md) - Mode persistence across sessions
**⚙️ Control and Optimization (Advanced)**
- [Flags Guide](flags-guide.md) - Manual mode control with flags like --brainstorm, --uc
- [Best Practices Guide](best-practices.md) - Proven patterns for mode utilization
- [Technical Architecture Guide](technical-architecture.md) - Mode detection and activation system
**🔧 When Modes Don't Work as Expected**
- [Troubleshooting Guide](troubleshooting-guide.md) - Mode activation and behavioral issues
**📖 Recommended Learning Path:**
1. [Examples Cookbook](examples-cookbook.md) - See auto-activation in practice
2. [Commands Guide](commands-guide.md) - Understand mode triggers
3. [Best Practices Guide](best-practices.md) - Master mode coordination patterns