Claude Dev Toolkit

Transform Claude Code into a complete development platform with 58 AI-powered custom commands that automate your entire software development workflow.

🚀 Quick Installation

# Install globally via NPM
npm install -g @paulduvall/claude-dev-toolkit

# Commands are immediately available in Claude Code
claude
/xhelp    # List all available commands

📦 What's Included

• 13 Active Commands: Production-ready commands for immediate use
• 45 Experimental Commands: Cutting-edge features for early adopters
• Security Hooks: Automated security validation and governance
• Configuration Templates: Pre-configured settings for different workflows
• Interactive Setup Wizard: Guided installation with customization options
• JavaScript Test Suite: 100% test coverage with 10 comprehensive test suites

🎯 Quick Start

Option 1: Automatic Setup (Recommended)

npm install -g @paulduvall/claude-dev-toolkit
# Interactive setup wizard runs automatically

Option 2: Manual Command Installation

# Install specific command sets
claude-commands install --active        # Install 13 production commands
claude-commands install --experiments  # Install 45 experimental commands  
claude-commands install --all           # Install all 58 commands

Option 3: Custom Installation

claude-commands list                     # See all available commands
claude-commands status                   # Check installation status
claude-commands oidc --help             # Configure GitHub Actions OIDC with AWS

📋 Available Commands

🎯 Daily Development (Production Ready)

• /xtest - Smart test runner with coverage analysis
• /xquality - Code quality checks (format, lint, type-check)
• /xgit - Automated git workflow with AI-generated commits
• /xdebug - AI-powered debugging assistant

🔒 Security & Quality

• /xsecurity - Comprehensive vulnerability scanning
• /xrefactor - Intelligent code refactoring and smell detection

🏗️ Architecture & Planning

• /xarchitecture - System design and architecture analysis
• /xspec - Requirements and specification generation
• /xdocs - Documentation generation and maintenance

🚀 DevOps & Deployment

• /xpipeline - CI/CD pipeline optimization
• /xrelease - Release management automation
• /xconfig - Configuration management
• /xtdd - Test-driven development automation

🧪 Experimental Commands (45 Additional)

Advanced commands for specialized workflows:

• Planning & Analytics: /xplanning, /xanalytics, /xmetrics
• Infrastructure: /xinfra, /xmonitoring, /xaws
• Compliance: /xcompliance, /xgovernance, /xpolicy
• Advanced Security: /xred, /xrisk, /xscan
• Performance: /xperformance, /xoptimize

🛠️ CLI Usage

# Management Commands
claude-commands list                    # List all available commands
claude-commands status                  # Show installation status
claude-commands install --active       # Install production commands
claude-commands install --experiments # Install experimental commands
claude-commands install --all          # Install all commands

# Configuration Management
claude-commands config --list          # List available templates
claude-commands config --template <name> # Apply configuration template
claude-commands config --help          # Show config command help

# OIDC Configuration (NEW)
claude-commands oidc --help            # Show OIDC configuration options
claude-commands oidc --dry-run         # Preview OIDC setup actions
claude-commands oidc --region us-west-2 --stack-name my-oidc # Configure AWS OIDC

# Subagents Management
claude-commands subagents --list        # List available subagents
claude-commands subagents --install     # Install subagents to Claude Code
claude-commands subagents --help        # Show subagents command help

# In Claude Code
/xhelp                                 # Show command help
/xtest                                 # Run intelligent test suite
/xquality fix                          # Auto-fix code quality issues
/xsecurity --scan --report            # Comprehensive security scan
/xgit                                  # Automated git workflow

🔧 Configuration

Configuration Management

Use the built-in config command to manage Claude Code settings:

# List available configuration templates
claude-commands config --list

# Apply a specific template
claude-commands config --template basic-settings.json
claude-commands config --template security-focused-settings.json  
claude-commands config --template comprehensive-settings.json

# Show help for config command
claude-commands config --help

Installation Locations

• Commands: ~/.claude/commands/active/ and ~/.claude/commands/experiments/
• Configuration: ~/.claude/settings.json
• Security Hooks: ~/.claude/hooks/
• Templates: Bundled with package installation

Configuration Templates

The package includes three pre-configured templates:

1. Basic (basic-settings.json): Minimal setup for command functionality
2. Security-Focused (security-focused-settings.json): Enhanced security with hooks
3. Comprehensive (comprehensive-settings.json): Full feature set with governance

Templates are applied via the config command with automatic backup of existing settings.

🧪 Development & Testing

Running Tests

# Run all test suites (100% coverage)
npm test

