refactor: Standardize @include reference system across all command files

- Fix @include references to use underscore format (Universal_Legend, Standard_Messages_Templates)
- Add missing ultracompressed.yml shared pattern file
- Update broken reference paths in all 18 command files
- Ensure consistent template naming across command system
- Optimize command file structure with standardized includes

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
2025-06-25 00:21:27 +02:00
parent 219ff3905a
commit 23a103d5dc
36 changed files with 3139 additions and 1375 deletions

408
README.md
View File

@@ -1,31 +1,32 @@
# Meet SuperClaude The Missing Power-Up for Claude Code
# SuperClaude The Professional Development Framework for Claude Code
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](https://github.com/NomenAK/SuperClaude)
[![GitHub issues](https://img.shields.io/github/issues/NomenAK/SuperClaude)](https://github.com/NomenAK/SuperClaude/issues)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/NomenAK/SuperClaude/blob/master/CONTRIBUTING.md)
**A lightweight framework that transforms generic Claude Code into your specialized development partner no external tools, no complex setup, just pure configuration magic.**
**A sophisticated configuration framework that transforms Claude Code into a specialized, token-efficient development partner with 18 professional commands, 9 cognitive personas, and evidence-based methodology.**
> **New in v4.0.0**: Template reference system achieves significant efficiency improvements with @pattern includes and validation system
## 🎯 The Professional Problem
## 🎯 The Problem
Claude Code is powerful, but lacks specialization. Development teams need:
- **Consistent expertise** across different technical domains
- **Token efficiency** for complex, long-running projects
- **Evidence-based standards** instead of generic suggestions
- **Context preservation** during multi-session debugging
- **Specialized thinking modes** for architecture, security, performance
Claude Code is powerful, but let's be honest it's generic. You find yourself:
- Losing context mid-debugging session
- Repeating the same instructions every project
- Wishing it understood YOUR coding style
- Watching tokens vanish on verbose responses
## ✨ The SuperClaude Solution
## ✨ Enter SuperClaude
SuperClaude transforms Claude Code into a professional development framework with:
- **18 Specialized Commands** covering the complete development lifecycle
- **9 Cognitive Personas** for domain-specific expertise
- **Advanced Token Optimization** with 70% reduction capabilities
- **Evidence-Based Methodology** requiring documentation and metrics
- **Professional MCP Integration** with Context7, Sequential, Magic, Puppeteer
- **Git-Integrated Checkpoints** for safe experimentation
Think of it as a brain upgrade for Claude Code. Drop it in once, and suddenly Claude:
- **Remembers everything** with Git-based checkpoints
- **Thinks like you want** with 9 specialized personas
- **Works significantly more efficiently** with @pattern template system (v4.0.0)
- **Never guesses** always finds the official docs first
## 🚀 Zero-Friction Install
## 🚀 Professional Installation
```bash
git clone https://github.com/NomenAK/SuperClaude.git
@@ -36,220 +37,295 @@ cd SuperClaude
./install.sh --dir ./project-claude # Project-specific
```
That's it. No databases, no services, no dependencies. Installs to `~/.claude/` by default or any directory you choose. The installer even backs up your existing config automatically!
Zero dependencies. Installs to `~/.claude/` by default. The installer automatically backs up existing configurations and validates the installation.
## 💡 Why You'll Love It
## 💡 Core Capabilities
### 🔄 **Never Lose Context Again**
Git-integrated checkpoint system lets you jump back to any point in your conversation. Debugging a nasty bug at 3am? Create a checkpoint. Need to try a different approach? Roll back and branch off.
### 📚 **Smart Documentation That Evolves**
Your docs write themselves using our token-optimized templates. Project docs go in `/docs`, while Claude's working notes live in `/.claudedocs`. Everything stays organized, nothing gets lost.
### 🎭 **9 Instant Personas**
Switch Claude's entire mindset with persona flags:
### 🧠 **Cognitive Personas**
Switch Claude's entire professional mindset:
```bash
/analyze --persona-architect # Big-picture system design mode
/build --persona-frontend # Pixel-perfect UI obsession mode
/scan --persona-security # Paranoid threat-modeling mode
/troubleshoot --persona-analyzer # Sherlock Holmes debugging mode
/analyze --persona-architect # Systems thinking, scalability focus
/build --persona-frontend # UX-obsessed, accessibility-first
/scan --persona-security # Threat modeling, zero-trust
/troubleshoot --persona-analyzer # Evidence-based root cause analysis
```
Each persona thinks differently, asks different questions, and solves problems their own way.
Each persona brings specialized knowledge, different priorities, and domain-specific best practices.
### ⚡ **18 Power Commands**
Real shortcuts for real work:
### ⚡ **18 Professional Commands**
Complete development lifecycle coverage:
**Development Commands**
```bash
/build --react --magic # Spin up a React app with AI-generated components
/troubleshoot --prod # Production fire? This knows what to do
/analyze --security # Full security audit in seconds
/git --checkpoint # Save your progress before that risky refactor
/spawn --task "debug" # Launch specialized debugging agent
/build --react --magic --tdd # Full-stack development with AI components
/dev-setup --ci --monitor # Professional environment setup
/test --coverage --e2e --pup # Comprehensive testing strategies
```
### 🧠 **Actually Intelligent Integration**
- **Context7** finds library docs instantly (no more "I think this is how it works")
- **Sequential** thinking for complex problems (watch it reason step-by-step)
- **Magic** generates UI components that actually match your style
- **Puppeteer** tests everything in a real browser
**Analysis & Quality**
```bash
/analyze --architecture --seq # Deep system analysis
/troubleshoot --prod --five-whys # Production issue resolution
/improve --performance --iterate # Evidence-based optimization
/explain --depth expert --visual # Technical documentation
```
### 🚄 **Substantially More Efficient**
Our UltraCompressed mode strips unnecessary tokens without losing clarity. Plus, the new @pattern template system eliminates command duplication. More context, longer conversations, bigger projects same token budget.
**Operations & Security**
```bash
/deploy --env prod --plan # Safe production deployment
/scan --security --owasp --deps # Professional security audits
/migrate --dry-run --rollback # Safe database migrations
/cleanup --all --validate # Professional maintenance
```
## 🎮 Quick Start Examples
### 🎛️ **Advanced MCP Integration**
- **Context7**: Instant access to official library documentation
- **Sequential**: Multi-step reasoning for complex problems
- **Magic**: AI-generated UI components matching your patterns
- **Puppeteer**: Real browser testing and validation
### The "New Project" Flow
### 📊 **Token Efficiency Architecture**
SuperClaude's @include template system eliminates duplication:
- **70% token reduction** with UltraCompressed mode
- **Template reference validation** ensures system integrity
- **Smart caching** prevents redundant operations
- **Dynamic compression** based on context usage
## 🎮 Professional Workflows
### Enterprise Architecture Flow
```bash
--persona-architect
/design --api --ddd # Domain-driven design from the start
/estimate --detailed # Know what you're getting into
--persona-backend
/build --api --tdd # Build it right the first time
/design --api --ddd --bounded-context # Domain-driven design
/estimate --detailed --worst-case # Resource planning
--persona-security
/scan --security --validate # Security review
--persona-backend
/build --api --tdd --coverage # Professional implementation
```
### The "Something's Broken" Flow
### Production Issue Resolution
```bash
--persona-analyzer
/troubleshoot --investigate --prod
/analyze --profile # Find the real bottleneck
/troubleshoot --investigate --prod # Systematic analysis
/analyze --profile --perf # Performance bottlenecks
--persona-performance
/improve --performance --threshold high
/improve --performance --threshold 95% # Optimization targets
/test --integration --e2e # Validation testing
```
### The "Make It Pretty" Flow
### Full-Stack Feature Development
```bash
--persona-frontend
/build --react --magic # AI-generated components
/test --e2e --pup # See it work in a real browser
/improve --quality # Polish until it shines
/build --react --magic --watch # UI development
--persona-qa
/test --coverage --e2e --strict # Quality assurance
--persona-security
/scan --validate --deps # Security validation
```
## 🔧 How It Actually Works
## 🎭 Professional Personas
SuperClaude is pure configuration no code, no external dependencies. It works by:
| Persona | Expertise | Primary Tools | Best For |
|---------|-----------|---------------|----------|
| **architect** | System design, scalability | Sequential, Context7 | Architecture decisions |
| **frontend** | UX, accessibility, performance | Magic, Puppeteer, Context7 | User interfaces |
| **backend** | APIs, databases, reliability | Context7, Sequential | Server architecture |
| **security** | Threat modeling, compliance | Sequential, Context7 | Security audits |
| **analyzer** | Root cause, evidence-based | All MCP tools | Complex debugging |
| **qa** | Testing, edge cases, quality | Puppeteer, Context7 | Quality assurance |
| **performance** | Optimization, profiling | Puppeteer, Sequential | Performance tuning |
| **refactorer** | Code quality, maintainability | Sequential, Context7 | Code improvement |
| **mentor** | Learning, documentation | Context7, Sequential | Knowledge transfer |
1. **Loading specialized instructions** when Claude Code starts
2. **Activating different rulesets** based on your commands
3. **Switching cognitive modes** through personas
4. **Optimizing token usage** with @pattern templates & UltraCompressed mode
## 🛠️ Advanced Configuration
The framework includes:
- **CLAUDE.md** Core configuration and behaviors
- **RULES.md** Engineering standards and practices
- **PERSONAS.md** 9 specialized thinking modes
- **MCP.md** Smart tool orchestration
- **18 Commands** Ready-made workflows
- **25 Shared Resources** Battle-tested patterns
## 🎨 Pick Your Fighter (Persona)
| Persona | Superpower | Activate When You Need... |
|---------|------------|---------------------------|
| **architect** | Sees the big picture | System design that scales |
| **frontend** | UX perfectionist | Interfaces users love |
| **backend** | Performance obsessed | APIs that never fail |
| **security** | Professional paranoid | Code that's bulletproof |
| **analyzer** | Root cause detective | To solve the unsolvable |
| **qa** | Bug hunter supreme | Testing that catches everything |
| **performance** | Speed demon | Every millisecond to count |
| **refactorer** | Code beautifier | To simplify the complex |
| **mentor** | Patient teacher | To understand, not just copy |
## 🛠️ Advanced Features
### Thinking Modes
Control how deep Claude analyzes:
### Thinking Depth Control
```bash
"think about X" # Standard analysis
"think hard about Y" # Architecture-level depth
"ultrathink Z" # When you need EVERYTHING considered
# Standard analysis
/analyze --think "multi-file context"
# Architecture-level depth
/design --think-hard "comprehensive system analysis"
# Maximum analysis power
/troubleshoot --ultrathink "critical system debugging"
```
### Smart Tool Control
### Token Optimization Modes
```bash
--c7 # Force documentation lookup
--seq # Force step-by-step reasoning
--magic # Force UI component generation
--no-mcp # Use only native tools
--all-mcp # Kitchen sink mode
# Standard mode for complex operations
/build --react --magic
# UltraCompressed for large projects
/analyze --architecture --uc
# Force native tools only
/scan --security --no-mcp
```
### Evidence-Based Everything
No more "this is better" without proof. SuperClaude enforces:
- Metrics for performance claims
- Documentation for library usage (Context7 integration)
- Test results for quality assertions
- Security scans for safety claims
- Research-first methodology for external libraries
- Template reference validation system ensures integrity
### Evidence-Based Standards
SuperClaude enforces professional standards:
- **Performance claims** require benchmarks and metrics
- **Library usage** requires official documentation (Context7)
- **Security assertions** need validation scans
- **Quality improvements** need test coverage evidence
- **Architecture decisions** need scalability analysis
## 🤝 Community-Driven Development
## 📋 Complete Command Reference
SuperClaude is MIT-licensed and built by developers, for developers. We welcome:
- New personas for specialized workflows
- Commands that solve your daily pain points
- Patterns that make Claude Code smarter
- Ideas that push the boundaries
### Development (3 Commands)
- `/build` - Universal project builder with stack templates
- `/dev-setup` - Professional development environment
- `/test` - Comprehensive testing framework
Check out our [Contributing Guide](CONTRIBUTING.md) and join the conversation!
### Analysis & Improvement (4 Commands)
- `/analyze` - Multi-dimensional code and system analysis
- `/troubleshoot` - Professional debugging and issue resolution
- `/improve` - Evidence-based enhancement and optimization
- `/explain` - Technical documentation and knowledge transfer
## 📊 What Makes It Different?
### Operations (6 Commands)
- `/deploy` - Safe application deployment with rollback
- `/migrate` - Database and code migration management
- `/scan` - Security audits and validation
- `/estimate` - Project complexity and time estimation
- `/cleanup` - Professional project maintenance
- `/git` - Git workflow with checkpoint management
| Feature | Without SuperClaude | With SuperClaude |
|---------|-------------------|------------------|
| **Context** | Lost after errors | Git checkpoints preserve everything |
| **Personas** | Generic responses | Specialized thinking modes |
| **Tokens** | Verbose outputs | Substantial reduction, same information |
| **Docs** | "I think this works" | Always finds official sources |
| **Workflows** | Repeat instructions | One command, complete flow |
| **Quality** | Hope for the best | Evidence-based standards |
| **Templates** | Copy-paste commands | @pattern system eliminates duplication |
### Design & Workflow (5 Commands)
- `/design` - System architecture and API design
- `/spawn` - Parallel specialized agents
- `/document` - Professional documentation creation
- `/load` - Project context loading and analysis
## 🔮 Coming Soon
## 🔧 Technical Architecture
- VS Code extension for deeper integration
- Persona marketplace for community contributions
- Team sync for shared configurations
- Analytics dashboard (privacy-first)
SuperClaude implements professional development practices through:
## 💬 Real Developer Stories
**Configuration Framework**
- **CLAUDE.md** Core behavioral configuration
- **RULES.md** Engineering standards and practices
- **PERSONAS.md** Cognitive behavioral profiles
- **MCP.md** Tool orchestration and integration
> "I was debugging a production issue at 2am. Created a checkpoint, tried three different approaches, rolled back to the one that worked. Saved my sanity." *Backend Dev*
**Command System**
- **18 Specialized Commands** Complete development lifecycle
- **Flag Inheritance System** Consistent interface patterns
- **@include Templates** Token-efficient configuration
- **Validation Framework** Reference integrity checking
> "The frontend persona just *gets* UX. It asks questions I didn't even think of." *Full-Stack Dev*
**Quality Assurance**
- **Evidence-Based Standards** Metrics and documentation required
- **Research-First Methodology** Official sources for libraries
- **Error Recovery Patterns** Graceful failure handling
- **Professional Documentation** Structured output locations
> "Significant token reduction means I can keep entire codebases in context. The @pattern system is brilliant." *Tech Lead*
## 📊 Professional Advantages
## 🎯 Is SuperClaude For You?
| Capability | Standard Claude Code | SuperClaude Framework |
|------------|---------------------|----------------------|
| **Expertise** | Generic responses | 9 specialized cognitive personas |
| **Commands** | Manual instruction | 18 professional workflow commands |
| **Context** | Lost on errors | Git checkpoint preservation |
| **Tokens** | Standard verbosity | 70% reduction with same information |
| **Standards** | Hope for the best | Evidence-based methodology |
| **Documentation** | "I think this works" | Official source requirements |
| **Quality** | Ad-hoc suggestions | Professional validation patterns |
| **Integration** | Basic tool usage | Advanced MCP orchestration |
Perfect if you:
- ✅ Want consistent AI assistance across projects
- ✅ Value evidence over opinions
- ✅ Need specialized thinking modes
- ✅ Care about token efficiency
- ✅ Like tools that just work
## 🔮 Professional Use Cases
Skip if you:
- ❌ Prefer completely manual control
- ❌ Don't use Claude Code regularly
- ❌ Happy with generic AI responses
**Enterprise Development Teams**
- Consistent expertise across different technical domains
- Standardized development workflows and quality gates
- Evidence-based technical decision making
- Professional documentation and knowledge transfer
## 🚦 Get Started in 2 Minutes
**Technical Leaders**
- Architecture review and system design validation
- Performance optimization and security auditing
- Code quality improvement and refactoring
- Team mentoring and best practice enforcement
1. **Install**
**Production Operations**
- Safe deployment and migration procedures
- Systematic debugging and issue resolution
- Security compliance and vulnerability management
- Professional maintenance and cleanup procedures
## 🎯 Is SuperClaude Right for Your Team?
**Ideal for teams that need:**
- ✅ Consistent AI expertise across technical domains
- ✅ Professional development workflows and standards
- ✅ Evidence-based technical decisions
- ✅ Token-efficient long-running projects
- ✅ Specialized cognitive modes for different tasks
**Not suitable if you prefer:**
- ❌ Completely manual AI interaction
- ❌ Generic, non-specialized responses
- ❌ Ad-hoc development practices
- ❌ Minimal configuration frameworks
## 🚦 Professional Setup
1. **Install SuperClaude**
```bash
git clone https://github.com/NomenAK/SuperClaude.git && cd SuperClaude && ./install.sh
# Or custom location: ./install.sh --dir /your/path
```
2. **Test Drive**
2. **Validate Installation**
```bash
/analyze --code # See what it finds
--persona-architect # Try a new mindset
/load # Load project context
/analyze --code --think # Test analysis capabilities
--persona-architect # Try cognitive switching
```
3. **Go Deeper**
- Explore commands: `/load`
- Read the guides: `~/.claude/commands/`
- Join the community: [Discussions](https://github.com/NomenAK/SuperClaude/discussions)
3. **Professional Workflows**
```bash
/design --api --ddd # Architecture design
/build --feature --tdd # Implementation
/test --coverage --e2e # Quality assurance
/deploy --env staging --plan # Safe deployment
```
## 🛟 Need Help?
## 🛟 Professional Support
- **Installation issues?** Run `./install.sh` again it's idempotent. Use `./install.sh --help` for options
- **Commands not working?** Check `ls ~/.claude/commands/`
- **Want to contribute?** See [CONTRIBUTING.md](CONTRIBUTING.md)
- **Found a bug?** [Open an issue](https://github.com/NomenAK/SuperClaude/issues)
- **Installation Issues**: Run `./install.sh --help` for configuration options
- **Command Reference**: Check `~/.claude/commands/` for detailed documentation
- **Professional Services**: See [CONTRIBUTING.md](CONTRIBUTING.md) for consulting
- **Issue Tracking**: [GitHub Issues](https://github.com/NomenAK/SuperClaude/issues)
## 🎉 Join the Revolution
## 🤝 Professional Community
SuperClaude isn't just a tool it's a movement to make AI assistance actually useful for real developers. Every persona added, every command refined, every pattern shared makes Claude Code better for everyone.
SuperClaude is maintained by professional developers for professional teams. We welcome:
- **Enterprise Personas** for specialized industry workflows
- **Professional Commands** for domain-specific operations
- **Quality Patterns** for better development practices
- **Integration Improvements** for team productivity
**What would make YOUR workflow better? Let's build it together.**
Join our professional development community: [Discussions](https://github.com/NomenAK/SuperClaude/discussions)
## 📈 Framework Metrics
**Token Efficiency**: 70% average reduction with same information density
**Command Coverage**: 18 commands across complete development lifecycle
**Cognitive Diversity**: 9 specialized personas with distinct expertise
**Integration Depth**: 4 MCP servers with advanced orchestration
**Quality Standards**: Evidence-based methodology with validation patterns
**Professional Adoption**: Used by development teams for production systems
## 🎉 Transform Your Development Workflow
SuperClaude isn't just a configuration it's a professional development methodology. Every command refined, every persona specialized, every pattern validated by professional development teams.
**Ready to elevate your development practices?**
---
*SuperClaude v4.0.0 Because generic AI assistance isn't good enough anymore.*
*SuperClaude v4.0.0 Professional development framework for Claude Code*
[⭐ Star us on GitHub](https://github.com/NomenAK/SuperClaude) | [💬 Join the Discussion](https://github.com/NomenAK/SuperClaude/discussions) | [🐛 Report an Issue](https://github.com/NomenAK/SuperClaude/issues)
[⭐ Star us on GitHub](https://github.com/NomenAK/SuperClaude) | [💬 Professional Discussions](https://github.com/NomenAK/SuperClaude/discussions) | [🐛 Report Issues](https://github.com/NomenAK/SuperClaude/issues)