chore: update cursor rule for CONTRIBUTOR-DOCS

Author: rise-erpelding

.cursor/rules/contributor-doc-update.mdc

@@ -1,52 +1,45 @@
 ---
 description: Useful for updating auto-generated navigation and validating links in the contributor docs
+globs: CONTRIBUTOR-DOCS/**
 alwaysApply: false
 ---
 
 # Contributor docs navigation and link validation
 
-## When to apply this rule
+## When to run the nav script
 
-Recognize and apply this rule when the user requests any of the following:
-- Update contributor docs navigation
-- Update nav / TOC / breadcrumbs in contributor docs
+**1. When the user asks** for any of the following:
+- Update contributor docs navigation / nav / TOC / breadcrumbs
 - Regenerate contributor docs
-- Validate/verify links in contributor docs
+- Validate or verify links in contributor docs
 - Fix broken links in contributor docs
-- Any mention of "CONTRIBUTOR-DOCS" or "contributor docs" with "update", "nav", "links", or "verify"
+- CONTRIBUTOR-DOCS or contributor docs with "update", "nav", "links", or "verify"
 
-## Instructions location
-
-**Primary path:** `CONTRIBUTOR-DOCS/01_contributor-guides/07_authoring-contributor-docs/01_ai-agent-instructions.md`
+**2. When you change CONTRIBUTOR-DOCS structure or content:**
+- Add, remove, rename, or move files or folders under `CONTRIBUTOR-DOCS/`
+- Change document H1, H2, or H3 headings
 
 ## What to do
 
-1. **Verify the instructions file exists** at the path above
-   - If the file exists, read it and follow the instructions for "Role 1: Operator"
-   - If the file does NOT exist, see "Self-correction procedure" below
-
-2. **Follow the AI agent instructions** to:
-   - Run the nav update script (which automatically validates links)
-   - Handle any broken links that are reported
-   - Report results to the user
+1. **Run the nav script** from the authoring-contributor-docs folder:
+   ```bash
+   cd CONTRIBUTOR-DOCS/01_contributor-guides/07_authoring-contributor-docs
+   node update-nav.js ../../
+   ```
+2. **Confirm** the script completes without errors.
+3. **Fix any link verification errors** reported by the script (fix straightforward cases; consult the user for ambiguous ones).
+4. **Report results** to the user (files updated, link counts, any remaining issues).
 
-## Self-correction procedure
+Full instructions: `CONTRIBUTOR-DOCS/01_contributor-guides/07_authoring-contributor-docs/01_ai-agent-instructions.md` (Role 1: Operator).
 
-If the instructions file is not found at the expected path:
+## If the instructions file is missing
 
-1. Search for the file using: `glob_file_search` with pattern `**/ai-agent-instructions.md`
-2. Filter results to find the one in `CONTRIBUTOR-DOCS/` folder
-3. Read the found file to confirm it contains the nav update instructions
-4. **Update this rule file** with the new path by modifying the "Primary path" line above
-5. Inform the user that you've updated the rule with the new location
-6. Continue with the nav update process
+If the file above is not found:
+1. Search for `**/ai-agent-instructions.md` and find the one in CONTRIBUTOR-DOCS.
+2. Read it to confirm it contains the nav update instructions.
+3. Update this rule with the correct path, inform the user, then run the nav process.
 
 ## Quick reference
 
-The nav update process typically involves:
-- Running a Node.js script in the authoring-contributor-docs folder
-- The script automatically updates breadcrumbs, TOC, and validates all links
-- If broken links are found, fix straightforward issues automatically
-- Only consult the user for ambiguous cases
-
-Execution time is typically 20-200ms for the entire CONTRIBUTOR-DOCS tree.
+- Script updates breadcrumbs, TOC, and validates all links (~20–200ms for the tree).
+- Fix broken links automatically when the fix is clear; ask the user when the target is gone or intent is unclear.