775c5c65e7
BREAKING CHANGES to workflow: - Add 'BEFORE YOU BEGIN' section to MASTER-PROMPT.md - GLM users MUST configure GLM FIRST before using Claude Code - Add clear GLM pre-configuration steps at top of file - Add clear copy boundaries (✂️ COPY FROM HERE / ✂️ COPY ENDS HERE) - Add visual separator lines for copy-paste section README.md updates: - Add prominent GLM warning at top of Installation Options - Add quick GLM setup commands - Clarify Master Prompt workflow with step-by-step - Emphasize GLM pre-configuration requirement This fixes the issue where GLM users couldn't use Claude Code to paste the master prompt without first configuring GLM.
282 lines
8.8 KiB
Markdown
282 lines
8.8 KiB
Markdown
# 🚀 Claude Code & GLM Suite - Master Integration Prompt
|
|
|
|
> **Quick installation by copy-pasting a prompt into Claude Code**
|
|
|
|
---
|
|
|
|
## ⚠️ BEFORE YOU BEGIN - Read This First!
|
|
|
|
### **If Using Z.AI / GLM Coding Plan (90% cheaper):**
|
|
|
|
**You MUST configure GLM FIRST before using Claude Code!**
|
|
|
|
```bash
|
|
# Step 1: Get your API key
|
|
# Visit: https://z.ai/
|
|
# Sign up for GLM Coding Plan and copy your API key
|
|
|
|
# Step 2: Create Claude Code settings
|
|
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
|
|
|
|
# Step 3: Install Claude Code (if not installed)
|
|
npm install -g @anthropic-ai/claude-code
|
|
|
|
# Step 4: Verify installation
|
|
claude --version # Should be 2.0.14 or higher
|
|
|
|
# Step 5: Start Claude Code
|
|
claude
|
|
|
|
# Step 6: When prompted, enter /status to verify GLM is working
|
|
/status
|
|
```
|
|
|
|
**📖 Official GLM Documentation:** https://docs.z.ai/devpack/tool/claude
|
|
|
|
---
|
|
|
|
### **If Using Anthropic Claude (Official API):**
|
|
|
|
```bash
|
|
# Step 1: Get your API key
|
|
# Visit: https://console.anthropic.com/
|
|
|
|
# Step 2: Create Claude Code settings
|
|
mkdir -p ~/.claude
|
|
cat > ~/.claude/settings.json << 'EOF'
|
|
{
|
|
"env": {
|
|
"ANTHROPIC_AUTH_TOKEN": "sk-ant-your-api-key-here",
|
|
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
|
|
}
|
|
}
|
|
EOF
|
|
|
|
# Step 3: Install Claude Code (if not installed)
|
|
npm install -g @anthropic-ai/claude-code
|
|
|
|
# Step 4: Start Claude Code
|
|
claude
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 HOW TO USE THE MASTER PROMPT
|
|
|
|
**Once Claude Code is running and configured:**
|
|
|
|
### **Option 1: Copy From This File**
|
|
|
|
**✂️ COPY FROM HERE:**
|
|
|
|
```text
|
|
═══════════════════════════════════════════════════════════════════════════════
|
|
|
|
I want to install the Ultimate Claude Code & GLM Customization Suite with 40+ agents, MCP tools, and auto-triggering automation. Please perform the following integration:
|
|
|
|
## Step 1: Install Contains Studio Agents (37 agents with PROACTIVELY auto-triggering)
|
|
|
|
Clone the contains-studio/agents repository:
|
|
git clone https://github.com/contains-studio/agents.git /tmp/contains-studio-agents
|
|
|
|
Copy all agents to Claude Code agents directory:
|
|
cp -r /tmp/contains-studio-agents/agents/* ~/.claude/agents/
|
|
|
|
This provides:
|
|
- 37 specialized agents across 8 departments
|
|
- PROACTIVELY auto-triggering system (studio-coach, test-writer-fixer, whimsy-injector, experiment-tracker)
|
|
- Rich example format with <commentary> tags
|
|
- 500+ word system prompts
|
|
|
|
## Step 2: Configure MCP Tools (Vision + Web + GitHub)
|
|
|
|
Install Z.AI MCP server for vision tools:
|
|
npm install -g @z_ai/mcp-server
|
|
|
|
Install Z.AI coding helper for web/GitHub integration:
|
|
npm install -g @z_ai/coding-helper
|
|
|
|
Verify installations:
|
|
npx @z_ai/mcp-server --help
|
|
npx @z_ai/coding-helper --help
|
|
|
|
This provides 15+ MCP tools including:
|
|
- Image/video analysis
|
|
- UI to code conversion
|
|
- OCR text extraction
|
|
- Error diagnosis
|
|
- UI comparison
|
|
- Data visualization insights
|
|
- Diagram understanding
|
|
- Web search and page reading
|
|
- GitHub repository reading
|
|
|
|
## Step 3: Configure Hooks-Based Auto-Triggering (Optional)
|
|
|
|
Create ~/.claude/hooks.json for additional auto-triggering:
|
|
cat > ~/.claude/hooks.json << 'EOF'
|
|
{
|
|
"userPromptSubmitHook": "test-writer-fixer@agent",
|
|
"toolOutputHook": "whimsy-injector@agent"
|
|
}
|
|
EOF
|
|
|
|
Note: PROACTIVELY agents (studio-coach, experiment-tracker) work automatically without hooks.
|
|
|
|
## Step 4: Verify Installation
|
|
|
|
Run these checks:
|
|
1. List agents: ls -la ~/.claude/agents/
|
|
2. Count agents: find ~/.claude/agents -name "*.md" | wc -l
|
|
3. Test Claude Code: claude --version
|
|
4. Check MCP tools: npx @z_ai/mcp-server --help
|
|
|
|
Expected results:
|
|
- 38+ agent files (37 agents + README)
|
|
- All department folders present (engineering, marketing, design, product, project-management, studio-operations, testing, bonus)
|
|
- MCP tools installed and accessible
|
|
- Settings configured
|
|
|
|
## What This Integration Provides:
|
|
|
|
### 40+ AI Agents Including:
|
|
- Engineering: AI Engineer, Backend Architect, DevOps Automator, Frontend Developer, Mobile Builder, Rapid Prototyper, Test Writer/Fixer
|
|
- Marketing: TikTok Strategist, Growth Hacker, Content Creator, Instagram Curator, Reddit Builder, Twitter Engager, App Store Optimizer
|
|
- Product: Feedback Synthesizer, Sprint Prioritizer, Trend Researcher
|
|
- Project Management: Experiment Tracker, Project Shipper, Studio Producer
|
|
- Studio Operations: Analytics Reporter, Finance Tracker, Infrastructure Maintainer, Legal Compliance Checker, Support Responder
|
|
- Testing: API Tester, Performance Benchmarker, Test Results Analyzer, Tool Evaluator, Workflow Optimizer
|
|
- Design: Brand Guardian, UI Designer, UX Researcher, Visual Storyteller, Whimsy Injector
|
|
- Bonus: Studio Coach, Joker
|
|
|
|
### Auto-Triggering Agents:
|
|
1. studio-coach - Coordinates complex multi-agent tasks
|
|
2. test-writer-fixer - Writes tests after code changes
|
|
3. whimsy-injector - Adds delight to UI designs
|
|
4. experiment-tracker - Tracks A/B tests and experiments
|
|
|
|
### 15+ MCP Tools:
|
|
- Vision: analyze_image, analyze_video, ui_to_artifact, extract_text, diagnose_error, ui_diff_check, analyze_data_viz, understand_diagram
|
|
- Web: web-search-prime, web-reader
|
|
- GitHub: zread (repository reader)
|
|
|
|
### Two Auto-Triggering Mechanisms:
|
|
1. PROACTIVELY Keyword (contains-studio) - Context-aware, zero config
|
|
2. Hooks-Based (our implementation) - Event-driven, explicit control
|
|
|
|
Please execute this integration step by step and confirm when complete.
|
|
|
|
═══════════════════════════════════════════════════════════════════════════════
|
|
```
|
|
|
|
**✂️ COPY ENDS HERE**
|
|
|
|
---
|
|
|
|
## 📖 Detailed Installation Guide
|
|
|
|
### What Gets Installed:
|
|
|
|
| Component | Source | Count |
|
|
|-----------|--------|-------|
|
|
| AI Agents | contains-studio/agents | 37 |
|
|
| MCP Vision Tools | @z_ai/mcp-server | 8 |
|
|
| MCP Web Tools | claude-codex-settings | 2 |
|
|
| MCP GitHub Tools | @z_ai/coding-helper | 1 |
|
|
| Auto-Triggering | contains-studio + custom | 4 agents |
|
|
| **Total** | | **40+ agents, 15+ tools** |
|
|
|
|
---
|
|
|
|
## 🎯 Quick Reference
|
|
|
|
**After Installation, Test With:**
|
|
|
|
```bash
|
|
# Start Claude Code
|
|
claude
|
|
|
|
# Try these commands:
|
|
> List all available agents
|
|
> Use the frontend-developer agent to create a React component
|
|
> Use the whimsy-injector agent to enhance this UI
|
|
|
|
# Test MCP tools:
|
|
> Analyze this image: [path to image]
|
|
> Search the web for "latest AI trends"
|
|
> Read the documentation from https://example.com
|
|
```
|
|
|
|
---
|
|
|
|
## 🆚 Master Prompt vs Installation Scripts
|
|
|
|
| Feature | Master Prompt | Installation Scripts |
|
|
|---------|--------------|---------------------|
|
|
| **Setup** | Copy-paste into Claude Code | Run bash scripts |
|
|
| **Control** | Step-by-step confirmation | Automated execution |
|
|
| **Customization** | Easy to modify steps | Edit script files |
|
|
| **Transparency** | See all steps upfront | Scripts run automatically |
|
|
| **Best For** | Understanding what happens | Quick installation |
|
|
|
|
---
|
|
|
|
## 📚 Source Repositories
|
|
|
|
This integration pulls from multiple open-source projects:
|
|
|
|
### Core Agents
|
|
- **[contains-studio/agents](https://github.com/contains-studio/agents)** - 37 agents with PROACTIVELY auto-triggering
|
|
- **[claude-codex-settings](https://github.com/fcakyon/claude-codex-settings)** - MCP configuration patterns
|
|
|
|
### Design Inspiration
|
|
- **[ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)** - UI/UX design patterns
|
|
|
|
### Coordination Framework
|
|
- **[Ralph](https://github.com/iannuttall/ralph)** - Multi-agent coordination patterns
|
|
|
|
### MCP Tools
|
|
- **[@z_ai/mcp-server](https://github.com/zai-ai/mcp-server)** - Vision and analysis tools
|
|
- **[Model Context Protocol](https://github.com/modelcontextprotocol)** - Open standard for AI tools
|
|
|
|
### Official Tools
|
|
- **[Claude Code](https://github.com/anthropics/claude-code)** - Official Claude Code CLI
|
|
- **[Z.AI GLM Documentation](https://docs.z.ai/devpack/tool/claude)** - Official GLM integration guide
|
|
|
|
---
|
|
|
|
## ✅ After Installation
|
|
|
|
Test your setup:
|
|
|
|
```bash
|
|
# 1. Verify agents are installed
|
|
ls ~/.claude/agents/
|
|
find ~/.claude/agents -name "*.md" | wc -l
|
|
|
|
# 2. Start Claude Code
|
|
claude
|
|
|
|
# 3. Check status (enter /status when prompted)
|
|
/status
|
|
|
|
# 4. Try an agent
|
|
> Use the studio-coach agent to help me plan a complex project
|
|
```
|
|
|
|
---
|
|
|
|
**Built for developers who ship.** 🚀
|