diff --git a/MASTER-PROMPT.md b/MASTER-PROMPT.md new file mode 100644 index 0000000..94cd55c --- /dev/null +++ b/MASTER-PROMPT.md @@ -0,0 +1,216 @@ +# 🚀 Claude Code & GLM Suite - Master Integration Prompt + +> **Copy and paste this entire prompt into Claude Code to automatically install the complete customization suite.** + +--- + +## 📋 Master Integration Prompt + +**Copy everything below this line and paste into Claude Code:** + +``` +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 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 Model (Choose ONE) + +Option A: Anthropic Claude (Official API) +Visit: https://console.anthropic.com/ +Create ~/.claude/settings.json with: +{ + "env": { + "ANTHROPIC_AUTH_TOKEN": "sk-ant-your-actual-api-key-here", + "ANTHROPIC_BASE_URL": "https://api.anthropic.com" + } +} + +Option B: Z.AI / GLM Coding Plan (90% cheaper) +Visit: https://z.ai/ +Create ~/.claude/settings.json with: +{ + "env": { + "ANTHROPIC_AUTH_TOKEN": "your-zai-api-key-here", + "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic", + "API_TIMEOUT_MS": "3000000" + } +} + +## Step 4: Configure Hooks-Based Auto-Triggering (Optional) + +Create ~/.claude/hooks.json for additional auto-triggering: +{ + "userPromptSubmitHook": "test-writer-fixer@agent", + "toolOutputHook": "whimsy-injector@agent" +} + +Note: PROACTIVELY agents (studio-coach, experiment-tracker) work automatically without hooks. + +## Step 5: 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. +``` + +--- + +## 🎯 How to Use + +1. **Copy** the entire prompt above (including the code block) +2. **Paste** into Claude Code +3. **Follow** the step-by-step installation +4. **Verify** your 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 + +--- + +## 🔧 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** | + +--- + +## ✅ After Installation + +Test your setup: + +```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 | + +--- + +## 📖 Documentation + +- **[Integration Guide](https://github.rommark.dev/admin/claude-code-glm-suite/src/main/INTEGRATION-GUIDE.md)** - Technical details +- **[Contains Studio Integration](https://github.rommark.dev/admin/claude-code-glm-suite/src/main/CONTAINS-STUDIO-INTEGRATION.md)** - PROACTIVELY mechanism +- **[README](https://github.rommark.dev/admin/claude-code-glm-suite)** - Complete documentation + +--- + +**Built for developers who ship.** 🚀 diff --git a/README.md b/README.md index 18c4f04..fc204f5 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,43 @@ chmod +x interactive-install-claude.sh # ✅ Launch Claude Code ``` +## 🎯 Installation Options + +Choose the installation method that works best for you: + +### Option 1: Master Prompt (Recommended for First-Time Users) + +**Copy and paste this prompt into Claude Code** - it will guide you through the entire installation step-by-step: + +📄 **[MASTER-PROMPT.md](https://github.rommark.dev/admin/claude-code-glm-suite/src/main/MASTER-PROMPT.md)** + +**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 - **🤖 40+ Custom Agents** across 8 categories @@ -420,6 +457,9 @@ Use specific models for different tasks: ## 📚 Documentation +- **[MASTER-PROMPT.md](MASTER-PROMPT.md)** - Copy-paste installation prompt for Claude Code +- **[INTEGRATION-GUIDE.md](INTEGRATION-GUIDE.md)** - Technical integration details +- **[CONTAINS-STUDIO-INTEGRATION.md](CONTAINS-STUDIO-INTEGRATION.md)** - PROACTIVELY auto-triggering explained - **[CLAUDE-CUSTOMIZATIONS-README.md](CLAUDE-CUSTOMIZATIONS-README.md)** - Complete feature documentation - **[FINAL-SETUP-GUIDE.md](FINAL-SETUP-GUIDE.md)** - Detailed setup instructions - **[SCRIPTS-GUIDE.md](SCRIPTS-GUIDE.md)** - Script usage guide