A Study of Cursorrules Files in GitHub Open Source Projects

2026-08-11

AI Summary

Configuration-based prompt files such as `.cursorrules` are increasingly prevalent in AI-assisted programming, yet their usage and evolution remain underexplored. This study presents the first empirical analysis of 12,110 `.cursorrules` files across 11,427 GitHub repositories, combining quantitative statistics with qualitative coding of 65 representative samples to uncover how developers articulate programming intent and engineering practices through these files. We develop a coding schema encompassing 65 code-related categories and find that `.cursorrules` emerged rapidly around mid-2024, predominantly in small-scale personal projects. Their content primarily emphasizes code quality and maintainability, with limited attention to security concerns, and exhibits strong thematic continuity with existing `.mdc` standard files.

Abstract

Prompts are the primary mechanism for communicating with AI agents, and they directly influence the quality and reliability of AI-generated code. As AI-assisted programming becomes widely adopted, modern tools increasingly combine dynamic conversational prompts with static configuration-like prompt files. Despite the growing focus on prompt engineering, prior research has primarily focused on conversational prompts, while prompt files remain understudied. To address this gap, we conduct an empirical study of configuration prompt files in Cursor, a widely used AI-assisted code editor. We collect and analyze over 12,110 .cursorrules files from 11,427 GitHub repositories to characterize their distribution, evolution, and maintenance. Complementing this, we perform qualitative analysis on a random sample of 65 prompt files and develop a 65-code codebook capturing how developers express programming intent, project context, engineering practices, and security considerations. Our results show that .cursorrules files emerged rapidly from mid-2024. Their adoption is concentrated in small-scale, low-activity, single-maintainer repositories, suggesting toy projects rather than professional development. The content of prompt files is dominated by guidance on code quality and engineering practices, project structure and configuration, and maintainability, while security-related content appears less frequently. Our analysis shows that there is a continuity of themes and topics between the now-legacy .cursorrules files and the current standard .mdc files.

Problem

• prompt files
• AI-assisted programming
• Cursor
• empirical study
• configuration prompts

Innovation

• prompt files
• AI-assisted programming
• empirical study
• Cursor
• prompt engineering