# Rule and Documentation Overlap Detection Report

**Generated:** 2026-01-20

This report identifies overlapping content between Cursor rules and documentation files that may indicate redundancy or opportunities for consolidation.

## Rule Overlaps

Found 15 potential rule overlaps (similarity > 30%):

### blog-faq-optimization.mdc ↔ blog-improvement-process.mdc

**Similarity:** 100.0%

**Rule 1:** Blog FAQ optimization patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Blog improvement process - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-faq-optimization.mdc ↔ excel-template-generator.mdc

**Similarity:** 100.0%

**Rule 1:** Blog FAQ optimization patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Excel template generator system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-faq-optimization.mdc ↔ product-updates.mdc

**Similarity:** 100.0%

**Rule 1:** Blog FAQ optimization patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Product Updates system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-faq-optimization.mdc ↔ templates-pages.mdc

**Similarity:** 100.0%

**Rule 1:** Blog FAQ optimization patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Template page patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-faq-optimization.mdc ↔ tools-pages-reference.mdc

**Similarity:** 100.0%

**Rule 1:** Blog FAQ optimization patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Tools/calculator page patterns - Reference coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-improvement-process.mdc ↔ excel-template-generator.mdc

**Similarity:** 100.0%

**Rule 1:** Blog improvement process - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Excel template generator system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-improvement-process.mdc ↔ product-updates.mdc

**Similarity:** 100.0%

**Rule 1:** Blog improvement process - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Product Updates system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-improvement-process.mdc ↔ templates-pages.mdc

**Similarity:** 100.0%

**Rule 1:** Blog improvement process - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Template page patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### blog-improvement-process.mdc ↔ tools-pages-reference.mdc

**Similarity:** 100.0%

**Rule 1:** Blog improvement process - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Tools/calculator page patterns - Reference coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### excel-template-generator.mdc ↔ product-updates.mdc

**Similarity:** 100.0%

**Rule 1:** Excel template generator system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Product Updates system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### excel-template-generator.mdc ↔ templates-pages.mdc

**Similarity:** 100.0%

**Rule 1:** Excel template generator system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Template page patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### excel-template-generator.mdc ↔ tools-pages-reference.mdc

**Similarity:** 100.0%

**Rule 1:** Excel template generator system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Tools/calculator page patterns - Reference coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### product-updates.mdc ↔ templates-pages.mdc

**Similarity:** 100.0%

**Rule 1:** Product Updates system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Template page patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### product-updates.mdc ↔ tools-pages-reference.mdc

**Similarity:** 100.0%

**Rule 1:** Product Updates system patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Tools/calculator page patterns - Reference coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction

### templates-pages.mdc ↔ tools-pages-reference.mdc

**Similarity:** 100.0%

**Rule 1:** Template page patterns - Coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Rule 2:** Tools/calculator page patterns - Reference coordination file. This rule has been split into focused files. See relatedRules for specific topics.

**Recommendation:** Review for consolidation or pattern extraction


## Documentation Pattern Overlaps

### FAQ Pattern (70 files)

- `content/blog/FAQ_QUALITY_RESEARCH.md`
- `content/blog/FAQ_SCHEMA_VALIDATION.md`
- `content/blog/FAQ_OPTIMIZATION_NEXT_STEPS.md`
- `content/blog/FAQ_OPTIMIZATION_PROGRESS.md`
- `content/blog/TIER1_FAQ_LINKING_OPPORTUNITIES.md`
- `content/blog/FAQ_MONITORING_VERIFICATION.md`
- `content/blog/FAQ_MONITORING_CHECKLIST.md`
- `content/blog/FAQ_OPTIMIZATION_PROJECT_SUMMARY.md`
- `content/blog/FAQ_AUTOMATION_QUICK_REFERENCE.md`
- `content/blog/FAQ_PERFORMANCE_REPORT.md`

*... and 60 more FAQ files*

### SCHEMA Pattern (10 files)

- `content/blog/FAQ_SCHEMA_VALIDATION.md`
- `content/blog/FAQ_SCHEMA_PRODUCTION_DEBUG.md`
- `content/blog/FAQ_SCHEMA_BEST_PRACTICES.md`
- `content/blog/guides/SCHEMA_MARKUP_TROUBLESHOOTING.md`
- `content/blog/guides/SCHEMA_MARKUP_FIX_SUMMARY.md`
- `guides/tools-pages/SCHEMA_VALIDATION_PLAN_2026.md`
- `guides/tools-pages/SCHEMA_VALIDATION_RESULTS_2026.md`
- `guides/tools-pages/SCHEMA_VALIDATION_CHECKLIST_2026.md`
- `systems/shiftops/seo/SCHEMA_VALIDATION_VERIFICATION.md`
- `systems/shiftops/seo/SCHEMA_VALIDATION_FIXES.md`

### TEMPLATE Pattern (42 files)

- `DOCUMENTATION_TEMPLATES.md`
- `development/testing/TEMPLATE_V2_STRUCTURE_ANALYSIS.md`
- `development/testing/TEMPLATE_V2_FINDINGS.md`
- `development/testing/TEMPLATE_V2_E2E_ANALYSIS.md`
- `content/blog/MIGRATION_TEMPLATE_REQUIREMENTS.md`
- `content/blog/TEMPLATE_PLACEHOLDERS_REPORT.md`
- `content/blog/TIER1_PEER_REVIEW_TEMPLATE.md`
- `content/blog/BLOG_TEMPLATE_BEST_PRACTICES.md`
- `content/blog/guides/TEMPLATE_DEVELOPMENT_GUIDE.md`
- `content/blog/reference/TEMPLATE_PATTERNS_ANALYSIS.md`

*... and 32 more TEMPLATE files*

### VALIDATION Pattern (44 files)

- `RULE_VALIDATION_REPORT.md`
- `LINK_VALIDATION_CATEGORIZED.md`
- `CROSS_REFERENCE_VALIDATION_REPORT.md`
- `CONTENT_VALIDATION_REPORT.md`
- `VALIDATION_SUMMARY.md`
- `VALIDATION_RESULTS_COMPLETE.md`
- `LINK_VALIDATION_REPORT.md`
- `development/REQUEST_VALIDATION_IMPLEMENTATION.md`
- `development/CI_CD_EXTENSION_VALIDATION.md`
- `development/testing/extraction_validation_report.md`

*... and 34 more VALIDATION files*


## Recommendations

1. **Review high-similarity rule pairs** - Consider merging or extracting common patterns
2. **Consolidate documentation patterns** - Multiple files covering similar topics
3. **Extract common patterns** - Move shared patterns to `shared-patterns.mdc`
4. **Update relatedRules** - Ensure overlapping rules reference each other

## Related Documentation

- **[Documentation Standards](../docs/DOCUMENTATION_STANDARDS.md)** - Consolidation rules
- **[Rule to Documentation Mapping](../docs/ai/RULE_TO_DOC_MAPPING.md)** - Rule mappings