# Run specific test suites
npm run test:commands     # Command validation
npm run test:workflow     # Core workflow tests
npm run test:security     # Security command tests
npm run test:config       # Configuration command tests
npm run test:subagents    # Subagents CLI command tests
npm run test:req007       # Interactive setup wizard
npm run test:req009       # Configuration templates
npm run test:req018       # Security hook installation

# Validation and linting
npm run validate          # Package validation
npm run lint             # Code linting

Test Coverage

• 10 Test Suites: 100% passing
• Command Validation: All 58 commands validated
• Security Tests: Comprehensive security pattern validation
• Integration Tests: End-to-end workflow testing
• Configuration Tests: Template and setup validation

Architecture

• Self-Contained Package: No dependencies on repository cloning
• JavaScript-Based: Native Node.js integration with comprehensive testing
• Modular Design: Separate installer, config, and validation modules
• Cross-Platform: Works on macOS, Linux, and Windows

🔒 Security Features

Built-in Security Hooks

• Credential Protection: Prevents exposure of API keys and secrets
• File Operation Logging: Audits all AI-generated file changes
• Governance Integration: Policy enforcement and compliance checking

Security Commands

• /xsecurity: Vulnerability scanning and dependency auditing
• /xred: Defensive security testing (experimental)
• /xcompliance: Automated compliance checking (experimental)

🚨 Troubleshooting

Common Issues

# Commands not recognized?
claude-commands status                  # Check installation
claude-commands install --active       # Reinstall commands

# Permission errors?
chmod 755 ~/.claude/commands/*.md      # Fix permissions

# Missing experimental commands?
claude-commands install --experiments # Install experimental set

# Test failures?
npm test                               # Run full test suite
npm run validate                       # Validate package

Validation Commands

# Package validation
npm run validate                       # Package structure validation
npm test                              # Comprehensive test suite

# CLI validation
claude-commands verify                 # Complete setup verification
claude-commands list                   # Check installed commands

📚 Documentation

Complete Documentation

• Main Repository: Claude Code Custom Commands
• Command Reference: claude-custom-commands.md
• Security Hooks: claude-code-hooks-system.md

Quick Reference

Every command includes built-in help:

/xtest help         # Show all testing options
/xquality help      # Show quality check options  
/xsecurity help     # Show security scanning options
/xconfig help       # Show configuration options

🤝 Contributing

Development Setup

# Clone main repository
git clone https://github.com/PaulDuvall/claude-code.git
cd claude-code

# NPM package is located in claude-dev-toolkit/
cd claude-dev-toolkit
npm install
npm test

Adding Commands

1. Create command files in repository slash-commands/active/ or slash-commands/experiments/
2. Commands are included in NPM package through build process
3. Validate with npm run test:commands
4. Follow existing patterns and security guidelines

Testing

• All changes must pass 100% of tests before merging
• JavaScript test suite provides comprehensive validation
• Security-first development - only defensive tools allowed

🔄 Recent Updates

Version 0.0.1-alpha.9

• ✅ NEW: OIDC Command: GitHub Actions to AWS OIDC integration (claude-commands oidc)
• ✅ TDD Implementation: Phase 1 foundation with comprehensive test coverage (14/14 tests)
• ✅ CLI Integration: Full command-line interface with help, dry-run, and configuration options
• ✅ Error Framework: Enhanced error handling with context-aware recovery suggestions
• ✅ Dependency Validation: AWS CLI, Git, and GitHub CLI availability checking

Version 0.0.1-alpha.8

• ✅ Documentation Consistency: Fixed command counts (58) and subagent counts (26)
• ✅ Test Infrastructure: Enhanced test-results directory handling
• ✅ Repository Cleanup: Removed outdated documentation and test artifacts
• ✅ Validation Logic: Improved scenario-aware test validation
• ✅ Version Alignment: Synchronized all version references

Version 0.0.1-alpha.7

• ✅ NPM Scoped Package: Published as @paulduvall/claude-dev-toolkit
• ✅ Configuration Command: Built-in config command for template management
• ✅ Workflow Reporting: Comprehensive GitHub Actions reporting
• ✅ Subagents Support: Multi-agent coordination capabilities
• ✅ Enhanced Documentation: Updated installation and usage instructions

Version 0.0.1-alpha.2

• ✅ Symlink Consolidation: Eliminated duplicate directories
• ✅ JavaScript Migration: Complete test suite migration from Python
• ✅ Enhanced Templates: Fixed configuration template issues
• ✅ 100% Test Coverage: All 10 test suites passing
• ✅ 58 Total Commands: 13 active + 45 experimental commands
• ✅ Security Enhancements: Comprehensive security hook system

📄 License

MIT © Paul Duvall

🙏 Acknowledgments

Built for the Claude Code community to accelerate AI-powered development workflows.

Ready to transform your development workflow? Install now and experience AI-powered automation for testing, security, quality, and deployment.