claude-modular

# Claude Code Modular Framework A comprehensive, production-ready modular framework template for Claude Code that achieves 2-10x productivity gains through proven patterns, token optimization, and systematic development workflows. ## 🚀 Quick Start ### 1. Clone and Setup ```bash git clone https://github.com/your-username/claude-modular.git cd claude-modular cp templates/CLAUDE.md.template CLAUDE.md # Edit CLAUDE.md with your project-specific details ``` ### 2. Initialize Your Project ```bash # Copy the .claude directory to your project root cp -r .claude /path/to/your/project/ # Customize configuration for your environment cd /path/to/your/project/.claude/config # Edit settings.json, development.json, etc. ``` ### 3. Start Using Commands ```bash # In your project with Claude Code /project:setup-environment /project:create-feature user-authentication /test:generate-tests /dev:code-review ``` ## 📚 Features ### ✅ Token Optimization (50-80% savings) - **Progressive disclosure** - Load only necessary context - **Modular instructions** - Just-in-time command loading - **Context compression** - Efficient context management - **Smart boundaries** - Automatic context switching ### ✅ 20+ Production-Ready Commands - **Project Management** - Feature creation, component scaffolding - **Development Workflow** - Code review, refactoring, debugging - **Testing Automation** - Test generation, coverage analysis - **Deployment** - Release preparation, staging deployment, rollback - **Documentation** - API docs, README updates, architecture review ### ✅ Environment-Specific Configuration - **Development** - Relaxed rules, verbose logging - **Staging** - Quality gates, review requirements - **Production** - Strict security, multi-factor auth ### ✅ Security-First Design - **Secret scanning** prevention - **Permission validation** for sensitive operations - **Audit logging** for compliance - **Environment variable** management ## 🏗️ Architecture ### Directory Structure ``` your-project/ ├── .claude/ # Framework configuration │ ├── config/ # Environment-specific settings │ │ ├── settings.json # Base configuration │ │ ├── development.json # Dev environment │ │ ├── staging.json # Staging environment │ │ └── production.json # Production environment │ └── commands/ # Modular command library │ ├── project/ # Project management │ ├── development/ # Development workflow │ ├── testing/ # Testing automation │ ├── deployment/ # Deployment operations │ └── documentation/ # Documentation generation ├── CLAUDE.md # Your project-specific configuration └── [your project files] ``` ### Command Structure Each command follows a proven XML structure: ```xml <instructions> <context>When and why to use this command</context> <requirements>Prerequisites and dependencies</requirements> <execution>Step-by-step implementation</execution> <validation>Quality checks and acceptance criteria</validation> <examples>Concrete usage examples</examples> </instructions> ``` ## 📖 Command Reference ### Project Management - `/project:create-feature` - Full feature scaffolding with tests and docs - `/project:scaffold-component` - Component creation with boilerplate - `/project:setup-environment` - Development environment initialization ### Development Workflow - `/dev:code-review` - Structured code review with automated analysis - `/dev:refactor-analysis` - Code improvement recommendations - `/dev:debug-session` - Systematic debugging and problem solving ### Testing - `/test:generate-tests` - Comprehensive test suite generation - `/test:coverage-analysis` - Test coverage assessment and improvement - `/test:integration-tests` - Integration test creation and execution ### Deployment - `/deploy:prepare-release` - Release preparation with quality gates - `/deploy:deploy-staging` - Staging deployment with validation - `/deploy:rollback-procedure` - Emergency rollback execution ### Documentation - `/docs:api-docs` - API documentation generation - `/docs:update-readme` - README maintenance and updates - `/docs:architecture-review` - Architecture documentation and review ## ⚙️ Configuration ### Environment Configuration The framework supports layered configuration inheritance: ```json // Base settings.json { "defaults": { "max_tokens_per_session": 50000, "progressive_disclosure": true } } // development.json overrides { "extends": "./settings.json", "overrides": { "defaults": { "max_tokens_per_session": 100000 } } } ``` ### Security Configuration ```json { "security": { "require_env_vars": true, "audit_logging": true, "permission_validation": true, "secret_scanning": true } } ``` ## 🔧 Customization ### Creating Custom Commands 1. Create a new command file in appropriate category 2. Follow the XML structure tem