From 0c43baec828267d1fc2a861dc84c73d49e6aae19 Mon Sep 17 00:00:00 2001
From: nedcodes <cursorrulespacks@gmail.com>
Date: Tue, 3 Mar 2026 19:55:39 -0500
Subject: [PATCH] Add rule validation section with cursor-doctor

Adds a new 'Validating Your Rules' section to the README that recommends using cursor-doctor for quality checks. This helps users catch common issues like broken frontmatter, conflicting instructions, and vague rules before deployment.
---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 9727bfa..210cb08 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,17 @@ curl -fsSL https://raw.githubusercontent.com/block/ai-rules/main/scripts/install
    ai-rules status
    ```
 
+## Validating Your Rules
+
+After generating or updating rules, validate them to catch issues before they reach your AI agents:
+
+```bash
+npx cursor-doctor check    # CI-friendly validation
+npx cursor-doctor scan     # Local validation with detailed feedback
+```
+
+This catches broken frontmatter, conflicting instructions, and vague rules that the AI will ignore. Run `check` in CI pipelines or pre-commit hooks to maintain rule quality.
+
 ## Commands
 
 | Command | Description |