Code Config

# Grey Haven Claude Code Configuration

**Version 2.1.0** - Hooks, Skills, configuration, and plugin marketplace for Claude Code

[![npm version](https://badge.fury.io/js/%40greyhaven%2Fclaude-code-config.svg)](https://www.npmjs.com/package/@greyhaven/claude-code-config)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

---

## 🎯 What This Repository Provides

This repository contains Grey Haven Studio's comprehensive Claude Code ecosystem:

**12 Plugin Packages** with **26+ Agents** and **30+ Commands**

- Distributed via local plugin marketplace (not npm)
- Clone this repository and configure in Claude Code settings

**3 Claude Skills** for automatic code assistance

- Code style enforcement (TypeScript, React, Python)
- Commit message formatting (Conventional Commits)
- Pull request template generation

**npm Package** (`@greyhaven/claude-code-config`) for:

- ✅ Hook installation and management
- ✅ Skills installation and management
- ✅ MCP server configuration
- ✅ Project initialization
- ✅ Settings backup/restore
- ✅ Diagnostics

---

## 📦 Installation

### Option 1: Full Setup (Recommended)

**Get plugins + CLI tools**:

```bash
# 1. Clone repository for plugins
git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git ~/grey-haven-plugins

# 2. Configure plugin marketplace in ~/.claude/settings.json
{
  "plugin": {
    "marketplaces": [{
      "name": "grey-haven-plugins",
      "source": "/Users/YOU/grey-haven-plugins/grey-haven-plugins"
    }],
    "install": [
      "core@grey-haven-plugins",
      "developer-experience@grey-haven-plugins",
      "observability@grey-haven-plugins",
      "cc-trace@grey-haven-plugins"
    ]
  }
}

# 3. (Optional) Install CLI tools for hook management
npm install -g @greyhaven/claude-code-config
claude-config install-hooks
```

### Option 2: Plugins Only

**If you only need agents and commands**:

```bash
# Clone and configure plugin marketplace
git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git ~/grey-haven-plugins

# Add to ~/.claude/settings.json (see full config above)
```

No npm package required!

### Option 3: CLI Tools Only

**If you only need hook installation and setup utilities**:

```bash
npm install -g @greyhaven/claude-code-config
```

---

## 🚀 Quick Start

### 1. Install Hooks and Skills

```bash
claude-config install-hooks
claude-config install-skills
```

### 2. Test Installation

```bash
claude-config doctor
```

### 3. Use Skills and Plugins

Skills work automatically - just code naturally:

```
"Write a React component"     → grey-haven-code-style applies
"Create a commit message"     → grey-haven-commit-format applies
"Generate a PR description"   → grey-haven-pr-template applies
```

Use plugins via commands:

In Claude Code:
```bash
/tdd-implement          # Test-driven development
/code-review            # Code review analysis
/security-scan          # Security audit
/doc-generate-api       # API documentation
```

---

## 📦 Available Plugins

| Plugin | Agents | Commands | Description |
|--------|--------|----------|-------------|
| `grey-haven-core` | 3 | 5 | Core functionality (research, context, git) |
| `grey-haven-developer-experience` | 5 | 8 | DX tools (TDD, code review, docs) |
| `grey-haven-observability` | 2 | 3 | Monitoring, logging, metrics |
| `cc-trace` | 1 | 0 | Claude Code API debugging with mitmproxy |
| `grey-haven-infrastructure` | 3 | 4 | IaC, deployment, scaling |
| `grey-haven-quality-assurance` | 2 | 3 | Testing, E2E, visual regression |
| `grey-haven-security` | 2 | 2 | Security scanning, vulnerability analysis |
| `grey-haven-data-engineering` | 2 | 2 | ETL, data pipelines, analytics |
| `grey-haven-ai-ml` | 2 | 1 | AI/ML workflows, model training |
| `grey-haven-mobile-development` | 2 | 1 | Mobile app development |
| `grey-haven-cloudflare` | 1 | 1 | Cloudflare Workers/Pages deployment |
| `grey-haven-linear-integration` | 1 | 1 | Linear project management |
| `grey-haven-hooks` | 0 | 0 | Hook documentation |

**Total**: 27+ agents, 30+ commands across 13 plugins

---

## 🔧 CLI Commands

### Hooks Management

```bash
claude-config install-hooks         # Install hooks to ~/.claude/hooks/
claude-config list-hooks            # Show available hooks
```

### Configuration

```bash
claude-config init                  # Initialize .claude/ directory
claude-config backup-settings       # Backup user settings
claude-config restore-settings      # Restore from backup
```

### Diagnostics

```bash
claude-config doctor                # Diagnose installation
claude-config version               # Show version
```

---

## 📚 Documentation

- **[Migration Guide](MIGRATION_V2.md)** - Upgrade from v1.x to v2.0.0
- **[npm Package README](README-npm.md)** - CLI tool documentation
- **[Installation Guide](INSTALLATION.md)** - Detailed setup instructions
- **[Architecture Plan](.claude/V2_ARCHITECTURE_PLAN.md)** - v2.0.0 design decisions

---

## 🔄 Updating

### Update Plugins

```bash
cd ~/grey-haven-plugins
git pull origin main
```

### Update CLI Tools

```bash
npm update -g @greyhaven/claude-code-config
# Or: claude-config self-update
```

---

## 🎯 Key Features

### 26+ Specialized Agents

**Core Functionality**:
- `docs-architect` - Technical documentation creation
- `code-quality-analyzer` - Multi-mode code analysis
- `tdd-python-implementer` - Test-driven Python development
- `tdd-typescript-implementer` - Test-driven TypeScript development

**Observability**:
- `observability-architect` - Monitoring setup
- `sli-slo-engineer` - SLI/SLO implementation

**Security**:
- `security-analyzer` - Vulnerability scanning
- `security-audit-orchestrator` - Comprehensive security audits

**[See full agent catalog in plugins/](grey-haven-plugins/)**

### 30+ Slash Commands

**Development**:
- `/tdd-implement` - TDD implementation workflow
- `/code-review` - Comprehensive code review
- `/refactor-clarity` - Clarity-focused refactoring

**Documentation**:
- `/doc-generate-api` - OpenAPI 3.1 generation
- `/doc-coverage` - Documentation coverage validation

**Security & Quality**:
- `/security-scan` - Security audit
- `/quality-pipeline` - Full quality check

**[See full command catalog in plugins/](grey-haven-plugins/)**

### 4 Production Hooks

- `subagent-context-preparer.py` - Optimize subagent context
- `security-validator.py` - Security validation
- `prompt-enhancer.py` - Enhance user prompts
- `work-completion-assistant.py` - Work completion tracking

---

## 🆚 v2.0.0 Changes

| Feature | v1.x | v2.0.0 |
|---------|------|--------|
| **Plugin distribution** | ✅ npm | ❌ Git + marketplace |
| **Hooks** | ✅ npm | ✅ npm (optional) |
| **CLI tools** | ✅ npm | ✅ npm (optional) |
| **Package size** | ~2 MB | ~500 KB |
| **Update method** | `npm update` | `git pull` + `npm update` |

**See [MIGRATION_V2.md](MIGRATION_V2.md) for complete migration guide.**

---

## 📋 System Requirements

### Required
- Claude Code installed
- Git

### Optional
- Python 3.8+ (for hooks)
- Node.js 14+ (for npm CLI tools)

### Check Installation

```bash
claude-config doctor
```

---

## 🤝 Contributing

Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).

### Development Setup

```bash
git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git
cd grey-haven-claude-code-config
npm install
```

---

## 📄 License

MIT © Grey Haven Studio

---

## 🔗 Links

- **GitHub**: https://github.com/greyhaven-ai/grey-haven-claude-code-config
- **npm**: https://www.npmjs.com/package/@greyhaven/claude-code-config
- **Issues**: https://github.com/greyhaven-ai/grey-haven-claude-code-config/issues

---

**Built with ❤️ for the Claude Code community**