# Contribution Guidelines

Please note that this project is released with a [Contributor Code of Conduct](code-of-conduct.md). By participating in this project you agree to abide by its terms.

## Issue scope

Issues are for improving the reusable Cursor rule content in this repository or reporting repository maintenance problems such as broken links, duplicate entries, formatting issues, or incorrect categories.

Do not open issues asking for help with Cursor accounts, billing, subscriptions, unofficial Cursor clients, third-party tools, account sharing, license sharing, or license bypasses. Use the official product or vendor support channels for those questions.

## Pull request author gate

Pull requests from GitHub accounts younger than 30 days are blocked by CI by default. Maintainers can override known-good contributors with the `PR_AUTHOR_AGE_ALLOWLIST` repository variable, and can adjust the threshold with `PR_AUTHOR_MINIMUM_AGE_DAYS`.

## Rule format

New and updated rules should use the modern Cursor Project Rules format: one `.mdc` file under `rules/` with `description`, `globs`, and `alwaysApply` frontmatter.

## Adding an awesome list

Please ensure your pull request adheres to the [list of guidelines](pull_request_template.md).

## Creating your own awesome list

To create your own list, check out the [instructions](create-list.md).

## Adding something to an awesome list

If you have something awesome to contribute to an awesome list, this is how you do it.

You'll need a [GitHub account](https://github.com/join)!

1. Access the awesome list's GitHub page. For example: https://github.com/sindresorhus/awesome
2. Click on the `readme.md` file: ![Step 2 Click on Readme.md](https://cloud.githubusercontent.com/assets/170270/9402920/53a7e3ea-480c-11e5-9d81-aecf64be55eb.png)
3. Now click on the edit icon. ![Step 3 - Click on Edit](https://cloud.githubusercontent.com/assets/170270/9402927/6506af22-480c-11e5-8c18-7ea823530099.png)
4. You can start editing the text of the file in the in-browser editor. Make sure you follow the guidelines above. You can use [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/). ![Step 4 - Edit the file](https://cloud.githubusercontent.com/assets/170270/9402932/7301c3a0-480c-11e5-81f5-7e343b71674f.png)
5. Say why you're proposing the changes, and then click on "Propose file change". ![Step 5 - Propose Changes](https://cloud.githubusercontent.com/assets/170270/9402937/7dd0652a-480c-11e5-9138-bd14244593d5.png)
6. Submit the [pull request](https://help.github.com/articles/using-pull-requests/)!

## Updating your Pull Request

Sometimes, a maintainer of an awesome list will ask you to edit your Pull Request before it is included. This is normally due to spelling errors or because your PR didn't match the awesome-* list guidelines.

[Here](https://github.com/RichardLitt/knowledge/blob/master/github/amending-a-commit-guide.md) is a write up on how to change a Pull Request and the different ways you can do that.
