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
2026-01-22 15:35:55 +00:00
commit 7a491b1548
1013 changed files with 170070 additions and 0 deletions
--- a/agents/README.md
+++ b/agents/README.md
@@ -0,0 +1,469 @@
+# 🚀 Ultimate Claude Code & GLM Suite
+
+> **40+ specialized AI agents, 15+ MCP tools, 7 PROACTIVELY auto-triggering coordinators** for Claude Code. Works with Anthropic Claude and Z.AI/GLM models (90% cost savings).
+
+> 💡 **Tip:** Use invite token `R0K78RJKNW` for **10% OFF** Z.AI GLM Plan subscription: https://z.ai/subscribe?ic=R0K78RJKNW
+
+[![Agents](https://img.shields.io/badge/Agents-38+-purple)](agents/)
+[![PROACTIVELY](https://img.shields.io/badge/PROACTIVELY_Agents-7-green)](#-proactively-auto-coordination)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-15+-blue)](#-mcp-tools)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+
+---
+
+## 🎯 What's New (January 2026)
+
+### ✨ Latest Updates
+
+- **📊 Agent Coordination System** - 7 PROACTIVELY coordinators automatically orchestrate 31 specialists
+- **🎨 ui-ux-pro-max Integration** - Professional UI/UX agent with 50+ styles, 97 palettes, WCAG compliance
+- **📝 MASTER-PROMPT.md Enhanced** - Complete workflow examples, proper markdown formatting
+- **🔧 All 7 Coordinators Documented** - studio-coach, ui-ux-pro-max, whimsy-injector, test-writer-fixer, experiment-tracker, studio-producer, project-shipper
+- **📚 Complete Documentation** - Workflow examples, coordination patterns, real-world use cases
+
+### 🏗️ Architecture Overview
+
+**38 Total Agents = 7 Coordinators + 31 Specialists**
+
+The 7 **PROACTIVELY coordinators** auto-trigger based on context and orchestrate specialists automatically:
+
+| Coordinator | Department | Auto-Triggers On |
+|-------------|------------|-------------------|
+| **ui-ux-pro-max** | Design | UI/UX design work, components, pages |
+| **whimsy-injector** | Design | After UI/UX changes for delightful touches |
+| **test-writer-fixer** | Engineering | After code modifications for testing |
+| **experiment-tracker** | Project Management | Feature flags, A/B tests, experiments |
+| **studio-producer** | Project Management | Cross-team coordination, resource conflicts |
+| **project-shipper** | Project Management | Launches, releases, go-to-market activities |
+| **studio-coach** | Bonus | Complex multi-agent tasks, agent confusion |
+
+**How It Works:**
+- **Automatic Path:** Coordinators auto-trigger → call specialists → coordinate workflow
+- **Manual Path:** You directly invoke any specialist for precise control
+- **Best of Both:** Automation when you want it, control when you need it
+
+**Real Example:**
+```
+You: "I need a viral TikTok app in 2 weeks"
+      ↓
+[studio-coach PROACTIVELY triggers]
+      ↓
+Coordinates: rapid-prototyper + tiktok-strategist + frontend-developer
+      ↓
+[whimsy-injector PROACTIVELY triggers]
+      ↓
+Adds delightful touches
+      ↓
+[project-shipper PROACTIVELY triggers]
+      ↓
+Plans launch strategy
+      ↓
+Result: Complete app, launch-ready ✓
+```
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.rommark.dev/admin/claude-code-glm-suite.git
+cd claude-code-glm-suite
+
+# Run the interactive installer
+chmod +x interactive-install-claude.sh
+./interactive-install-claude.sh
+
+# Follow the prompts:
+# ✅ Choose model (Anthropic/Z.AI)
+# ✅ Select agent categories to install
+# ✅ Configure MCP tools
+# ✅ Enter your API key
+# ✅ Launch Claude Code
+```
+
+---
+
+## ⚠️ IMPORTANT: For Z.AI / GLM Users
+
+**If using the GLM Coding Plan (90% cheaper), you MUST configure GLM FIRST before using Claude Code!**
+
+**🎯 EASIEST METHOD - Use Z.AI Coding Helper Wizard:**
+
+```bash
+# Install coding helper and run setup wizard
+npm install -g @z_ai/coding-helper
+npx @z_ai/coding-helper init
+
+# The wizard will:
+# ✅ Ask for your Z.AI API key
+# ✅ Configure Claude Code for GLM automatically
+# ✅ Set up model mappings (glm-4.5-air, glm-4.7)
+# ✅ Verify everything works
+
+# Start Claude Code with GLM
+claude
+```
+
+**Manual Configuration (if you prefer):**
+```bash
+# Get API key: https://z.ai/
+mkdir -p ~/.claude
+cat > ~/.claude/settings.json << 'EOF'
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "YOUR_ZAI_API_KEY_HERE",
+    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
+    "API_TIMEOUT_MS": "3000000",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
+  }
+}
+EOF
+npm install -g @anthropic-ai/claude-code
+claude
+```
+
+---
+
+## 📋 Installation Options
+
+### Option 1: Master Prompt (Recommended for First-Time Users)
+
+**Copy and paste into Claude Code** - it will guide you through the entire installation step-by-step:
+
+📄 **[MASTER-PROMPT.md](MASTER-PROMPT.md)**
+
+**⚡ Quick Start:**
+1. **If using GLM:** Configure GLM first (see above)
+2. Start Claude Code: `claude`
+3. Copy the prompt from MASTER-PROMPT.md (clearly marked with ✂️ COPY FROM HERE)
+4. Paste into Claude Code
+5. Done!
+
+**Benefits:**
+- ✅ See all steps before executing
+- ✅ Easy to customize and understand
+- ✅ Works entirely within Claude Code
+- ✅ Includes all source repository references
+
+### Option 2: Interactive Installation Script
+
+```bash
+git clone https://github.rommark.dev/admin/claude-code-glm-suite.git
+cd claude-code-glm-suite
+chmod +x interactive-install-claude.sh
+./interactive-install-claude.sh
+```
+
+**Benefits:**
+- ✅ Automated execution
+- ✅ Menu-driven configuration
+- ✅ Backup and verification built-in
+- ✅ Faster for experienced users
+
+### Option 3: Manual Installation
+
+Follow the step-by-step guide below for full control over each component.
+
+---
+
+## ✨ What's Included
+
+- **🤖 38 Custom Agents** across 8 departments
+  - **7 PROACTIVELY coordinators** that auto-trigger and orchestrate specialists
+  - **31 specialist agents** for domain-specific tasks
+- **🔧 15+ MCP Tools** for vision, search, and GitHub integration
+- **⚡ Intelligent Coordination** - Coordinators automatically detect context and orchestrate workflows
+- **🎛️ Interactive Installation** with model selection (Anthropic/Z.AI)
+- **🛡️ One-Click Setup** with comprehensive verification
+- **📚 Complete Documentation** with real-world workflow examples
+
+---
+
+## 🤖 Agent Departments
+
+### Engineering (7 agents)
+- **AI Engineer** - ML & LLM integration, prompt engineering
+- **Backend Architect** - API design, database architecture, microservices
+- **DevOps Automator** - CI/CD pipelines, infrastructure as code
+- **Frontend Developer** - React/Vue/Angular, responsive design
+- **Mobile Builder** - iOS/Android React Native apps
+- **Rapid Prototyper** - Quick MVPs in 6-day cycles
+- **Test Writer/Fixer** - Auto-write and fix tests (PROACTIVELY)
+
+### Design (6 agents)
+- **UI/UX Pro Max** - Professional UI/UX design with 50+ styles, 97 palettes, WCAG (PROACTIVELY)
+- **Whimsy Injector** - Delightful micro-interactions and memorable UX (PROACTIVELY)
+- **Brand Guardian** - Brand consistency
+- **UI Designer** - UI design and implementation
+- **UX Researcher** - User experience research
+- **Visual Storyteller** - Visual communication
+
+### Project Management (3 agents)
+- **Experiment Tracker** - A/B test tracking and metrics (PROACTIVELY)
+- **Project Shipper** - Launch coordination and go-to-market (PROACTIVELY)
+- **Studio Producer** - Cross-team coordination and resources (PROACTIVELY)
+
+### Product (3 agents)
+- **Feedback Synthesizer** - User feedback analysis
+- **Sprint Prioritizer** - 6-day sprint planning
+- **Trend Researcher** - Market trend analysis
+
+### Marketing (7 agents)
+- **TikTok Strategist** - Viral TikTok marketing strategies
+- **Growth Hacker** - Growth strategies and user acquisition
+- **Content Creator** - Multi-platform content creation
+- **Instagram Curator** - Instagram strategy and engagement
+- **Reddit Builder** - Reddit community building
+- **Twitter Engager** - Twitter strategy and tactics
+- **App Store Optimizer** - ASO optimization
+
+### Studio Operations (5 agents)
+- **Analytics Reporter** - Data analysis and reporting
+- **Finance Tracker** - Financial tracking
+- **Infrastructure Maintainer** - Infrastructure management
+- **Legal Compliance Checker** - Compliance checks
+- **Support Responder** - Customer support automation
+
+### Testing (5 agents)
+- **API Tester** - API testing
+- **Performance Benchmarker** - Performance testing
+- **Test Results Analyzer** - Test analysis
+- **Tool Evaluator** - Tool evaluation
+- **Workflow Optimizer** - Workflow optimization
+
+### Bonus (2 agents)
+- **Studio Coach** - Team coaching and motivation for complex tasks (PROACTIVELY)
+- **Joker** - Humor and team morale
+
+---
+
+## 🎯 PROACTIVELY Auto-Coordination
+
+### How It Works
+
+The 7 PROACTIVELY coordinators automatically orchestrate the 31 specialists based on context:
+
+**Two Pathways:**
+
+1. **Automatic** (Recommended)
+   - Coordinators auto-trigger based on context
+   - Call appropriate specialists
+   - Coordinate multi-agent workflows
+   - Ensure quality and completeness
+
+2. **Direct**
+   - Manually invoke any specialist
+   - Precise control over specific tasks
+   - Use when you need specific expertise
+
+### The 7 PROACTIVELY Coordinators
+
+#### 1. ui-ux-pro-max (Design)
+**Triggers on:** UI/UX design work, components, pages, dashboards
+
+**Provides:**
+- Professional design patterns
+- 50+ design styles (glassmorphism, minimalism, brutalism, etc.)
+- 97 color palettes by industry
+- 57 font pairings with Google Fonts
+- WCAG 2.1 AA/AAA accessibility compliance
+- Tech-stack specific patterns (React, Next.js, Vue, Tailwind, shadcn/ui)
+
+#### 2. whimsy-injector (Design)
+**Triggers after:** UI/UX changes, new components, feature completion
+
+**Provides:**
+- Delightful micro-interactions
+- Memorable user moments
+- Playful animations
+- Engaging empty states
+- Celebratory success states
+
+#### 3. test-writer-fixer (Engineering)
+**Triggers after:** Code modifications, refactoring, bug fixes
+
+**Provides:**
+- Comprehensive test coverage
+- Unit, integration, and E2E tests
+- Failure analysis and repair
+- Test suite health maintenance
+- Edge case coverage
+
+#### 4. experiment-tracker (Project Management)
+**Triggers on:** Feature flags, A/B tests, experiments, product decisions
+
+**Provides:**
+- Experiment design and setup
+- Success metrics definition
+- A/B test tracking
+- Statistical significance calculation
+- Data-driven decision support
+
+#### 5. studio-producer (Project Management)
+**Triggers on:** Team collaboration, resource conflicts, workflow issues
+
+**Provides:**
+- Cross-team coordination
+- Resource allocation optimization
+- Workflow improvement
+- Dependency management
+- Sprint planning support
+
+#### 6. project-shipper (Project Management)
+**Triggers on:** Releases, launches, go-to-market, shipping milestones
+
+**Provides:**
+- Launch planning and coordination
+- Release calendar management
+- Go-to-market strategy
+- Stakeholder communication
+- Post-launch monitoring
+
+#### 7. studio-coach (Bonus)
+**Triggers on:** Complex projects, multi-agent tasks, agent confusion
+
+**Provides:**
+- Elite performance coaching
+- Multi-agent coordination
+- Motivation and alignment
+- Problem-solving guidance
+- Best practices enforcement
+
+### Real Workflow Example
+
+```
+You: "I need a viral TikTok app in 2 weeks"
+      ↓
+[studio-coach PROACTIVELY triggers]
+      ↓
+Analyzes complexity and coordinates:
+  → rapid-prototyper builds MVP
+  → tiktok-strategist plans viral features
+  → frontend-developer builds UI
+      ↓
+[whimsy-injector PROACTIVELY triggers]
+      ↓
+Adds delightful touches and micro-interactions
+      ↓
+[project-shipper PROACTIVELY triggers]
+      ↓
+Plans launch strategy and coordinates release
+      ↓
+Result: Complete viral app, launch-ready, in 2 weeks ✓
+```
+
+**Key Benefits:**
+- ✅ No manual orchestration required
+- ✅ Automatic quality gates (testing, UX, launches)
+- ✅ Intelligent specialist selection
+- ✅ Seamless multi-agent workflows
+- ✅ Consistent delivery quality
+
+---
+
+## 🔧 MCP Tools
+
+### Vision Tools (8 tools)
+| Tool | Function | Input |
+|------|----------|-------|
+| `analyze_image` | General image analysis | PNG, JPG, JPEG |
+| `analyze_video` | Video content analysis | MP4, MOV, M4V |
+| `ui_to_artifact` | UI screenshot to code | Screenshots |
+| `extract_text` | OCR text extraction | Any image |
+| `diagnose_error` | Error screenshot diagnosis | Error screenshots |
+| `ui_diff_check` | Compare UI screenshots | Before/after |
+| `analyze_data_viz` | Data visualization insights | Dashboards, charts |
+| `understand_diagram` | Technical diagram analysis | UML, flowcharts |
+
+### Web & GitHub Tools
+| Tool | Function | Source |
+|------|----------|--------|
+| `web-search-prime` | AI-optimized web search | Real-time information |
+| `web-reader` | Web page to markdown conversion | Documentation access |
+| `zread` | GitHub repository reader | Codebase analysis |
+| `@z_ai/mcp-server` | Vision and analysis tools | [@z_ai/mcp-server](https://github.com/zai-ai/mcp-server) |
+| `@z_ai/coding-helper` | Web and GitHub integration | [@z_ai/coding-helper](https://github.com/zai-ai/mcp-server) |
+
+---
+
+## 📚 Documentation
+
+- **[MASTER-PROMPT.md](MASTER-PROMPT.md)** - Copy-paste installation prompt with complete workflow examples
+- **[docs/workflow-example-pro.html](docs/workflow-example-pro.html)** - PRO-level workflow visualization
+- **[docs/coordination-system-pro.html](docs/coordination-system-pro.html)** - Complete coordination system explanation
+- **[docs/AUTO-TRIGGER-INTEGRATION-REPORT.md](docs/AUTO-TRIGGER-INTEGRATION-REPORT.md)** - Complete auto-trigger verification report
+
+---
+
+## 📖 Complete Source Guide
+
+This suite integrates **6 major open-source projects**:
+
+### 1. contains-studio/agents 🎭
+**Source:** https://github.com/contains-studio/agents
+**Provides:** 37 specialized agents with PROACTIVELY auto-triggering
+**Key Innovation:** Context-aware agent selection system
+
+### 2. @z_ai/mcp-server 🖼️
+**Source:** https://github.com/zai-ai/mcp-server
+**Provides:** 8 vision tools for images, videos, diagrams
+**Key Feature:** Understand visual content for debugging and design
+
+### 3. @z_ai/coding-helper 🌐
+**Source:** https://github.com/zai-ai/mcp-server
+**Provides:** Web search, GitHub integration, GLM setup wizard
+**Key Feature:** Interactive configuration and real-time information
+
+### 4. llm-tldr 📊
+**Source:** https://github.com/parcadei/llm-tldr
+**Provides:** 95% token reduction via 5-layer code analysis
+**Key Feature:** Semantic search and impact analysis
+
+### 5. ui-ux-pro-max-skill 🎨
+**Source:** https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
+**Provides:** Professional UI/UX design agent with comprehensive patterns
+**Key Feature:** PROACTIVELY auto-triggering for all design work
+
+### 6. claude-codex-settings 📋
+**Source:** https://github.com/fcakyon/claude-codex-settings
+**Provides:** MCP configuration best practices (reference)
+**Key Feature:** Proven integration patterns
+
+---
+
+## 🎯 Real-Life Impact: Before vs After
+
+| Scenario | Without Suite | With Suite | Impact |
+|----------|--------------|-----------|--------|
+| **Debugging Errors** | Paste text manually, miss context | Upload screenshot → Instant diagnosis | 5x faster |
+| **Implementing UI** | Describe in words, iterate 10+ times | Upload design → Exact code generated | 10x faster |
+| **Understanding Code** | Read files manually, hit token limits | TLDR 5-layer analysis, 95% token savings | 20x faster |
+| **Writing Tests** | Write manually, forget often | Auto-triggered after every code change | Always tested |
+| **Code Search** | grep for exact names | Semantic search by behavior | Finds by intent |
+| **Web Research** | Outdated training data | Real-time web search | Always current |
+| **Refactoring** | Risk breaking changes | Impact analysis, safe refactoring | Zero breaking changes |
+| **Multi-Agent Tasks** | Manual orchestration | Automatic coordination | Hands-free delivery |
+
+---
+
+## 🤝 Community & Contributing
+
+This suite is **100% open source** and available on [GitHub](https://github.rommark.dev/admin/claude-code-glm-suite).
+
+- ⭐ Star the repo
+- 🐛 Report issues
+- 🔄 Submit pull requests
+- 💡 Contribute your own agents!
+
+---
+
+## 📝 License
+
+MIT License - Feel free to use and modify for your needs.
+
+---
+
+**Built for developers who ship.** 🚀