Skip to content
TakoAPI
Back to skills

cursor-rule-framework

by fbrbovic

Cursor
โ€”Not yet rated
Your rating

Brief

Starter Template with rules for Vibe Coding with Cursor AI IDE - Built for Vibe Coding

Description

# ๐ŸŽฏ Cursor Rule Framework

> **Professional Cursor AI Rule Framework for "Vibe Coding" - Co-Built by Engineers & AI, for Engineers & AI** 

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
[![Cursor IDE](https://img.shields.io/badge/Cursor-IDE-black.svg)](https://cursor.com/)

> โญ  We have migrated to a NEW REPO: https://github.com/fbrbovic/ai-epic-framework with a brand NEW VERSION ๐Ÿš€
> Streamlined and improved version now available for many AI Coding IDE, not only cursor 
> You can still use this framework, it is still valid since it is all context based. 


A comprehensive, production-ready framework of Cursor AI rules and best practices designed to supercharge your development workflow. If you wanted to do vibe coding but didn't know how to start. 

## ๐Ÿš€ What Is This?

This is a **starter template** and **rule framework** that enables "Vibe Coding" - a development methodology where you work seamlessly with Cursor AI to build high-quality software faster. It includes:

- **๐Ÿ“‹ Structured Rule System** - Organized, maintainable cursor rules with proper metadata
- **๐Ÿ—๏ธ Architecture Guidelines** - Enterprise-ready patterns and conventions  
- **โšก Workflow Management** - Blueprint โ†’ Construct โ†’ Validate development phases
- **๐Ÿ“ˆ Epic Planning** - Large-scale project management with AI assistance
- **๐Ÿ”ง Development Standards** - Code quality, testing, and documentation practices

## ๐ŸŽฏ Who This Is For

- **Senior Engineers** building production applications with Cursor AI
- **Engineering Teams** wanting consistent AI-assisted development practices
- **Technical Architects** designing scalable systems with AI pair programming
- **Open Source Maintainers** looking for AI-first development workflows

## ๐Ÿ™ Acknowledgments

This framework builds upon and is inspired by the excellent work from [@kleosr/cursorkleosr](https://github.com/kleosr/cursorkleosr). Their pioneering approach to autonomous AI workflows for Cursor IDE, particularly the two-file system with `project_config.md` and `workflow_state.md`, provided foundational insights for our structured rule framework. We've extended these concepts into a comprehensive rule management system while maintaining the core philosophy of making AI-assisted development more autonomous and consistent.

Special thanks to the original contributors:
- [@atalas](https://github.com/atalas) 
- [@Guayusa](https://github.com/Guayusa)
- [@stevejb](https://github.com/stevejb)
- All contributors to the [kleosr/cursorkleosr](https://github.com/kleosr/cursorkleosr) concepts

## โญ Key Features

### ๐Ÿ“ **Structured Rule Organization**
- **Location Policy**: All rules properly organized in `.cursor/rules/`
- **Metadata Preservation**: Proper MDC format with glob patterns and scope
- **Hierarchical Organization**: Global โ†’ Domain โ†’ Feature-specific rules

### ๐Ÿญ **Enterprise-Ready Workflow**
- **AI-Integrated Development**: Blueprint โ†’ Construct โ†’ Validate with epic context
- **Epic Management**: Large initiative planning and tracking
- **Quality Gates**: Automated testing, linting, and validation
- **Documentation Standards**: Comprehensive project documentation

### ๐Ÿง  **AI-First Development**
- **User Rules Integration**: Install `user-rules-template.mdc` in Cursor IDE for workflow activation
- **Context-Aware Rules**: Rules that adapt to your project structure
- **Intelligent Workflows**: AI-guided development with human oversight
- **Knowledge Preservation**: Organizational memory in rule format
- **Best Practice Enforcement**: Automatic adherence to coding standards

## ๐Ÿš€ Quick Start

### 1. **Use This Template**
```bash
# Option A: Use GitHub template (recommended)
# Click "Use this template" โ†’ "Create a new repository"

# Option B: Clone directly
git clone https://github.com/fbrbovic/cursor-rule-framework.git my-project
cd my-project
rm -rf .git && git init
```

### 2. **Add to Existing Project** 
```bash
# Navigate to your existing project
cd your-existing-project

# Create the cursor rules directory
mkdir -p .cursor/rules

# Download the essential framework files
curl -o .cursor/rules/cursor-rules-management.mdc \
  https://raw.githubusercontent.com/fbrbovic/cursor-rule-framework/main/.cursor/rules/cursor-rules-management.mdc

curl -o .cursor/rules/project-config.mdc \
  https://raw.githubusercontent.com/fbrbovic/cursor-rule-framework/main/.cursor/rules/project-config.mdc

curl -o .cursor/rules/workflow-state.mdc \
  https://raw.githubusercontent.com/fbrbovic/cursor-rule-framework/main/.cursor/rules/workflow-state.mdc

curl -o .cursor/rules/epics.mdc \
  https://raw.githubusercontent.com/fbrbovic/cursor-rule-framework/main/.cursor/rules/epics.mdc

curl -o .cursor/rules/architecture.mdc \
  https://raw.githubusercontent.com/fbrbovic/cursor-rule-framework/main/.cursor/rules/architecture.mdc

curl -o .cursor/rules/rules.mdc \
  https://raw.githubusercontent.com/fbrbovic/cursor-rule-framework/main/.cursor/rules/rules.mdc

curl -o .cursor/rules/user-rules-template.mdc \
  https://raw.githubusercontent.com/fbrbovic/cursor-rule-framework/main/.cursor/rules/user-rules-template.mdc
```

**๐Ÿ’ก Tip**: For comprehensive migration guidance, see our **[Migration Guide](docs/migration-guide.md)** with step-by-step instructions for existing projects.

### 3. **Install User Rules Template** โš ๏ธ **CRITICAL STEP**
```bash
# Copy the user rules template to Cursor IDE settings
# This enables the framework workflow system
code .cursor/rules/user-rules-template.mdc
```

**Important**: Copy the entire content of `user-rules-template.mdc` and paste it into:
- **Cursor IDE** โ†’ **Cursor** โ†’ **Settings** โ†’ **Cursor Settings** โ†’ **Rules** โ†’ **User Rules**

This template is **required** for the AI-driven workflow system (Blueprint โ†’ Construct โ†’ Validate with epic integration) to function properly.

### 4. **Customize Project Configuration**
```bash
# Edit your project-specific settings
code .cursor/rules/project-config.mdc
```

Update the following sections:
- **Project Goal**: Your specific project objectives
- **Tech Stack**: Your languages, frameworks, and tools
- **Critical Patterns**: Your team's conventions and standards

### 5. **Initialize Your Rules**
The framework comes with essential rules pre-configured:
- `cursor-rules-management.mdc` - Rule organization and management
- `project-config.mdc` - Project-specific configuration
- `workflow-state.mdc` - Development workflow management
- `epics.mdc` - Large initiative planning
- `rules.mdc` - **Master rule registry** (accumulates custom rules as you develop)

### 6. **Start Vibe Coding**
```bash
# Open in Cursor IDE
cursor .

# Your AI assistant now has access to your structured rules!
# Try asking: "Help me plan a new feature following our workflow"
```

## ๐Ÿ“š Documentation

### ๐Ÿ  **[๐Ÿ“– Complete Documentation Hub](docs/README.md)**
**โ†’ Comprehensive guides, tutorials, and references for mastering the framework**

### Core Concepts
- **[Architecture Guide](docs/architecture.md)** - How to use the architecture rule for project architecture management
- **[Rule Organization](docs/rule-organization.md)** - How rules are structured and managed
- **[Workflow System](docs/workflow-system.md)** - Blueprint โ†’ Construct โ†’ Validate phases
- **[Epic Planning](docs/epic-planning.md)** - Managing large initiatives with AI
- **[Best Practices](docs/best-practices.md)** - Proven patterns for AI-assisted development

### Advanced Topics
- **[Custom Rules](docs/custom-rules.md)** - Creating domain-specific rules
- **[Team Integration](docs/team-integration.md)** - Multi-developer workflows
- **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions

### Examples
- **[Frontend Setup](examples/frontend-setup/README.md)** - React/Vue.js project setup guide
- **[React TypeScript](examples/frontend-react-typescript/README.md)** - Complete React TypeScript example
- **[Backend API](examples/backend-api/README.md)** - Node.js/Python API development
- **[Full-Stack App](examples/fullstack-app/README.md)** - Complete application template
- **[Monorepo](examples/monorepo/README.md)** - Multi-package repository setup

## ๐Ÿ› ๏ธ Framework Structure

```
cursor-rule-framework/
โ”œโ”€โ”€ .cursor/
โ”‚   โ””โ”€โ”€ rules/                    # All cursor rules live here
โ”‚       โ”œโ”€โ”€ user-rules-template.mdc      # โš ๏ธ INSTALL IN CURSOR SETTINGS
โ”‚       โ”œโ”€โ”€ cursor-rules-management.mdc  # Rule system management
โ”‚       โ”œโ”€โ”€ project-config.mdc            # Project configuration
โ”‚       โ”œโ”€โ”€ workflow-state.mdc            # Development workflow
โ”‚       โ”œโ”€โ”€ epics.mdc                     # Epic planning
โ”‚       โ”œโ”€โ”€ rules.mdc                     # Master rule registry (dynamic)
โ”‚       โ””โ”€โ”€ architecture.mdc              # Architecture guidelines
โ”œโ”€โ”€ docs/                         # Comprehensive documentation
โ”œโ”€โ”€ examples/                     # Usage examples and templates
โ”œโ”€โ”€ CONTRIBUTING.md              # Contribution guidelines
โ”œโ”€โ”€ CHANGELOG.md                 # Version history
โ””โ”€โ”€ README.md                    # This file
```

## ๐Ÿ—๏ธ Core Methodology: Vibe Coding

**Vibe Coding** is our term for seamless AI-assisted development where:

1. **๐ŸŽฏ Blueprint Phase** - Plan thoroughly with AI assistance
2. **๐Ÿ”จ Construct Phase** - Implement with AI pair programming
3. **โœ… Validate Phase** - Ensure quality with AI-powered testing
4. **๐Ÿ“ˆ Epic Management** - AI-driven initiative planning with natural language interaction

This methodology ensures:
- **High Code Quality** through structured validation
- **Maintainable Architecture** through automatic architecture integration and documentation
- **Team Collaboration** through shared standards and architectural decisions
- **Knowledge Preservation** through automatically updated documentation and rules
- **Architectural Consistency** through AI-driven architecture validation and updates

## ๐Ÿค– Built With Its Own Framework

**This entire project was built using the Cursor Rule Framework itself** - a perfect example of "eating our own dog food" and demonstrating the power of human-AI collaboration.

### **The Meta-Development Process**

#### **๐ŸŽฏ Blueprint Phase**
- **AI-Assisted Planning**: Used Cursor AI to analyze existing cursor rule patterns and design the comprehensive framework structure
- **Architecture Design**: Planned the three-phase methodology, rule organization patterns, and documentation structure through collaborative AI sessions
- **Epic Planning**: Broke down the framework development into manageable epics (Core Rules โ†’ Documentation โ†’ Examples โ†’ Team Integration)

#### **๐Ÿ”จ Construct Phase**  
- **Collaborative Writing**: AI and human developer working together to write all 15,000+ lines of documentation, examples, and rule templates
- **Pattern Recognition**: AI identified recurring patterns across cursor rule usage and codified them into reusable templates
- **Content Generation**: Used AI to generate comprehensive examples, troubleshooting guides, and best practices based on real-world scenarios

#### **โœ… Validate Phase**
- **Quality Assurance**: AI-assisted review of rule consistency, documentation completeness, and example accuracy
- **Link Validation**: Systematic verification of all documentation cross-references and example links
- **Framework Testing**: Applied the framework to itself to ensure meta-circular consistency

### **Real Results**

```bash
# Framework Development Metrics
๐Ÿ“Š Total Lines: 15,000+ lines of documentation and rules
โšก Development Time: 2 days (would have taken 1-2 months without AI)
๐ŸŽฏ Consistency Score: 95%+ across all documentation
๐Ÿ”„ Iterations: 12 major revisions through Blueprint โ†’ Construct โ†’ Validate cycles
๐Ÿ“š Example Projects: 5 comprehensive examples generated with AI assistance
```

### **AI-Human Collaboration Highlights**

- **๐Ÿ“– Documentation**: AI generated initial drafts, human refined for accuracy and voice
- **๐Ÿ”ง Rule Templates**: AI identified common patterns, human validated practical applicability  
- **๐Ÿ’ก Examples**: AI created comprehensive code examples, human ensured real-world relevance
- **๐Ÿ› Problem Solving**: AI caught inconsistencies and gaps, human provided strategic direction
- **๐ŸŽจ Structure**: Human designed the overall architecture, AI filled in detailed implementations

### **Why This Matters**

This recursive development process proves the framework's effectiveness:

- **๐Ÿš€ Accelerated Development**: AI assistance reduced documentation time by 70%
- **๐Ÿ“ˆ Enhanced Quality**: Systematic validation caught edge cases human review would miss
- **๐Ÿ”„ Continuous Improvement**: Used workflow state tracking to manage complex, multi-week development
- **๐Ÿ“ Knowledge Capture**: Every pattern discovered was immediately codified into reusable rules
- **๐ŸŽฏ Consistency**: AI ensured consistent voice, structure, and examples across 20+ documentation files

**The result?** A comprehensive, production-ready framework that demonstrates exactly what's possible when humans and AI collaborate effectively with structured rules and workflows.

## ๐Ÿค Contributing

We welcome contributions from the community! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Quick Contribution Steps
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/amazing-rule`
3. Make your changes following our [Rule Guidelines](docs/custom-rules.md)
4. Test your changes with example projects
5. Submit a pull request with clear description

## ๐Ÿ“ˆ Roadmap

- [ ] **v1.1** - Team collaboration features

## ๐Ÿ› Issues & Support

- **Bug Reports**: [GitHub Issues](https://github.com/fbrbovic/cursor-rule-framework/issues)
- **Feature Requests**: [GitHub Discussions](https://github.com/fbrbovic/cursor-rule-framework/discussions)
- **Documentation**: [Wiki](https://github.com/fbrbovic/cursor-rule-framework/wiki)

## ๐Ÿ“„ License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## ๐Ÿ™ Acknowledgments

- **Cursor Team** - For building an amazing AI-powered IDE
- **Contributors** - For sharing knowledge and improving the framework
- **Community** - For feedback and real-world usage patterns

---

**Built with โค๏ธ for the Cursor AI community**

*Ready to start Vibe Coding? [Get started now](#-quick-start) or [explore the complete documentation](docs/README.md)!*

Installation

Install the skill from https://github.com/fbrbovic/cursor-rule-framework

This skill is not published on the ClawHub registry. Paste the prompt into your coding agent โ€” Claude Code, Cursor, Codex โ€” and it will install the skill straight from the source repository.

Open the repository

Links