uroma 2fdafe23dd Update MASTER-PROMPT: Add Ralph CLI to overview section
Changes:
- Update component count: 6 → 7 major components
- Add Ralph CLI as component #6 with (Advanced - Optional) label
- Shift claude-codex-settings to component #7

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2fdafe23dd · 2026-01-16 09:45:33 +00:00
34 Commits

🚀 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 PROACTIVELY MCP Tools 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

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

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

# 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

Copy and paste into Claude Code - it will guide you through the entire installation step-by-step:

📄 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

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
@z_ai/coding-helper Web and GitHub integration @z_ai/coding-helper

📚 Documentation


📖 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.

  • 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. 🚀

Description
🚀 Ultimate Claude Code & GLM Suite - 40+ specialized AI agents, MCP tools, auto-triggering automation. Works with Anthropic Claude and Z.AI/GLM models.
https://www.rommark.dev
Readme 793 KiB
Languages
Shell 85.8%
Python 13%
Dockerfile 1.2%