Skip to content

calhouny/CCGlobalCommands

 
 

Repository files navigation

CCGlobalCommands

A comprehensive collection of optimized AI agents and workflows for Claude Code, designed to enhance productivity across software development, business analysis, and infrastructure management.

License: MIT Claude Code Token Optimized

🚀 Features

  • 30+ Specialized AI Agents - Expert assistance across all domains
  • 15+ Multi-Agent Workflows - Coordinated automation for complex tasks
  • Token Optimized - 45% reduction in API costs through smart design
  • Hierarchical Architecture - Efficient orchestration patterns
  • Visual Testing - Automated CSS regression detection with Playwright
  • Production Ready - Battle-tested prompts with extensive optimization

📖 Quick Start

Installation

# Create the commands directory if it doesn't exist
mkdir -p ~/.claude/commands

# Clone the repository
git clone https://github.com/GGPrompts/ClaudeGlobalCommands.git
cd ClaudeGlobalCommands

# Run the installer
./INSTALL.sh

Usage in Claude Code

  1. Get Help: /guide - Comprehensive command overview
  2. List Agents: /agents - Browse all AI specialists
  3. Start Tasks: /execute <task> - Quick task execution
  4. Run Workflows: /workflows <name> - Multi-agent automation

Core Commands

Command Purpose Token Cost
/guide Help system and command overview ~500
/agents Directory of all AI specialists ~1,000
/prompt-engineer Optimize prompts for better results ~2,000
/senior-engineer Code reviews and architecture guidance ~2,500
/documentation Technical documentation generation ~1,500
/workflows Multi-step automated processes ~1,000
/execute Quick task execution with smart routing ~2,000

Featured Workflows

Workflow Description Token Cost
css-safety-check Prevent visual regressions before deployment ~3,000
visual-testing Comprehensive UI testing with screenshots ~3,500
code-review Multi-perspective code analysis ~3,500
documentation-update Hierarchical doc generation ~2,500
start-workflow Automated project planning ~4,000

🏗️ Project Structure

CCGlobalCommands/
├── commands/               # Core optimized commands
│   ├── guide.md           # Master help system
│   ├── agents.md          # Agent directory
│   ├── prompt-engineer.md # Prompt optimization
│   ├── senior-engineer.md # Technical guidance
│   ├── documentation.md   # Documentation expert
│   ├── workflows.md       # Workflow catalog
│   ├── cicd-orchestrator.md # CI/CD management
│   ├── incident-commander.md # Crisis response
│   └── execute.md         # Quick task execution
├── _archive/              # Specialized agents
│   ├── business/          # Business specialists
│   ├── engineering/       # Development specialists
│   └── infrastructure/    # Cloud/DevOps specialists
├── workflows/             # Multi-agent workflows
│   ├── css-safety-check.md
│   ├── visual-testing.md
│   ├── documentation-update.md
│   └── start-workflow.md
├── setup/                 # Optimization utilities
└── docs/                  # Documentation

🎯 Usage Examples

Basic Commands

# Get help with available commands
/guide

# List all AI specialists
/agents

# Quick task execution
/execute "optimize this React component for performance"

# Get code reviewed
/senior-engineer "review my authentication system"

Workflows

# Prevent CSS regressions
/workflows css-safety-check

# Comprehensive UI testing
/workflows visual-testing

# Update documentation
/workflows documentation-update

# Plan new features
/workflows start-workflow

Specialized Agents

# Visual design help
/load _archive/engineering/visual-designer

# Cloud architecture
/load _archive/infrastructure/cloud-architect

# Business strategy
/load _archive/business/marketing-expert

🔧 Available Agents

Core Agents (Always Available)

  • Guide - Command help and navigation
  • Agents - Specialist directory and search
  • Prompt Engineer - Optimize prompts for better results
  • Senior Engineer - Code reviews and architecture
  • Documentation - Technical writing and docs
  • Workflows - Multi-agent process coordination
  • CI/CD Orchestrator - Pipeline management
  • Incident Commander - Crisis response coordination
  • Execute - Quick task execution and routing

Engineering Specialists (In Archive)

  • Visual Designer - CSS, animations, responsive design
  • Frontend Engineer - React, Vue, Angular development
  • Backend Engineer - APIs, microservices, databases
  • QA Automation - Testing strategies and automation
  • Security Engineer - Security audits and compliance
  • Performance Optimizer - Application optimization
  • Data Engineer - ETL pipelines and data architecture

