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%