Human Rules

A Visual Studio Code extension that displays applicable Cursor rules alongside your code.

Features

• Browse all project conventions in the sidebar
• View human-readable documentation for each rule
• See which rules apply to the currently open file

Usage

Setting Up Rules

Place your Cursor rules in .cursor/rules/ with the following structure:

.cursor/
└── rules/
    └── my-rule/
        ├── RULE.md      # Required: AI rule with frontmatter
        └── HUMANS.md    # Optional: Human-readable documentation

RULE.md

For more information, see: https://cursor.com/docs/context/rules

The RULE.md file contains the AI rule with optional YAML frontmatter:

---
description: Brief description of the rule
globs: "**/*.ts, **/*.tsx"
alwaysApply: false
---

Your AI rule content here...

HUMANS.md (Optional)

Add a HUMANS.md file alongside RULE.md to provide human-readable documentation for your team. This file appears prominently when viewing the rule in the extension.

When HUMANS.md exists:

• The human documentation is displayed first
• The AI rule content appears in a collapsible "AI Rule" section below

When HUMANS.md does not exist:

• The RULE.md content is displayed directly

This separation allows you to write detailed documentation for humans while keeping AI rules concise and focused.