Business Specialists (In Archive)

  • Marketing Expert - Marketing strategies and campaigns
  • Legal Expert - Legal compliance and contracts
  • Project Manager - Project planning and coordination
  • Product Manager - Product strategy and roadmaps

Infrastructure Specialists (In Archive)

  • Cloud Architect - Multi-cloud architecture design
  • Kubernetes Specialist - Container orchestration
  • Terraform Expert - Infrastructure as Code

🔄 Workflows Overview

Development Workflows

  1. Code Review - Multi-perspective code analysis
  2. CSS Safety Check - Visual regression prevention
  3. Visual Testing - Comprehensive UI validation
  4. Documentation Update - Hierarchical doc generation

Planning Workflows

  1. Start Workflow - Automated project planning
  2. Feature Planning - Complete feature design process
  3. Migration Planning - System migration roadmaps

Operations Workflows

  1. Incident Response - Coordinated crisis management
  2. Performance Optimization - System-wide improvements
  3. Security Audit - Comprehensive security review

🚀 Optimization Achievements

This project implements advanced token optimization techniques:

  • 47.8% Token Reduction across all commands
  • Hierarchical Architecture replaces parallel processing for 40% savings
  • YAML Format reduces XML overhead by 60%
  • Template Extraction eliminates duplication
  • Smart Orchestration minimizes context switching

Before/After Comparison

Component Original Tokens Optimized Tokens Savings
Core Commands ~17,575 ~8,902 49.3%
Workflows ~27,500 ~16,500 40.0%
Total 45,075 25,402 43.7%

🔧 Installation Options

Option 1: Full Installation (Recommended)

# Clone the repository
git clone https://github.com/GGPrompts/ClaudeGlobalCommands.git
cd ClaudeGlobalCommands

# Run the installer script
./INSTALL.sh
# Choose option 1 for complete installation

Option 2: Manual Installation

# Create necessary directories
mkdir -p ~/.claude/commands ~/.claude/workflows ~/.claude/archive

# Clone the repository
git clone https://github.com/GGPrompts/ClaudeGlobalCommands.git
cd ClaudeGlobalCommands

# Copy files manually
cp commands/*.md ~/.claude/commands/
cp workflows/*.md ~/.claude/workflows/
cp -r _archive/* ~/.claude/archive/

Option 3: Selective Installation

# Clone the repository
git clone https://github.com/GGPrompts/ClaudeGlobalCommands.git
cd ClaudeGlobalCommands

# Install only core commands
mkdir -p ~/.claude/commands
cp commands/{guide,agents,senior-engineer,workflows}.md ~/.claude/commands/

# Add specific workflows as needed
mkdir -p ~/.claude/workflows
cp workflows/{css-safety-check,visual-testing}.md ~/.claude/workflows/

📊 Token Usage Guidelines

Command Categories

  • 🟢 Light (500-1,500 tokens): Help, directory commands
  • 🟡 Medium (1,500-3,000 tokens): Single agent tasks
  • 🟠 Heavy (3,000-5,000 tokens): Complex analysis
  • 🔴 Intensive (5,000+ tokens): Multi-agent workflows

Cost Management Tips

  1. Start with light commands for exploration
  2. Use workflows for complex tasks to minimize token waste
  3. Leverage the /execute command for intelligent routing
  4. Monitor usage with token estimates provided

🛠️ Development

Adding New Commands

# Follow the optimized YAML structure
role: "Your agent's role and expertise"
motivation: "Why this agent exists"
core_function: "🎯 Primary purpose in one line"
token_estimate: "X,XXX-X,XXX tokens per request"
responsibilities:
  - List of key capabilities
  - Specific and actionable items

Testing Commands

# Validate YAML syntax
python setup/utilities/prompt-validator.py commands/new-command.md

# Count tokens
python setup/utilities/token-counter.py commands/new-command.md

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Follow the optimization guidelines
  4. Test thoroughly
  5. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

📈 Performance Benefits

Speed Improvements

  • 30-45% faster workflow execution
  • Reduced context switching through hierarchical design
  • Smart caching of common patterns

Cost Savings

  • 43.7% token reduction = proportional API cost savings
  • Efficient orchestration minimizes redundant processing
  • Progressive enhancement loads only what's needed

Maintainability

  • Standardized YAML format across all commands
  • Shared component library reduces duplication
  • Template system ensures consistency

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Acknowledgments

  • Optimized for Claude Code and Claude 4 Opus/Sonnet
  • Inspired by AI agent orchestration patterns
  • Built with token efficiency and cost optimization in mind

📞 Support


CCGlobalCommands - Optimized AI assistance for the modern developer

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 96.9%
  • Shell 3.1%