mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
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:
@@ -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
|
||||
Reference in New Issue
Block a user