Transform development workflows with intelligent AI orchestration
Complete automation toolkit featuring 16 specialized commands and 10 AI agents for project planning, code orchestration, and quality assurance. Seamlessly integrates with Claude AI and Claude Code.
Step 1: Install the toolkit
curl -sSL https://raw.githubusercontent.com/Ghenwy/claude-code-toolkit/main/install.sh | bashStep 2: Create your first AI-orchestrated project
/A-plan "JWT authentication system with role-based access control"Step 3: Let AI agents handle the implementation
/A-ai-code --coordinar** That's it!** Your AI-powered development workflow is active.
Full Documentation See All Features Join Community
Project Idea
/A-plan AI generates comprehensive specs
/A-ai-code --coordinar Orchestrates multiple AI agents
Agent Orchestration Parallel & sequential execution
/M1-qa-gatekeeper Zero-tolerance quality validation
Production Ready Deployment-ready implementation
** Workflow:** Idea Planning Orchestration Development Quality Production
| Feature | Benefit | Impact |
|---|---|---|
| ** AI Orchestration** | Multiple agents work together | 10x faster development |
| ** Intelligent Planning** | Automated specs generation | Eliminate planning overhead |
| ** Dual-Scope Install** | User & global installations | Flexible deployment |
| ** Quality Assurance** | Built-in testing framework | Zero-defect releases |
** Found this useful? Give us a star to help other developers discover the toolkit!**
- Quick Start
- Key Features
- Commands Matrix
- AI Agents Matrix
- Installation
- Usage Examples
- Status Line Integration
- Community
- Documentation
- Multi-agent coordination for complex development tasks
- Parallel & sequential execution with intelligent dependency management
- Real-time progress tracking with consolidated reporting
- Automated specifications generation with gap analysis
- Adaptive questioning system for comprehensive requirements gathering
- Three-document output: SPECS.md, PLAN.md, and ROADMAP.md
- Dual-scope support: User (
~/.claude/) or Global (/usr/local/share/claude/) - Zero-conflict management with automatic precedence handling
- Cross-platform compatibility: Linux, macOS, Windows WSL
- Comprehensive testing framework covering user, global, and precedence scenarios
- Built-in quality gates with M1-qa-gatekeeper integration
- Standards compliance across 13 technology stacks
# Let Claude Code handle everything automatically
# Simply tell Claude Code: "Read AUTO-INSTALL.md and install the toolkit"See AUTO-INSTALL.md for step-by-step Claude Code installation.
curl -sSL https://raw.githubusercontent.com/Ghenwy/claude-code-toolkit/main/install.sh | bashgit clone https://github.com/Ghenwy/claude-code-toolkit.git
cd claude-code-toolkit
# User scope (personal, no sudo required)
./install.sh --user
# Global scope (system-wide, requires sudo)
sudo ./install.sh --global
# Test without installing
./install.sh --dry-rungit clone https://github.com/Ghenwy/claude-code-toolkit.git
cd claude-code-toolkit
cp commands/* ~/.claude/commands/
cp agents/* ~/.claude/agents/
cp statusbar/context_monitor_generic.py statusbar/plan_detector.py ~/.claude/scripts/
cp statusbar/statusbar-config.yaml ~/.claude/scripts/What gets installed: 16 commands + 10 agents + 2 monitoring scripts (context monitor and plan detector) + comprehensive testing framework
| Command | Category | Purpose | Key Features |
|---|---|---|---|
| A-claude-auto | Universal Router | Intelligent intent recognition and auto-execution | Command auto-routing, intent analysis, confidence scoring |
| A-plan | Planning | Project specifications generator | Gap analysis, adaptive questions, 3-doc output |
| A-ai-code | Orchestration | Multi-agent project coordinator | Agent delegation, progress tracking, parallel execution |
| B-create-feature | Scaffolding | Intelligent feature scaffolding | Auto-detection, templates, instant creation |
| B-explain-code | Analysis | Structured code analysis vs native | 13 matrices, auto-detection, standards integration, diagrams |
| B-debug-error | Debugging | Systematic error analysis and resolution | Error classification, forensics, stack-specific solutions |
| B-HealthCheck | Monitoring | AI tools health monitor | Parallel testing, diagnostics, troubleshooting |
| A-update-docs | Documentation | Smart doc updater | Git context, auto-compaction, critical preservation |
| A-architecture | Architecture | System design assistant | Architecture patterns, best practices |
| A-audit | Quality | Code audit automation | Quality metrics, compliance checks |
| A-changelog | Documentation | Changelog generator | Release notes, version tracking |
| A-insights | Analytics | Developer behavior + codebase curiosities | Git patterns, hotspots, team analytics, fun facts |
| A-onboarding | Setup | Auto-discovery onboarding generator | Project analysis, setup commands, no docs assumed |
| A-organize | Organization | Physical file reorganization vs manual | Auto dependency updates, path preservation, backup |
| A-todo | Tasks | Smart todo management | Task tracking, prioritization |
| B-ultra-think | Analysis | Deep thinking assistant | Complex problem solving |
** Quick Reference**: See CHEAT-SHEET.md for ultra-fast command reference
| Agent | Specialty | Use Cases | Expertise Level |
|---|---|---|---|
| M1-qa-gatekeeper | Quality Assurance | Pre-production validation | Zero-tolerance standards |
| M1-ultrathink-orchestrator | AI Orchestration | Multi-AI coordination | Supreme director |
| M1-general-purpose-agent | General Development | Multi-step tasks | Versatile problem solver |
| M1-senior-backend-architect | Backend Systems | API design, architecture | 10+ years experience |
| M1-frontend-architect-protocol | Frontend Systems | UI architecture, performance | Protocol-driven |
| M1-senior-documentation-architect | Documentation | Technical writing | Multi-audience docs |
| M1-technical-research-analyst | Research | Technology validation | Authoritative sources |
| M1-human-behavior-simulator | UX Testing | User behavior simulation | Authentic patterns |
| M1-ux-strategy-protocol | UX Strategy | Design psychology | Strategic approach |
| M1-game-development-architect | Game Development (Addon) | Complete game dev pipeline | Design + Unity + Assets |
Entry Point: Use /A-claude-auto "your request" for universal intent recognition and auto-routing
Development Flow: Project Idea /A-plan Specifications /A-ai-code --coordinar Agent Orchestration Development /M1-qa-gatekeeper Quality Validation Production Ready
Analytics & Discovery: /A-insights reveals team patterns and codebase curiosities, /A-onboarding generates setup guides from project analysis
Supporting Tools: /B-HealthCheck monitors AI tools, /A-update-docs maintains documentation throughout the process.
Real-time monitoring with advanced metrics:
my-project main | 69% (138k) | L.R. @ 04:00 C.U. 19% 02:25 Sep 19
Setup:
{
"statusLine": {
"type": "command",
"command": "python3 ~/.claude/scripts/context_monitor_generic.py"
}
}- Gap Analysis: Automatically identifies missing specifications
- Adaptive Questioning: Context-aware question generation
- Think Hard Mode: Deep reasoning for complex projects
- Multi-Agent Coordination: Parallel and sequential task execution
- Progress Tracking: Real-time status monitoring
- Dependency Management: Smart task sequencing
- Parallel Testing: Simultaneous AI tool verification
- Smart Diagnostics: Automatic troubleshooting suggestions
- Performance Metrics: Response time and reliability tracking
- Zero-Tolerance Standards: 90% test coverage minimum (when tests exist in project)
- Security Compliance: OWASP validation (requires existing security config/tests)
- Performance SLAs: Real load testing (when performance tests configured)
- 13 YAML Standards: Technology-specific coding standards and best practices
- Auto-Detection:
standards/{detected-stack}.yaml || standards/general.yamlfallback - Universal Integration: All commands leverage standards for consistent output
- Modern Tech Stack: React, Vue, Angular, Node.js, Python, TypeScript, Java, Spring Boot
- Progressive Disclosure: CHEAT-SHEET.md (beginner) USER-GUIDE.md (intermediate) individual commands (advanced)
- Universal Router:
A-claude-auto.mdwith intent recognition and confidence scoring - Smart Defaults: Context-aware depth control and audience-appropriate explanations
- Project Analysis: Technology stack, framework, and architecture detection without assuming documentation
- Developer Analytics: Real git patterns, team working hours, codebase hotspots and curiosities
- Environment Setup: Automatic extraction of setup commands from package.json, requirements.txt, etc.
- Shell test suites: Dual-scope installation coverage (user, global, precedence)
- 3 Test Suites: User scope, global scope, and precedence testing
- QUICK-TESTS.md: 30-second validation system for all 16 commands
- CI/CD Ready: GitHub Actions and Jenkins integration examples
- 100% Command Validation: Every command tested and verified functional
/A-plan "E-commerce platform with real-time inventory" --scope mvp
# Generates: specifications.md, strategic-plan.md, todo-roadmap.md/A-ai-code --coordinar "Implement JWT authentication with role-based access"
# Coordinates: backend-architect + frontend-architect + qa-gatekeeper/B-HealthCheck --detailed
# Tests all AI tools in parallel, provides diagnostic report/A-insights . --git --files --deps
# Real analytics: peak coding hours, hotspots, technical debt, fun facts/A-onboarding --role developer --depth comprehensive
# Complete setup guide from project analysis, no docs assumed/B-explain-code "src/auth/UserService.java" --audience senior --diagrams both
# 13 structured matrices, auto-detection, ASCII/Mermaid diagrams/A-claude-auto "build todo app"
# Intent recognition auto-routes to /A-plan with confidence scoringThe toolkit includes a comprehensive testing system for quality assurance:
cd test/
# Complete validation (2-4 minutes)
./run-all-tests.sh
# Individual test suites
./test-user-installation.sh # User scope testing
./test-global-installation.sh # Global scope logic testing
./test-dual-scope-precedence.sh # Precedence validation- 45+ Individual Tests: Complete installation scenario coverage
- Non-destructive: Automatic backup/restore of existing installations
- Cross-platform: Linux, macOS, Windows WSL validation
- CI/CD Ready: GitHub Actions and Jenkins integration examples
- Performance Metrics: Timing and success rate analysis
- Failure Diagnostics: Detailed troubleshooting guidance
- Python 3.8+ (3.11+ recommended for best compatibility)
- Git (for context integration, recommended)
- Claude Code (latest version)
- codex, qwen, opencode, gemini (for enhanced orchestration via M1-ultrathink-orchestrator)
- MCP Servers (for specialized agent capabilities)
- CHEAT-SHEET.md: Ultra-fast command reference (beginner level)
- USER-GUIDE.md: Step-by-step workflows and examples (intermediate level)
- INSTALLATION.md: Complete dual-scope installation guide with troubleshooting
- AUTO-INSTALL.md: Automated installation for Claude Code users
- install.sh: Professional installer with dual-scope support
- Testing Framework: Three shell suites with detailed reporting
- QUICK-TESTS.md: 30-second validation system for all 16 commands
- MID-TESTS.md: Comprehensive validation with detailed criteria
- STANDARDS/: 13 YAML files with technology-specific coding standards
- Beginner: Start with CHEAT-SHEET.md for quick command overview
- Intermediate: Follow USER-GUIDE.md for detailed workflows
- Advanced: Use individual commands directly or
/A-claude-autouniversal router
- GitHub Discussions - Ask questions, share ideas, showcase your automation workflows
- Issues - Report bugs, request features, and technical support
- Documentation - Complete guides, API reference, and best practices
- Test Cases - Testing framework and validation examples
Found this toolkit helpful? Here's how you can support the project:
- Star the repository to help other developers discover it
- Share with your team and in developer communities
- Report issues to help us improve the toolkit
- Suggest features that would enhance your workflow
- Contribute documentation, examples, or code improvements
- Topics: AI tools, automation, developer productivity, Claude AI
- Quality: 45+ comprehensive tests ensuring reliability
- Active Development: Regular updates and feature additions
- Production Ready: Used by developers for real-world automation
Love automating your workflow with AI? Join our growing community of developers!
- Fork the repository
- Create feature branch:
git checkout -b feature/amazing-feature - Follow the Contributing Guidelines
- Submit a Pull Request
MIT License - see LICENSE for details.
** Star this repo** if you find it useful for AI automation! ** Report issues** at GitHub Issues ** Share with developers** who need workflow automation ** Read the docs** for complete feature overview
claude-ai ai-automation developer-tools workflow-automation productivity claude-code ai-agents development-workflow code-orchestration project-planning testing-framework dual-scope-installation
Built with for the AI-powered development community
