SuperCharged-Claude-Code-Upgrade/README.md

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

curl -fsSL https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade/raw/main/supercharge.sh | bash

Manual Installation

# Clone the repository
git clone https://github.rommark.dev/admin/SuperCharged-Claude-Code-Upgrade.git
cd SuperCharged-Claude-Code-Upgrade

# Run the installer
./supercharge.sh

Installation Options

# Skip dependency installation
./supercharge.sh --skip-deps

# Development mode (verbose output)
./supercharge.sh --dev-mode

Claude Code Installation (Optional)

If you don't have Claude Code installed yet, the supercharge script will offer to install it for you with Z.AI API support.

What is Z.AI API?

Z.AI provides GLM (General Language Model) models that can be used with Claude Code:

• glm-4.5-air - Fast, efficient model (Haiku class)
• glm-4.7 - Powerful model (Sonnet/Opus class)

Tip

Grab 10% OFF Token for z.ai coding plan: https://z.ai/subscribe?ic=R0K78RJKNW

Automated Installation

# Install Claude Code with Z.AI API
./install-claude-code.sh --auto

# You'll be prompted for your Z.AI API key
# Get your API key from: https://docs.z.ai/devpack/tool/claude

Manual Installation

# 1. Install Claude Code via npm
npm install -g @anthropic-ai/claude-code

# 2. Configure Z.AI API
# Create or edit ~/.claude/settings.json:
{
  "env": {
    "ANTHROPIC_API_KEY": "your-zai-api-key-here",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

# 3. Start Claude Code
claude

# 4. Check model status
/status

Show Manual Instructions Only

./install-claude-code.sh --manual

Documentation

• Z.AI Official Docs: https://docs.z.ai/devpack/tool/claude
• Claude Code Docs: https://docs.anthropic.com/en/docs/claude-code/overview

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

# 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:

# 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

> /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

> /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

> /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

# 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

{
  "customInstructions": "enabled",
  "permissions": {
    "allowedTools": ["*"],
    "allowedPrompts": ["*"]
  }
}

~/.claude/hooks.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:

> /agent-pipeline-builder "Create a content generation pipeline"
# Creates: Research -> Draft -> Review -> SEO -> Publish

Parallel Agent Execution

Run multiple independent agents simultaneously:

> /dispatching-parallel-agents "Test and document in parallel"
# Spawns: test-runner + documentation-writer

Plan Execution

Execute written implementation plans with checkpoints:

> /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:

# 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

#!/bin/bash
# Runs on session start
echo "Custom initialization..."

user-prompt-your-hook.sh

#!/bin/bash
# Runs before each user prompt
echo "Processing prompt..."

Troubleshooting

Ralph Loop Not Working

# 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

# 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

# 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

# Export all customizations
~/.claude/agents/export-claude-customizations.sh

Restore from Backup

# Run installer with backup
./supercharge.sh

# Customizations are automatically backed to:
~/.claude-backup-YYYYMMDD_HHMMSS/

Updates

Update SuperCharge Package

cd SuperCharged-Claude-Code-Upgrade
git pull origin main
./supercharge.sh

Update Agents

~/.claude/scripts/sync-agents.sh

Uninstallation

# 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
• Claude Code - Anthropic
• Community Skills - Various contributors

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Made with ❤️ for the Claude Code community

SuperCharge your development workflow today!