# Rules Missing Documentation References Review

**Last Updated:** 2026-01-20

Review of Cursor rules that should have `relatedDocs` entries but have empty arrays.

## Status

**Current State:**
- Most rules have `relatedDocs` arrays populated
- Some rules may have empty arrays but don't mention documentation
- Rules that mention documentation should have `relatedDocs` entries

## Validation

**Automated Check:**
- Run `python3 scripts/validate-cursor-rules.py` to check cross-references
- Check `METADATA_INDEX.json` for complete list

**Manual Review:**
- Review rules with empty `relatedDocs` arrays
- Check if they mention documentation in descriptions
- Add relevant documentation references

## Pattern for Adding Documentation References

**When to Add:**
- Rule mentions specific documentation files
- Rule describes patterns documented elsewhere
- Rule references guides or standards

**How to Add:**
```yaml
relatedDocs:
  - docs/path/to/relevant-doc.md
  - docs/another/relevant-doc.md
```

## Related Documentation

- **[RULE_TO_DOC_MAPPING.md](ai/RULE_TO_DOC_MAPPING.md)** - Complete rule-to-documentation mapping
- **[validate-cursor-rules.py](../../scripts/validate-cursor-rules.py)** - Validation script