cursorrules 🌸

A standard library of rules for Cursor, inspired by geoffrey huntley @ghuntley's "You are using Cursor AI incorrectly..." and borrowing heavily from Brian Madison @bmadcode's BMAD Method.

🚀 Installation

npx @usrrname/cursorrules

By default, the package saves .cursor/ folder inside a output/ directory at your current working directory.

But if you're inside the root of a project folder, running npx @usrrname/cursorrules --flat will save the .cursor/ folder to the root of the project, and then you're ready to go!

Command Options

Flag	Description
-h, --help	Display help instructions
-i, --interactive	Interactive Rule Selection
-f, --flat	Install without parent directory
-o, --output	Set output directory (Default: .cursor/)
-v, --version	Show package version

✨ Featured AI Agents

Meet our delightfully (neuro)diverse team of AI assistants:

• SailorScrum - A supportive leader who helps you plan and track your projects in the spirit of Sailor Moon.
• KawaiiSamurai - An enthusiastic otaku developer who makes coding kawaii~
• BasicDev - A perfectly adequate corporate programmer
• SageDaddy - A battle-tested veteran developer with 20 years of wisdom
• Spellchuck - A meticulous documentation diva (that's me! ✨)
• ThirstySimp - An anxious but well-meaning trend-conscious developer
• qwoof - A blunt, opinionated, quality assurance anthro-wolf.
• Godmode - A gentle, battle-hardened devops superagent
• Fair Witness - An agent that analyzes topics using five functions: observer, evaluator, analyst, synthesist, and communicator

For more, see modes.json

:new: The Fair Witness Framework🪄📜

It can be hard to get a neutral or objective analysis of a topic. This agent provides structured analysis using Function-Epistemic Approaches from the Fair Witness framework. You can customize the analysis with:

• Functions: Choose which functions to include (observer, evaluator, analyst, synthesist, communicator)
• Complexity: Set detail level (low, moderate, high)
• Tone: Adjust style (dry, engaging, vivid)
• Length: Control output size (low, moderate, high)

# Basic analysis
Use Fair Witness to analyze artificial intelligence in healthcare

# Customized analysis
Use Fair Witness to analyze climate change with functions: observer, synthesist, complexity: low, tone: engaging.

# Compare multiple topics

Use Fair Witness to compare Python, JavaScript, and TypeScript with functions:  evaluator, analyst, communicator. Include sources. // includes web-based search results

:warning: You will find that different models will produce differing results.

See Examples of using the Fair Witness Framework

🤖 Supported AI Models

This project supports models supported by Cursor.

For the complete list of supported models, configuration guidelines, and selection recommendations, see Cursor's Supported Models Documentation.

About

This is an experiment to see if I can use Cursor to create a library of rules and agents that will aid in bootstrapping other projects with my own preferences. Part way there, I tried making the agents more fun to work with. It's kind of like playing the Sims.

Principles:

• uses Cursor latest version
• TRY to prompt and use the agent/composer to reach goals as much as possible

📁 Project Structure

On the meta level, the project is structured as follows:

.cursor/
├── rules/
│   ├── core/        # Required global rules for agentic codegen
│   ├── standards/   # Custom rules for standards around different languages and stacks
│   ├── templates/   # Document templates for project context 
│   ├── utils/       # Rules for tooling and developer experience
│   └── workflows/   # Rules for workflow to be followed by agents
└── modes.json       # Custom agent configurations

Any request to update or add a rule will be saved in the rules/ folder.

See docs for more information on the custom agents.

A project that uses these cursor rules and agents will generate the following structure, which is as follows:

.cursor/.ai/
├── story-#.story.md | task-#.task.md # User story and task files generated by the lean workflow
├── architecture/
│   ├── high-level-architecture.md
│   └── decision-records/
├── backlog/
│   └── story-#.story.md
└── spikes/
    └── spike-#.spike.md

📝 Release Notes & Changelog Generation

In the enablement of complete laziness, I tried getting Cursor to release from chat.

:construction: Automate Release Workflow :construction:

Use with caution. This isn't perfect.

Create a release with a version bump, generate release notes and changelog, and update the version in package.json.

Usage Examples:

In Agent, or Manual mode, you can use the following commands to generate release notes:

# Automate release
Create/Prepare a release

# Generate release notes with automatic version bump detection
[Create|Generate] release notes

# Specify version bump upfront
Create a major release
Create a minor release  
Create a patch release

If you don't specify a version bump, the rule will ask you to choose a version bump.

Output Example

# What's Changed in @usrrname/cursorrules v0.2.0

**Release Date**: December 19, 2024
**Previous Version**: 0.1.3
**Version Bump**: MINOR - New features added (dependency analysis and security scan rules)

## 🚀 New Features
- **Dependency Analysis Agent** ([bd3cc13](link-to-commit)) - Added comprehensive dependency analysis agent with security scanning capabilities
- **Security Scan Agent** ([bd3cc13](link-to-commit