Grey Haven Claude Code Configuration

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

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

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

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

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

🚀 Quick Start

1. Install Hooks and Skills

claude-config install-hooks
claude-config install-skills

2. Test Installation

claude-config doctor

3. Use Skills and Plugins

Skills work automatically - just code naturally:

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

Use plugins via commands:

In Claude Code:

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

📦 Available Plugins

Plugin	Description
`core`	TDD implementation, code review, quality pipeline, debugging
`developer-experience`	Documentation, onboarding, API design, code style
`testing`	Playwright, Chrome E2E, visual regression testing
`deployment`	Cloudflare Workers/Pages deployment and debugging
`security`	OWASP security scanning, vulnerability analysis
`research`	API research with Firecrawl, Context7, TanStack patterns
`observability`	Monitoring, SLOs, metrics, performance tracking
`incident-response`	Debugging, runbooks, postmortem generation
`agent-orchestration`	Context management, workflow composition
`data-quality`	Pydantic validation, schema contracts, data quality
`linear`	Linear issue tracking, workflow integration
`cc-trace`	Claude Code API debugging with mitmproxy
`cloudflare-deployment-observability`	Deployment monitoring, CI/CD analytics
`knowledge-base`	Ontological knowledge management, long-term memory
`creative-writing`	8 specialized agents for the complete writing process

Total: 30+ agents, 40+ skills across 15 plugins

Install format: plugin-name@grey-haven-plugins (e.g., core@grey-haven-plugins)

🔧 CLI Commands

Hooks Management

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

Configuration

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

Diagnostics

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

📚 Documentation

Migration Guide - Upgrade from v1.x to v2.0.0
npm Package README - CLI tool documentation
Installation Guide - Detailed setup instructions
Architecture Plan - v2.0.0 design decisions

🔄 Updating

Update Plugins

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

Update CLI Tools

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/

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/

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

claude-config doctor

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md.

Development Setup

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

📄 License

🔗 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

creative-writing