# Claude Code Customization Suite

> 40+ specialized AI agents, MCP tools, and enterprise-grade automation scripts for Claude Code.

[![Agents](https://img.shields.io/badge/Agents-40+-purple)](agents/)
[![MCP Tools](https://img.shields.io/badge/MCP_Tools-15+-blue)](#mcp-tools)
[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)

## 🚀 Quick Start

```bash
# Clone the repository
git clone https://github.rommark.dev/admin/Enhance-Claude-Code-with-30--Agentic-Tools.git
cd Enhance-Claude-Code-with-30--Agentic-Tools

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

## ✨ What's Included

- **🤖 40+ Custom Agents** across 8 categories
- **🔧 15+ MCP Tools** for vision, search, and GitHub integration
- **⚡ Auto-Triggering** test writer and UI enhancement agents
- **🎛️ Interactive Installation** with model selection (Anthropic/Z.AI)
- **🛡️ One-Click Setup** with comprehensive verification

## 📦 Installation Scripts

| Script | Description | Size |
|--------|-------------|------|
| `interactive-install-claude.sh` | Full interactive installer (recommended) | 33KB |
| `claude-setup-manager.sh` | Menu-driven setup manager | 11KB |
| `create-complete-package.sh` | Create distributable packages | 16KB |
| `verify-claude-setup.sh` | Verify your installation | 9KB |
| `export-claude-customizations.sh` | Export existing customizations | 6.5KB |

## 🤖 Agent Categories

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

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

### Product (3 agents)
- **Feedback Synthesizer** - User feedback analysis
- **Sprint Prioritizer** - 6-day sprint planning
- **Trend Researcher** - Market trend analysis

### Project Management (3 agents)
- **Experiment Tracker** - A/B test tracking
- **Project Shipper** - Launch coordination
- **Studio Producer** - Team workflow 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

### Design (5 agents)
- **Brand Guardian** - Brand consistency
- **UI Designer** - UI design and implementation
- **UX Researcher** - User experience research
- **Visual Storyteller** - Visual communication
- **Whimsy Injector** - Delightful UI enhancements

### Bonus (2 agents)
- **Joker** - Humor and team morale
- **Studio Coach** - Team coaching and motivation

## 🔧 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 | [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings) |
| `web-reader` | Web page to markdown conversion | [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings) |
| `zread` | GitHub repository reader | [claude-codex-settings](https://github.com/fcakyon/claude-codex-settings) |
| `@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/mcp-server](https://github.com/zai-ai/mcp-server) |

## 📊 Model Configuration

### Option 1: Anthropic Claude (Official)
```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-anthropic-api-key",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}
```

### Option 2: Z.AI / GLM Coding Plan
```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-zai-api-key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic"
  }
}
```

> **Note:** Z.AI offers compatible Claude models at lower costs, perfect for development and testing.

## 📚 Documentation

- **[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

## 🙏 Acknowledgments & Sources

This customization suite is built upon excellent open-source projects and community contributions.

### Core Inspiration

- **[claude-codex-settings](https://github.com/fcakyon/claude-codex-settings)** by [fcakyon](https://github.com/fcakyon)
  - Comprehensive Claude Code settings and MCP configurations
  - Foundation for MCP tool integration patterns

- **[ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)** by [nextlevelbuilder](https://github.com/nextlevelbuilder)
  - Professional UI/UX design patterns and agent behaviors
  - Inspired design-focused agents and whimsy-injector

- **[Ralph](https://github.com/iannuttall/ralph)** by [iannuttall](https://github.com/iannuttall)
  - AI assistant framework and agent patterns
  - Inspired multi-agent coordination and studio operations workflows

### MCP Tool Sources

- **[@z_ai/mcp-server](https://github.com/zai-ai/mcp-server)** - Vision analysis, OCR, UI comparison, video analysis, and diagram understanding
- **[Model Context Protocol](https://github.com/modelcontextprotocol)** - Open standard for connecting AI models to tools
- **[Claude Code](https://github.com/anthropics/claude-code)** - Official Claude Code CLI by Anthropic

### Agent Architecture

- **6-Day Development Cycle** - Inspired by rapid iteration methodologies and startup best practices
- **Studio Operations** - Professional studio management patterns applied to software development
- **Auto-Triggering Agents** - Proactive agent invocation patterns for test writing and UI enhancement

## 🤝 Community & Contributing

This suite is **100% open source** and available on [GitHub](https://github.rommark.dev/admin/Enhance-Claude-Code-with-30--Agentic-Tools).

- ⭐ 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.** 🚀