A comprehensive development toolkit designed following Anthropic's Claude Code Best Practices for AI-assisted software development.
Claude Command Suite is a development toolkit providing 148+ slash commands, 54 AI agents, Claude Code Skills, and automated workflows for software engineering tasks. The suite covers code review, testing, deployment, business scenario modeling, and GitHub-Linear synchronization through structured, repeatable workflows.
- Slash Commands: Namespace-organized commands (
/dev:code-review,/test:generate-test-cases,/deploy:prepare-release) for development workflows - AI Agents: Specialized agents for security auditing, test coverage analysis, and cross-platform synchronization
- Claude Code Skills: Model-invoked capabilities for recurring workflows including Linear task management and Cloudflare infrastructure deployment
- Automated Workflows: Pre-configured sequences for feature implementation and production deployment
- Scenario Simulators: Decision-making tools for business modeling, system behavior analysis, and architectural evaluation
- Task Orchestration: Task management system with Git integration and context preservation
Specialized AI agents handle complex development tasks through focused tool access and isolated contexts:
- Code Quality Suite: Automated code review, security scanning, performance analysis
- Test Engineer: Test generation with coverage analysis
- Integration Manager: GitHub-Linear bidirectional synchronization
- Strategic Analyst: Business scenario modeling and decision analysis
- Additional Agents: Project initialization, release management, architecture review
AI Agents Documentation | Workflow Examples
Claude Code Skills extend the suite with model-invoked capabilities that complement slash commands. Skills are automatically activated by Claude based on context, suitable for recurring workflows and domain-specific expertise.
| Feature | Skills (Model-Invoked) | Commands (User-Invoked) |
|---|---|---|
| Activation | Contextually triggered | Explicit invocation via /command |
| Use Case | Recurring workflows, domain expertise | Specific task execution |
| Scope | Personal or project-wide | Project-specific |
| Distribution | Git repositories, plugins | Command file copying |
linear-todo-sync - Linear task management integration
- GraphQL API integration for task retrieval
- Priority-based organization with metadata
- Markdown output with actionable links
- Context triggers: "What do I need to work on?", "Show my work"
cloudflare-manager - Cloudflare infrastructure management
- Workers deployment with URL extraction
- KV Storage and R2 bucket management
- Cloudflare Pages deployment
- DNS and routing configuration
- Requirements: Bun runtime, CLOUDFLARE_API_KEY
Structured workflow for creating custom skills:
- /skills:build-skill - Guided skill creation command
- Four-phase process: Requirements elicitation, code generation, validation, documentation
- Quality assurance: Automated testing and validation scripts
- Templates: Five skill templates for different use cases
Triggering skills:
"What do I need to work on today?" # Activates linear-todo-sync
"Deploy a cloudflare worker" # Activates cloudflare-manager
Creating skills:
/skills:build-skill
Documentation:
- Quick Start Guide - Skill creation walkthrough
- Complete Documentation - Full reference guide
- Browse Skills - Available implementations
| π€ AI Agents | π¨ Skills | π Getting Started | β‘ Commands | π‘ Usage |
|---|---|---|---|---|
| AI Agents | Skills | Quick Start | Available Commands | How It Works |
| Agent Docs | Skills Quickstart | Installation Guide | Command Namespaces | Common Workflows |
| Workflows | Skills Docs | Contributing |
Simply add command files directly to your project's .claude/commands/ folder:
# Create the commands directory in your project
mkdir -p .claude/commands
# Download specific commands you need
curl -o .claude/commands/dev/code-review.md https://raw.githubusercontent.com/qdhenry/Claude-Command-Suite/main/.claude/commands/dev/code-review.md
# Or copy your own custom command files
cp my-custom-command.md .claude/commands/Use our installation script to set up all commands at once:
git clone https://github.com/qdhenry/Claude-Command-Suite.git
cd Claude-Command-Suite
chmod +x install.sh
./install.shclaude code
/dev:code-review # Review your entire codebase
/project:create-feature # Build a new feature
/security:security-audit # Check for security issues148 commands organized by namespace for software development workflows.
54 AI agents available for complex task automation. AI Agents Documentation
| Core Development | Quality & Testing | Deployment | Collaboration | Advanced |
|---|---|---|---|---|
| π Project | π§ͺ Test | π¦ Deploy | π₯ Team | π― Simulation |
| π» Dev | π Security | π Docs | π Sync | π Orchestration |
| π§ Setup | β‘ Performance | π§ WFGY |
Project initialization, configuration, and management. Commands for project creation, dependency management, milestone tracking, and health monitoring.
/project:init-project- Initialize new project with essential structure/project:add-package- Add and configure new project dependencies/project:create-feature- Scaffold new feature with boilerplate code/project:milestone-tracker- Track and monitor project milestone progress/project:project-health-check- Analyze overall project health and metrics/project:project-to-linear- Sync project structure to Linear workspace/project:project-timeline-simulator- Simulate project outcomes with variable modeling/project:pac-configure- Configure Product as Code (PAC) project structure/project:pac-create-epic- Create new PAC epic with guided workflow/project:pac-create-ticket- Create new PAC ticket within an epic/project:pac-validate- Validate PAC structure for specification compliance/project:pac-update-status- Update PAC ticket status and track progress
Development utilities including code review, debugging, refactoring, and analysis modes.
/dev:code-review- Comprehensive code quality review/dev:debug-error- Systematically debug and fix errors/dev:explain-code- Analyze and explain code functionality/dev:refactor-code- Intelligently refactor and improve code quality/dev:fix-issue- Identify and resolve code issues/dev:ultra-think- Deep analysis and problem solving mode/dev:prime- Enhanced AI mode for complex tasks/dev:all-tools- Display all available development tools/dev:git-status- Show detailed git repository status/dev:clean-branches- Clean up merged and stale git branches/dev:directory-deep-dive- Analyze directory structure and purpose/dev:code-to-task- Convert code analysis to Linear tasks/dev:code-permutation-tester- Test multiple code variations through simulation/dev:architecture-scenario-explorer- Explore architectural decisions through scenario analysis
Testing tools for unit tests, integration tests, E2E tests, coverage analysis, mutation testing, and visual regression testing.
/test:generate-test-cases- Generate comprehensive test cases automatically/test:write-tests- Write unit and integration tests/test:test-coverage- Analyze and report test coverage/test:setup-comprehensive-testing- Setup complete testing infrastructure/test:e2e-setup- Configure end-to-end testing suite/test:setup-visual-testing- Setup visual regression testing/test:setup-load-testing- Configure load and performance testing/test:add-mutation-testing- Setup mutation testing for code quality/test:add-property-based-testing- Implement property-based testing framework/test:test-changelog-automation- Automate changelog testing workflow
Security auditing, dependency scanning, authentication implementation, and security hardening for codebase security.
/security:security-audit- Perform comprehensive security assessment/security:dependency-audit- Audit dependencies for security vulnerabilities/security:security-hardening- Harden application security configuration/security:add-authentication-system- Implement secure user authentication system
Tools for optimizing build times, bundle sizes, database queries, caching strategies, and application performance.
/performance:performance-audit- Audit application performance metrics/performance:optimize-build- Optimize build processes and speed/performance:optimize-bundle-size- Reduce and optimize bundle sizes/performance:optimize-database-performance- Optimize database queries and performance/performance:implement-caching-strategy- Design and implement caching solutions/performance:add-performance-monitoring- Setup application performance monitoring/performance:setup-cdn-optimization- Configure CDN for optimal delivery/performance:system-behavior-simulator- Simulate system performance under various loads
Bidirectional synchronization between GitHub Issues and Linear, PR tracking, conflict resolution, and cross-platform task management.
/sync:sync-issues-to-linear- Sync GitHub issues to Linear workspace/sync:sync-linear-to-issues- Sync Linear tasks to GitHub issues/sync:bidirectional-sync- Enable bidirectional GitHub-Linear synchronization/sync:issue-to-linear-task- Convert GitHub issues to Linear tasks/sync:linear-task-to-issue- Convert Linear tasks to GitHub issues/sync:sync-pr-to-task- Link pull requests to Linear tasks/sync:sync-status- Monitor GitHub-Linear sync health status/sync:bulk-import-issues- Bulk import GitHub issues to Linear/sync:cross-reference-manager- Manage cross-platform reference links/sync:sync-automation-setup- Setup automated synchronization workflows/sync:sync-conflict-resolver- Resolve synchronization conflicts automatically/sync:task-from-pr- Create Linear tasks from pull requests
Release preparation, automated deployments, rollback capabilities, containerization, and Kubernetes deployment management.
/deploy:prepare-release- Prepare and validate release packages/deploy:hotfix-deploy- Deploy critical hotfixes quickly/deploy:rollback-deploy- Rollback deployment to previous version/deploy:setup-automated-releases- Setup automated release workflows/deploy:containerize-application- Containerize application for deployment/deploy:setup-kubernetes-deployment- Configure Kubernetes deployment manifests/deploy:ci-setup- Setup continuous integration pipeline/deploy:add-changelog- Generate and maintain project changelog/deploy:changelog-demo-command- Demo changelog automation features
Documentation automation for APIs, architecture diagrams, onboarding guides, and troubleshooting documentation.
/docs:generate-api-documentation- Auto-generate API reference documentation/docs:doc-api- Generate API documentation from code/docs:create-architecture-documentation- Generate comprehensive architecture documentation/docs:create-onboarding-guide- Create developer onboarding guide/docs:migration-guide- Create migration guides for updates/docs:troubleshooting-guide- Generate troubleshooting documentation
Setup commands for development environments, linting, formatting, monitoring, database schemas, and API design.
/setup:setup-development-environment- Setup complete development environment/setup:setup-linting- Setup code linting and quality tools/setup:setup-formatting- Configure code formatting tools/setup:setup-monitoring-observability- Setup monitoring and observability tools/setup:setup-monorepo- Configure monorepo project structure/setup:migrate-to-typescript- Migrate JavaScript project to TypeScript/setup:modernize-deps- Update and modernize project dependencies/setup:design-database-schema- Design optimized database schemas/setup:create-database-migrations- Create and manage database migrations/setup:design-rest-api- Design RESTful API architecture/setup:implement-graphql-api- Implement GraphQL API endpoints/setup:setup-rate-limiting- Implement API rate limiting
Team workflow tools including standup reports, sprint planning, retrospectives, workload balancing, and knowledge management.
/team:standup-report- Generate daily standup reports/team:sprint-planning- Plan and organize sprint workflows/team:retrospective-analyzer- Analyze team retrospectives for insights/team:team-workload-balancer- Balance team workload distribution/team:issue-triage- Triage and prioritize issues effectively/team:estimate-assistant- Generate accurate project time estimates/team:session-learning-capture- Capture and document session learnings/team:memory-spring-cleaning- Clean and organize project memory/team:architecture-review- Review and improve system architecture/team:dependency-mapper- Map and analyze project dependencies/team:migration-assistant- Assist with system migration planning/team:decision-quality-analyzer- Analyze decision quality with scenario testing
Inspired by "AI agents at their most under-leveraged point" by AI News & Strategy Daily | Nate B. Jones
Simulation and modeling tools for decision analysis through scenario exploration, digital twins, and timeline compression.
/simulation:business-scenario-explorer- Multi-timeline business exploration with constraint validation/simulation:digital-twin-creator- Systematic digital twin creation with data quality checks/simulation:decision-tree-explorer- Decision branch analysis with probability weighting/simulation:market-response-modeler- Customer/market response simulation with segment analysis/simulation:timeline-compressor- Accelerated scenario testing with confidence intervals/simulation:constraint-modeler- World constraint modeling with assumption validation/simulation:future-scenario-generator- Scenario generation with plausibility scoring/simulation:simulation-calibrator- Test and refine simulation accuracy
π Comprehensive Examples Guide - Real-world usage patterns, argument templates, and command synergy workflows.
Development tools /dev:prime, /dev:all-tools contributed by IndyDevDan (YouTube: https://www.youtube.com/@indydevdan) / DislerH (GitHub: https://github.com/disler)
Task management and execution system for organizing complex projects into trackable workflows. Task decomposition, progress tracking, Git synchronization, and context preservation.
/orchestration:start- Begin a new project with intelligent task decomposition/orchestration:status- Check progress and see what's happening across all projects/orchestration:resume- Continue where you left off with full context restoration/orchestration:move- Update task status as work progresses/orchestration:commit- Create professional Git commits linked to tasks/orchestration:find- Search and discover tasks across projects/orchestration:report- Generate standup reports and executive summaries/orchestration:sync- Synchronize task status with Git commits/orchestration:remove- Remove or archive completed tasks
π Task Orchestration Guide - Complete guide with examples, workflows, and best practices for managing complex development projects.
Semantic reasoning system based on the WFGY project providing mathematical validation, persistent memory, and hallucination prevention.
Core Formula Commands (/wfgy:*):
/wfgy:init- Initialize WFGY semantic reasoning system/wfgy:bbmc- Apply semantic residue minimization/wfgy:bbpf- Execute multi-path progression/wfgy:bbcr- Trigger collapse-rebirth correction/wfgy:bbam- Apply attention modulation/wfgy:formula-all- Apply all formulas in sequence
Semantic Memory (/semantic:*):
/semantic:tree-init- Create new semantic memory tree/semantic:node-build- Record semantic nodes/semantic:tree-view- Display tree structure/semantic:tree-export- Export memory to file/semantic:tree-import- Import existing tree/semantic:tree-switch- Switch between trees
Knowledge Boundaries (/boundary:*):
/boundary:detect- Check knowledge limits/boundary:heatmap- Visualize risk zones/boundary:risk-assess- Evaluate current risk/boundary:bbcr-fallback- Execute recovery/boundary:safe-bridge- Find safe connections
Reasoning Operations (/reasoning:*):
/reasoning:multi-path- Parallel reasoning exploration/reasoning:tension-calc- Calculate semantic tension/reasoning:logic-vector- Analyze logic flow/reasoning:resonance- Measure stability/reasoning:chain-validate- Verify logic chains
Memory Management (/memory:*):
/memory:checkpoint- Create recovery points/memory:recall- Search and retrieve memories/memory:compress- Optimize tree size/memory:merge- Combine related nodes
π WFGY Documentation - Mathematical foundations, performance benchmarks, and comprehensive usage guide for semantic reasoning.
Claude Code automatically recognizes markdown files in .claude/commands/ as slash commands. Files are loaded on startup and available immediately.
Each command file needs:
- Title:
# Command Name - Description: Brief overview of what the command does
- Instructions:
## Instructionssection with detailed steps
Example minimal command (my-command.md):
# My Custom Command
Performs a specific task in my project.
## Instructions
1. **First Step**
- Do this thing
- Check that thing
2. **Second Step**
- Execute this action
- Verify the resultUse it immediately with: /namespace:my-command
Commands use the format /namespace:command-name. Each command executes a structured workflow defined in its markdown file.
Examples:
/dev:code-review- Analyze codebase for quality, security, and performance/project:create-feature dashboard- Plan, implement, and test a new feature/dev:fix-issue 123- Resolve GitHub issue with systematic approach/simulation:business-scenario-explorer Evaluate market expansion- Model business scenarios
New Feature Development:
/dev:code-review # Assess current state
/project:create-feature user-dashboard # Implement feature
/security:security-audit # Verify securityBug Fixing:
/dev:fix-issue 456 # Fix the specific issue
/dev:code-review # Verify fix qualityCode Maintenance:
/security:dependency-audit # Check for outdated dependencies
/performance:performance-audit # Identify bottlenecks
/dev:refactor-code legacy-module # Improve problematic areasStrategic Decision Making:
/simulation:constraint-modeler # Map decision constraints
/simulation:business-scenario-explorer # Explore multiple timelines
/simulation:decision-tree-explorer # Optimize decision choicesComplex Project Management:
/orchestration:start # Break down project into tasks
/orchestration:status # Monitor progress
/orchestration:resume # Continue after breaks
/orchestration:commit # Create linked Git commits- Installation Guide - Installation methods, troubleshooting, and configuration
- Customization Guide - Command modification and creation
- Development Guide - Contributing, testing, and best practices
This repository accepts contributions for slash commands, AI agents, and skills.
- Commands - New workflow commands or enhancements to existing ones
- AI Agents - Specialized agents for development tasks
- Skills - Model-invoked capabilities for recurring workflows
- Documentation - Improvements to guides and examples
- Bug Fixes - Issues with existing functionality
- Fork the repository
- Add or modify content in appropriate directories
- Test changes according to guidelines
- Submit pull request with clear description
See Development Guide for contribution guidelines, testing requirements, and quality standards.
Changelog generation is automated through GitHub Actions and manual scripts.
- GitHub Actions integration detects command additions
- Tracks new files and modifications
- Generates formatted changelog entries
- Adds summary comments to pull requests
Run the update script for manual changelog generation:
./scripts/update-changelog.shThe script performs the following operations:
- Scans command files in
.claude/commands/ - Extracts command names and descriptions
- Updates
CHANGELOG.mdwith categorized listings - Creates backup of existing changelog
- Command categorization by type
- Total count tracking
- Description extraction from source files
- Backup creation before modifications
Automated releases use Conventional Commits. Merges to main trigger the release workflow:
- Commit analysis determines version bump type
- Version updates based on commit types
- Release notes generated from commit messages
- GitHub releases created with downloadable bundles
- Changelog updated with categorized changes
fix:commits β Patch release (1.0.0 β 1.0.1)feat:commits β Minor release (1.0.0 β 1.1.0)- Breaking changes β Major release (1.0.0 β 2.0.0)
- Pull request merges with conventional commit titles
- Direct pushes to main with conventional commits
For commit format details, see CONTRIBUTING.md.
- Claude Code version 1.0 or later
- Commands work with any programming language or framework
This project includes 44 specialized AI agents from wshobson/agents, expanding our collection to 55 total agents. These external agents provide expertise in:
- Development: Backend architecture, frontend development, mobile development, GraphQL
- Languages: Python, Go, Rust, C/C++, JavaScript, SQL specialists
- Infrastructure: DevOps, cloud architecture, database administration, Terraform
- Quality: Code review, security auditing, performance engineering, test automation
Full attribution and details can be found in .claude/agents/external/wshobson/ATTRIBUTION.md.
Inspired by Anthropic's Claude Code Best Practices