# Documentation Files Missing Rule References Review

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

Review of documentation files that should reference Cursor rules but don't have "Related Cursor Rules" sections.

## Files That Should Reference Rules

### Guide Files

**Comparison Pages:**
- `guides/comparison-pages/COMPARISON_PAGES_GUIDE.md` - ✅ Has rule references
- Other comparison page guides - Review for rule references

**Tools Pages:**
- `guides/tools-pages/README.md` - ⚠️ Should reference tools-pages rules
- Tool-specific guides - Review for rule references

**Other Guides:**
- Page type guides - Should reference relevant page-type rules
- Integration guides - Should reference API/system rules

### System Documentation

**Location:** `docs/systems/`

- System README files - Should reference system-specific rules
- System guides - Should reference relevant rules

**Action:** Add "Related Cursor Rules" sections to key guide and system documentation files.

## Pattern for Adding Rule References

**Standard Section:**

```markdown
## Related Cursor Rules

When working with [topic], the following Cursor rules apply:

- **[rule-name.mdc](.cursor/rules/rule-name.mdc)** - Description
- **[another-rule.mdc](.cursor/rules/another-rule.mdc)** - Description
```

**Example:**

```markdown
## Related Cursor Rules

When working with comparison pages, the following Cursor rules apply:

- **[comparison-pages-core.mdc](.cursor/rules/comparison-pages-core.mdc)** - Core comparison page patterns
- **[comparison-pages-content.mdc](../../.cursor/rules/comparison-pages-content.mdc)** - Content patterns
- **[comparison-pages-schema-meta.mdc](../../.cursor/rules/comparison-pages-schema-meta.mdc)** - Schema and meta tags
- **[shared-patterns.mdc](../../.cursor/rules/shared-patterns.mdc)** - Universal patterns
```

## Files to Update

### High Priority

1. `guides/tools-pages/README.md` - Add tools-pages rule references
2. System README files - Add system-specific rule references
3. Integration guides - Add API/system rule references

### Medium Priority

1. Tool-specific guides - Add relevant rule references
2. Page type guides - Add page-type rule references

## Related Documentation

- **[RULE_TO_DOC_MAPPING.md](ai/RULE_TO_DOC_MAPPING.md)** - Complete rule-to-documentation mapping
- **[DOCUMENTATION_STANDARDS.md](DOCUMENTATION_STANDARDS.md)** - Documentation standards
- **[RULE_DOC_CROSS_REFERENCE_VALIDATION.md](RULE_DOC_CROSS_REFERENCE_VALIDATION.md)** - Cross-reference validation