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

@@ -25,7 +25,7 @@ The SuperClaude Framework features 13 specialized domain expert agents that auto
/brainstorm "task manager app" # → Requirements analyst guides discovery
```
**See the pattern?** You focus on what you want to do, SuperClaude figures out who should help.
**See the pattern?** You focus on what you want to do, SuperClaude figures out who should help. See [Examples Cookbook](examples-cookbook.md) for many more examples like these.
---
@@ -518,4 +518,30 @@ Agents seamlessly integrate with SuperClaude's command system:
---
## Related Guides
**🚀 Getting Started (Essential)**
- [SuperClaude User Guide](superclaude-user-guide.md) - Framework overview and philosophy
- [Examples Cookbook](examples-cookbook.md) - See agents in action with real examples
**🛠️ Working with Agents (Recommended)**
- [Commands Guide](commands-guide.md) - Commands that activate specific agents
- [Behavioral Modes Guide](behavioral-modes-guide.md) - How agents work within different modes
- [Session Management Guide](session-management.md) - Agent coordination across sessions
**⚙️ Control and Optimization (Advanced)**
- [Flags Guide](flags-guide.md) - Manual agent control with --agent flags
- [Best Practices Guide](best-practices.md) - Proven patterns for agent coordination
- [Technical Architecture Guide](technical-architecture.md) - Agent system implementation
**🔧 When Things Go Wrong**
- [Troubleshooting Guide](troubleshooting-guide.md) - Agent activation and coordination issues
**📖 Recommended Learning Path:**
1. [Examples Cookbook](examples-cookbook.md) - See auto-activation in action
2. [Commands Guide](commands-guide.md) - Understand agent triggers
3. [Best Practices Guide](best-practices.md) - Master agent coordination patterns
---
*Behind this sophisticated team of 13 specialists, the SuperClaude Framework remains simple to use. Just start coding and the right experts show up when needed! 🚀*