vibe-codex

Automated development rules and workflow enforcement for modern software teams

Migration Notice: This repository has evolved from the original mandatory-rules-checker project. If you were using the legacy system, please see the migration guide. Legacy compatibility is maintained temporarily in the legacy/ and scripts/ directories.

🚀 Quick Start

1npx vibe-codex init

📋 What is vibe-codex?

vibe-codex automatically enforces development best practices through:

• 🔒 Pre-commit security checks
• 🧪 Test coverage requirements
• 📝 Documentation standards
• 🔄 PR/Issue workflow automation
• 🚀 Deployment validations

💻 Installation

One-time use (recommended)

1npx vibe-codex init

Global installation

1npm install -g vibe-codex
2vibe-codex init

As project dependency

1npm install --save-dev vibe-codex

🎯 Basic Usage

Initialize in your project

1cd your-project
2npx vibe-codex init
3
4# With options
5npx vibe-codex init --type fullstack --minimal
6
7# With advanced hooks
8npx vibe-codex init --with-advanced-hooks "issue-tracking,pr-management"

Configure modules

1npx vibe-codex config

Validate your project

1npx vibe-codex validate

Update to latest rules

1npx vibe-codex update

⚙️ Configuration

vibe-codex uses a .vibe-codex.json file for configuration:

1{
2  "modules": {
3    "testing": {
4      "framework": "jest",
5      "coverage": { "threshold": 80 }
6    },
7    "github": {
8      "features": ["pr-checks", "issue-tracking"]
9    }
10  }
11}

See Configuration Guide for all options.

📦 Available Modules

• Core - Basic git workflow and security
• Testing - Test frameworks and coverage
• GitHub - PR/Issue automation
• Deployment - Platform-specific checks
• Documentation - README and docs standards

🔧 Advanced Hooks (Optional)

Additional development workflow automation:

• Issue Tracking - Automatic issue updates and progress tracking
• PR Management - PR health checks and review enforcement
• Quality Gates - Test coverage and security validations
• Context Management - Keep project documentation up to date

Install during init or with: npx vibe-codex init --with-advanced-hooks "issue-tracking,quality-gates"

See Modules Guide for details.

📚 Documentation

• Getting Started - Installation and setup guide
• Configuration - Configuration options
• CLI Reference - Command line usage
• API Reference - Programmatic usage
• Modules - Available modules
• Migration Guide - Upgrading from v1.x
• Troubleshooting - Common issues

🤝 Contributing

See CONTRIBUTING.md

📄 License

MIT © vibe-codex contributors