Cursor Rules - Smart Development Assistant

# Cursor Rules - Smart Development Assistant

> **Advanced Cursor IDE rules system for intelligent code generation with context-aware routing and specialized workflows**

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Cursor Compatible](https://img.shields.io/badge/Cursor-Compatible-blue.svg)](https://cursor.com/)
[![Rules Format](https://img.shields.io/badge/Format-MDC-green.svg)](https://docs.cursor.com/en/context/rules)

## 🎯 Overview

This repository contains a production-ready Cursor rules system that transforms your AI-assisted development workflow. Unlike simple `.cursorrules` files, this system implements **intelligent context routing** with specialized rules for different development scenarios.

### Key Features

✅ **Smart Classification**: Automatically detects request intent (bugfix, feature, cleanup, etc.)  
✅ **Context-Aware Routing**: Routes to specialized rules based on file patterns and user intent  
✅ **SOLID Principles Enforcement**: Built-in architectural constraints and validation  
✅ **Evidence-Based Decisions**: No assumptions, everything backed by measurable criteria  
✅ **Self-Healing Redirects**: Intelligent fallbacks when rules conflict  
✅ **Production Ready**: Used in real projects with proven results  

## 🏗️ Architecture

### BMAD-Inspired Modular Design
```
.cursor/rules/
├── main-router.mdc           # 🎯 Smart classification & routing hub
├── cleanup-rules.mdc         # 🧽 Technical debt reduction
├── feature-rules.mdc         # ✨ New functionality (SOLID-compliant)
├── bugfix-rules.mdc          # 🛠️ Minimal error correction
├── exploration-rules.mdc     # 🧪 POC development & validation
├── migration-rules.mdc       # 🚚 Technology migration strategies
├── optimization-rules.mdc    # ⚡ Performance improvements
└── compliance-rules.mdc      # 🔒 Legal & security requirements
```

### How It Works
```mermaid
flowchart TD
    A[📥 User Request] --> B[🎯 Main Router]
    B --> C{🧩 Intent Classification}
    
    C -->|High Confidence >80%| D[Direct Routing]
    C -->|Medium 50-80%| E[Confirm with User]
    C -->|Low <50%| F[Ask Clarification]
    
    E --> G[User Confirmation]
    F --> H[Targeted Questions]
    G --> D
    H --> D
    
    D --> I{📋 Specialized Rules}
    
    I -->|Priority 1| J1[🛠️ Bugfix Rules]
    I -->|Priority 2| J2[🔒 Compliance Rules]
    I -->|Priority 3| J3[🧪 Exploration Rules]
    I -->|Priority 4| J4[⚡ Optimization Rules]
    I -->|Priority 5| J5[🚚 Migration Rules]
    I -->|Priority 6| J6[🧽 Cleanup Rules]
    I -->|Default| J7[✨ Feature Rules]
    
    J1 --> K[🔄 Smart Validation]
    J2 --> K
    J3 --> K
    J4 --> K
    J5 --> K
    J6 --> K
    J7 --> K
    
    K --> L{🚨 Rule Violation?}
    L -->|Yes| M[Intelligent Redirect]
    L -->|No| N[Execute Specialized Workflow]
    
    M --> I
    N --> O[✅ Success with Evidence]
```

## 🚀 Quick Start

### 1. Clone and Install
```bash
# Clone this repository
git clone https://github.com/fxbravo/Cursor_Rules.git

# Navigate to your project
cd your-project/

# Copy the rules structure
cp -r Cursor_Rules/.cursor .

# Verify installation
ls -la .cursor/rules/
```

### 2. Verify in Cursor
1. Open your project in Cursor IDE
2. Go to **Settings** → **General** → **Project Rules**
3. Confirm all rules appear with correct status:
   - ✅ `main-router.mdc` - Always Applied
   - 📋 Other rules - Auto Attached/Agent Requested

### 3. Test the System
```
# Try a test request in Cursor
"I want to add a login feature to my app"

# Expected response:
🎯 **CATÉGORIE:** FEATURE - New functionality request - Confiance: 95%
Routing to @feature-rules.mdc for SOLID-compliant implementation...
```

## 📋 Rule Categories & Priorities

### Hierarchical Classification (Priority Order)
1. **🛠️ BUGFIX** - Critical: Malfunction or existing error
2. **🔒 COMPLIANCE** - Legal/audit/security requirements  
3. **🧪 EXPLORATION** - POC development and technical validation
4. **⚡ OPTIMIZATION** - Performance improvements with evidence
5. **🚚 MIGRATION** - Technology changes and upgrades
6. **🧽 CLEANUP** - Technical debt reduction
7. **✨ FEATURE** - New functionality (default fallback)

### Smart Ambiguity Resolution
- **Multiple matches**: Choose highest priority + confirm
- **No clear match**: Offer 3 specific options
- **Context needed**: Ask targeted questions

## 🎭 Specialized Workflows

### 🧽 Cleanup Rules
- **Mission**: Reduce technical debt without breaking functionality
- **Constraints**: Never create files, user approval for deletions
- **Success Metrics**: Unused imports removed, duplications merged, tests passing

### ✨ Feature Rules  
- **Mission**: Add functionality while preserving architecture
- **Constraints**: Extend before create, maintain SOLID principles
- **Success Metrics**: Working feature, maximum reuse, zero duplication

### 🛠️ Bugfix Rules
- **Mission**: Fix errors with minimal changes
- **Constraints**: Max 5 lines changed, n

... (truncated)