# Cursor Rule Overlap Hotspots (Prioritized)

**Last Updated:** 2026-04-03

Derived from:
- `python3 scripts/ai/rule-footprint.py --top 40`
- `python3 scripts/find-rules-for-file.py ...` golden-task probes

## Priority A (High Token Pressure + Safe to Reduce)

1. Broad page-improvement baseline
- Previous overlap driver: `v2/pages/**/*.php`
- Action: narrowed to docs + improvement pipeline scripts only
- Why: avoid attaching research-heavy baseline guidance on routine page edits

2. Broad content-cluster rule
- Previous overlap driver: `v2/pages/*.php`
- Action: narrowed to pillar pages + content-cluster docs
- Why: cluster strategy should not auto-attach on all page edits

3. Broad pricing dependency rule
- Previous overlap driver: `v2/pages/*.php`
- Action: narrowed to pages that actually include modern pricing stack
- Why: reduce unnecessary attachments on non-pricing pages

## Priority B (Further Reduced)

1. API endpoint overlap
- Previous hotspot: `v2/api/lead-capture.php` matched 5 rules from core+security overlap
- Action taken: moved `api-endpoints-security.mdc` to pointer/docs routing and preserved critical security guardrails in `api-endpoints-core.mdc`
- Current state: reduced overlap and preserved safety behavior

2. Compare pages overlap
- Previous hotspot: `v2/pages/compare_*.php` matched 5 rules including content/core split overlap
- Action taken: made `comparison-pages-content.mdc` pointer/docs routing; runtime compare routing anchored in `comparison-pages-core.mdc`
- Current state: reduced overlap while keeping schema + analytics + testimonial scoped guidance

3. Blog JSON overlap
- Previous hotspot: `v2/data/blog/posts/**/*.json` matched 11 rules
- Action taken: narrowed advisory rules (`blog-backup`, `blog-content-creation-gate`, `blog-full-rework-decision`, `ordio-promotion-contextual`) away from blanket JSON globs
- Current state: overlap reduced while keeping key runtime guardrails (`blog-json-edit-prohibition`, linking/FAQ/production rules)

4. Dashboard/admin overlap
- Previous hotspot: `v2/admin/seo-dashboard/**/*` matched both `dashboard.mdc` and `seo-dashboard-admin.mdc`
- Action taken: converted `seo-dashboard-admin.mdc` to pointer/docs scope and archived full guidance in `docs/ai/rules-archive/seo-dashboard-admin-full.md`
- Current state: runtime routing centralized in `dashboard.mdc`

## Priority C (Intentional Overlap – Keep)

- `global.mdc` single always-apply baseline
- Base component protection + php indexing checks
- Security + endpoint-specific API constraints

## Safety Notes

1. Any overlap reduction must preserve hard safety requirements for:
- base components
- API security
- JSON-edit prohibitions

2. Use wave-by-wave regression checks from:
- `docs/ai/CURSOR_GOLDEN_TASK_SET.md`