# Claude Modular

> Production-ready modular Claude Code framework with 30+ commands, token optimization, and MCP server integration. Achieves 2-10x productivity gains through systematic command organization and hierarchical configuration.

- **Type:** MCP server
- **Install:** `agentstack add mcp-oxygen-fragment-claude-modular`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [oxygen-fragment](https://agentstack.voostack.com/s/oxygen-fragment)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [oxygen-fragment](https://github.com/oxygen-fragment)
- **Source:** https://github.com/oxygen-fragment/claude-modular

## Install

```sh
agentstack add mcp-oxygen-fragment-claude-modular
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

  When and why to use this command
  Prerequisites and dependencies
  Step-by-step implementation
  Quality checks and acceptance criteria
  Concrete usage examples

```

## 📖 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 template
3. Include comprehensive examples
4. Test with realistic scenarios

### Adapting for Your Stack
1. Edit `templates/CLAUDE.md.template` with your technologies
2. Update command examples for your build tools
3. Customize quality gates for your requirements
4. Add stack-specific validation rules

## 📊 Performance Metrics

### Token Optimization Results
- **50-80% token savings** vs monolithic setups
- **Sub-30-second** setup time for new projects
- **20+ core commands** covering 80% of workflows
- **Progressive disclosure** reduces context overhead

### Quality Improvements
- **Consistent code review** quality
- **Automated testing** coverage
- **Standardized deployment** procedures
- **Comprehensive documentation** generation

## 🛠️ Integration

### MCP Server Support
- **Memory MCP** - Context persistence between sessions
- **Git MCP** - Version control integration
- **Filesystem MCP** - File operations and watching
- **Linear MCP** - Issue tracking integration
- **Notion MCP** - Documentation synchronization

### CI/CD Integration
- **GitHub Actions** support
- **Quality gate** enforcement
- **Automated testing** pipelines
- **Deployment automation**

## 📚 Examples

### Basic Usage
```bash
# Setup new project
/project:setup-environment

# Create a feature
/project:create-feature user-authentication --type=service

# Review code
/dev:code-review --focus=security,performance

# Deploy to staging
/deploy:deploy-staging
```

### Advanced Workflows
```bash
# Complex feature development
/project:create-feature payment-processing --framework=express --database=postgresql

# Comprehensive testing
/test:generate-tests --types=unit,integration,e2e
/test:coverage-analysis --target=90%

# Production deployment
/deploy:prepare-release --type=major
/deploy:deploy-staging --validate
/deploy:rollback-procedure --preserve-data
```

## 🤝 Contributing

1. Fork the repository
2. Create feature branch: `git checkout -b feature/new-command`
3. Add your command following the XML structure
4. Include comprehensive examples and tests
5. Update documentation
6. Submit pull request

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

Based on research papers:
- "The modular Claude Code implementation playbook"
- "Optimizing Agentic Development Workflows with Claude Code"

## 📞 Support

- **Issues**: [GitHub Issues](https://github.com/your-username/claude-modular/issues)
- **Discussions**: [GitHub Discussions](https://github.com/your-username/claude-modular/discussions)
- **Documentation**: [Wiki](https://github.com/your-username/claude-modular/wiki)

---

**If you want to help me out you can [](https://ko-fi.com/I3I5ZJUA3)**

**Start building better, faster, and more consistently with Claude Code's modular framework.**

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [oxygen-fragment](https://github.com/oxygen-fragment)
- **Source:** [oxygen-fragment/claude-modular](https://github.com/oxygen-fragment/claude-modular)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-oxygen-fragment-claude-modular
- Seller: https://agentstack.voostack.com/s/oxygen-fragment
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.