SuperCharge Claude Code v1.0.0 - Complete Customization Package
Features: - 30+ Custom Skills (cognitive, development, UI/UX, autonomous agents) - RalphLoop autonomous agent integration - Multi-AI consultation (Qwen) - Agent management system with sync capabilities - Custom hooks for session management - MCP servers integration - Plugin marketplace setup - Comprehensive installation script Components: - Skills: always-use-superpowers, ralph, brainstorming, ui-ux-pro-max, etc. - Agents: 100+ agents across engineering, marketing, product, etc. - Hooks: session-start-superpowers, qwen-consult, ralph-auto-trigger - Commands: /brainstorm, /write-plan, /execute-plan - MCP Servers: zai-mcp-server, web-search-prime, web-reader, zread - Binaries: ralphloop wrapper Installation: ./supercharge.sh
This commit is contained in:
uroma
396
README.md
Normal file
396
README.md
Normal file
@@ -0,0 +1,396 @@
|
||||
# SuperCharged Claude Code - Ultimate Upgrade
|
||||
|
||||
Transform your Claude Code installation into an autonomous development powerhouse with 30+ custom skills, AI agents, and advanced integrations.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Features
|
||||
|
||||
### 🧠 Cognitive Skills
|
||||
- **always-use-superpowers** - Automatically applies relevant skills before any action
|
||||
- **cognitive-core** - Core cognitive processing framework
|
||||
- **cognitive-context** - Enhanced understanding and analysis
|
||||
- **cognitive-planner** - Strategic planning capabilities
|
||||
- **cognitive-safety** - Security and safety validation
|
||||
|
||||
### 🎯 Development Tools
|
||||
- **agent-pipeline-builder** - Build multi-agent pipelines with structured data flow
|
||||
- **dispatching-parallel-agents** - Execute multiple agents concurrently
|
||||
- **executing-plans** - Execute implementation plans with review checkpoints
|
||||
- **finishing-a-development-branch** - Complete and merge development work
|
||||
- **subagent-driven-development** - Execute plans with independent subagents
|
||||
|
||||
### 🤖 Autonomous Agents
|
||||
- **RalphLoop** - "Tackle Until Solved" autonomous agent for complex tasks
|
||||
- **test-driven-development** - TDD workflow automation
|
||||
- **systematic-debugging** - Automated debugging workflow
|
||||
- **verification-before-completion** - Pre-completion validation
|
||||
|
||||
### 🎨 UI/UX Intelligence
|
||||
- **ui-ux-pro-max** - 50 styles, 21 palettes, 50 font pairings
|
||||
- Glassmorphism, Claymorphism, Neumorphism, Brutalism
|
||||
- Responsive design patterns
|
||||
- Accessibility-first components
|
||||
|
||||
### 🌐 Integrations
|
||||
- **Multi-AI Brainstorming** - Collaborate with multiple AI models
|
||||
- **Qwen Consultation** - Get second opinions from Qwen models
|
||||
- **MCP Servers** - Image analysis, web search, GitHub integration
|
||||
- **Dev-Browser** - Persistent browser automation
|
||||
|
||||
### 📝 Commands
|
||||
- `/ralph` - Autonomous iteration until completion
|
||||
- `/brainstorm` - Multi-AI brainstorming sessions
|
||||
- `/write-plan` - Create implementation plans
|
||||
- `/execute-plan` - Execute written plans
|
||||
- `/commit` - Smart git commits
|
||||
|
||||
## Quick Start
|
||||
|
||||
### One-Line Installation
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/your-repo/main/supercharge.sh | bash
|
||||
```
|
||||
|
||||
### Manual Installation
|
||||
|
||||
```bash
|
||||
# Clone the repository
|
||||
git clone https://github.com/rommark.dev/admin/SuperCharged-Claude-Code-Upgrade.git
|
||||
cd SuperCharged-Claude-Code-Upgrade
|
||||
|
||||
# Run the installer
|
||||
./supercharge.sh
|
||||
```
|
||||
|
||||
### Installation Options
|
||||
|
||||
```bash
|
||||
# Skip dependency installation
|
||||
./supercharge.sh --skip-deps
|
||||
|
||||
# Development mode (verbose output)
|
||||
./supercharge.sh --dev-mode
|
||||
```
|
||||
|
||||
## What Gets Installed
|
||||
|
||||
### Directory Structure
|
||||
|
||||
```
|
||||
~/.claude/
|
||||
├── skills/ # 30+ custom skills
|
||||
├── agents/ # Agent management system
|
||||
├── hooks/ # Custom hooks
|
||||
├── commands/ # Custom commands
|
||||
├── plugins/ # Plugin references
|
||||
├── scripts/ # Utility scripts
|
||||
└── settings.json # Configuration
|
||||
|
||||
~/.local/bin/
|
||||
└── ralphloop # Ralph Orchestrator wrapper
|
||||
```
|
||||
|
||||
### Installed Components
|
||||
|
||||
| Component | Description |
|
||||
|-----------|-------------|
|
||||
| **Skills** | 30+ custom skills for cognitive enhancement, development, UI/UX |
|
||||
| **Agents** | Complete agent library with sync capabilities |
|
||||
| **Hooks** | Session start, prompt submit, auto-trigger hooks |
|
||||
| **Commands** | Predefined commands for common workflows |
|
||||
| **Plugins** | MCP servers, LSP integrations, marketplace plugins |
|
||||
| **Binaries** | RalphLoop wrapper for autonomous agent iteration |
|
||||
|
||||
## Usage
|
||||
|
||||
### RalphLoop - Autonomous Agent
|
||||
|
||||
```bash
|
||||
# Let Ralph tackle complex problems autonomously
|
||||
claude
|
||||
> /ralph "Design a microservices architecture for an e-commerce platform"
|
||||
|
||||
# Ralph will iterate until the task is complete
|
||||
# - Creates task in .ralph/PROMPT.md
|
||||
# - Iterates continuously until success criteria are met
|
||||
# - Updates progress in .ralph/state.json
|
||||
# - Outputs final result to .ralph/iterations/final.md
|
||||
```
|
||||
|
||||
**Configuration:**
|
||||
```bash
|
||||
# Set agent (default: claude)
|
||||
export RALPH_AGENT=claude|gemini|kiro|q|auto
|
||||
|
||||
# Max iterations (default: 100)
|
||||
export RALPH_MAX_ITERATIONS=100
|
||||
|
||||
# Max runtime in seconds (default: 14400 = 4 hours)
|
||||
export RALPH_MAX_RUNTIME=14400
|
||||
|
||||
# Verbose output
|
||||
export RALPH_VERBOSE=true
|
||||
```
|
||||
|
||||
### Multi-AI Brainstorming
|
||||
|
||||
```bash
|
||||
> /brainstorming "Create a viral TikTok marketing strategy"
|
||||
# Collaborates with multiple AI perspectives:
|
||||
# - Content strategist
|
||||
# - SEO expert
|
||||
# - Social media manager
|
||||
# - Product manager
|
||||
# - Developer
|
||||
# - Designer
|
||||
```
|
||||
|
||||
### Test-Driven Development
|
||||
|
||||
```bash
|
||||
> /test-driven-development "Implement user authentication"
|
||||
# 1. Write failing tests first
|
||||
# 2. Implement minimal code to pass
|
||||
# 3. Refactor while keeping tests green
|
||||
```
|
||||
|
||||
### Systematic Debugging
|
||||
|
||||
```bash
|
||||
> /systematic-debugging "Database connection timing out"
|
||||
# 1. Gather information about the error
|
||||
# 2. Form hypotheses about root cause
|
||||
# 3. Test each hypothesis systematically
|
||||
# 4. Verify fixes don't break other functionality
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
### Environment Variables
|
||||
|
||||
```bash
|
||||
# Ralph Configuration
|
||||
export RALPH_AGENT=claude # Agent selection
|
||||
export RALPH_MAX_ITERATIONS=100 # Maximum iterations
|
||||
export RALPH_MAX_RUNTIME=14400 # Max runtime (4 hours)
|
||||
|
||||
# Qwen Consultation
|
||||
export QWEN_CONSULT_MODE=always # always|delegate|off
|
||||
export QWEN_MODEL=qwen-coder-plus # Model selection
|
||||
export QWEN_MAX_ITERATIONS=3 # Max consultation iterations
|
||||
|
||||
# Superpowers
|
||||
export AUTO_SUPERPOWERS=true # Auto-inject superpowers context
|
||||
```
|
||||
|
||||
### Settings Files
|
||||
|
||||
**~/.claude/settings.json**
|
||||
```json
|
||||
{
|
||||
"customInstructions": "enabled",
|
||||
"permissions": {
|
||||
"allowedTools": ["*"],
|
||||
"allowedPrompts": ["*"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**~/.claude/hooks.json**
|
||||
```json
|
||||
{
|
||||
"sessionStart": ["session-start-superpowers.sh"],
|
||||
"userPromptSubmit": ["qwen-consult.sh", "ralph-auto-trigger.sh"]
|
||||
}
|
||||
```
|
||||
|
||||
## Advanced Features
|
||||
|
||||
### Agent Pipeline Builder
|
||||
|
||||
Build multi-agent workflows with structured data flow:
|
||||
|
||||
```bash
|
||||
> /agent-pipeline-builder "Create a content generation pipeline"
|
||||
# Creates: Research -> Draft -> Review -> SEO -> Publish
|
||||
```
|
||||
|
||||
### Parallel Agent Execution
|
||||
|
||||
Run multiple independent agents simultaneously:
|
||||
|
||||
```bash
|
||||
> /dispatching-parallel-agents "Test and document in parallel"
|
||||
# Spawns: test-runner + documentation-writer
|
||||
```
|
||||
|
||||
### Plan Execution
|
||||
|
||||
Execute written implementation plans with checkpoints:
|
||||
|
||||
```bash
|
||||
> /execute-plan .claude/plans/feature-xyz.md
|
||||
# Executes plan with review at each checkpoint
|
||||
```
|
||||
|
||||
## Customization
|
||||
|
||||
### Adding Custom Skills
|
||||
|
||||
Create a new skill at `~/.claude/skills/your-skill/SKILL.md`:
|
||||
|
||||
```markdown
|
||||
# Your Custom Skill
|
||||
|
||||
## When to Use
|
||||
Use this skill when...
|
||||
|
||||
## What It Does
|
||||
This skill provides...
|
||||
```
|
||||
|
||||
### Adding Custom Hooks
|
||||
|
||||
Create hooks at `~/.claude/hooks/`:
|
||||
|
||||
**session-start-your-hook.sh**
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Runs on session start
|
||||
echo "Custom initialization..."
|
||||
```
|
||||
|
||||
**user-prompt-your-hook.sh**
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# Runs before each user prompt
|
||||
echo "Processing prompt..."
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Ralph Loop Not Working
|
||||
|
||||
```bash
|
||||
# Check Ralph installation
|
||||
ralph --version
|
||||
|
||||
# Reinstall Ralph Orchestrator
|
||||
pip3 install --upgrade ralph-orchestrator
|
||||
|
||||
# Check RalphLoop wrapper
|
||||
which ralphloop
|
||||
ls -la ~/.local/bin/ralphloop
|
||||
```
|
||||
|
||||
### Skills Not Loading
|
||||
|
||||
```bash
|
||||
# Check skills directory
|
||||
ls -la ~/.claude/skills/
|
||||
|
||||
# Verify skill syntax
|
||||
cat ~/.claude/skills/your-skill/SKILL.md
|
||||
|
||||
# Check for errors
|
||||
claude --debug
|
||||
```
|
||||
|
||||
### Hooks Not Executing
|
||||
|
||||
```bash
|
||||
# Check hooks.json
|
||||
cat ~/.claude/hooks.json
|
||||
|
||||
# Verify hooks are executable
|
||||
ls -la ~/.claude/hooks/*.sh
|
||||
|
||||
# Test hook manually
|
||||
bash ~/.claude/hooks/session-start-superpowers.sh
|
||||
```
|
||||
|
||||
## Backup and Restore
|
||||
|
||||
### Backup Current Setup
|
||||
|
||||
```bash
|
||||
# Export all customizations
|
||||
~/.claude/agents/export-claude-customizations.sh
|
||||
```
|
||||
|
||||
### Restore from Backup
|
||||
|
||||
```bash
|
||||
# Run installer with backup
|
||||
./supercharge.sh
|
||||
|
||||
# Customizations are automatically backed to:
|
||||
~/.claude-backup-YYYYMMDD_HHMMSS/
|
||||
```
|
||||
|
||||
## Updates
|
||||
|
||||
### Update SuperCharge Package
|
||||
|
||||
```bash
|
||||
cd SuperCharged-Claude-Code-Upgrade
|
||||
git pull origin main
|
||||
./supercharge.sh
|
||||
```
|
||||
|
||||
### Update Agents
|
||||
|
||||
```bash
|
||||
~/.claude/scripts/sync-agents.sh
|
||||
```
|
||||
|
||||
## Uninstallation
|
||||
|
||||
```bash
|
||||
# Remove customizations
|
||||
rm -rf ~/.claude/skills/*
|
||||
rm -rf ~/.claude/agents/*
|
||||
rm -rf ~/.claude/hooks/*
|
||||
rm -rf ~/.claude/commands/*
|
||||
rm -rf ~/.claude/plugins/*
|
||||
rm ~/.claude/hooks.json
|
||||
rm ~/.local/bin/ralphloop
|
||||
|
||||
# Restore from backup if needed
|
||||
cp -r ~/.claude-backup-YYYYMMDD_HHMMSS/* ~/.claude/
|
||||
```
|
||||
|
||||
## Contributing
|
||||
|
||||
Contributions welcome! Please:
|
||||
|
||||
1. Fork the repository
|
||||
2. Create a feature branch
|
||||
3. Make your changes
|
||||
4. Submit a pull request
|
||||
|
||||
## License
|
||||
|
||||
MIT License - See LICENSE file for details
|
||||
|
||||
## Credits
|
||||
|
||||
- **Ralph Orchestrator** - [mikeyobrien/ralph-orchestrator](https://github.com/mikeyobrien/ralph-orchestrator)
|
||||
- **Claude Code** - [Anthropic](https://claude.com/claude-code)
|
||||
- **Community Skills** - Various contributors
|
||||
|
||||
## Support
|
||||
|
||||
- **Issues**: [GitHub Issues](https://github.com/rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/issues)
|
||||
- **Discussions**: [GitHub Discussions](https://github.com/rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/discussions)
|
||||
|
||||
---
|
||||
|
||||
**Made with ❤️ for the Claude Code community**
|
||||
|
||||
*SuperCharge your development workflow today!*
|
||||
Reference in New Issue
Block a user