# Rule to Documentation Mapping **Last Updated:** 2026-04-08 Bidirectional mapping between Cursor rules (`.cursor/rules/*.mdc`) and documentation files (`docs/`). This mapping helps AI agents discover relevant documentation when working with specific rules, and vice versa. **Note:** This file is auto-generated from `METADATA_INDEX.json`. For the most current mappings, check the `relatedDocs` arrays in individual rule files. ## Rule → Documentation Mapping ### Always-Applied Rules #### global.mdc **Description:** Global Ordio development guardrails for Cursor agent. **Related Documentation:** - `docs/DATE_MANAGEMENT_GUIDELINES.md` - `docs/archive/2026-04-01-docs-cleanup/stale-docs-root/DOCUMENTATION_CLEANUP_AUDIT.md` - `docs/DOCUMENTATION_INVENTORY.md` - `docs/DOCUMENTATION_INVENTORY_MANUAL_NOTES.md` - `docs/DOCUMENTATION_HYGIENE_LOG.md` - `docs/DOCUMENTATION_MAINTENANCE_PROCESS.md` - `docs/DOCUMENTATION_REDUNDANCY_REPORT.md` - `docs/DOCUMENTATION_STANDARDS.md` - `docs/ai/RULE_TO_DOC_MAPPING.md` - `docs/ai/cursor-playbook.md` - `docs/content/PAGE_IMPROVEMENT_DATA_PLAYBOOK.md` - `docs/ai/rule-hierarchy.md` - `docs/content/blog/guides/BACKUP_GUIDE.md` - `docs/development/JAVASCRIPT_LOGGING_BEST_PRACTICES.md` - `docs/development/PHP_EXTENSION_DEPENDENCIES.md` - `docs/development/PHP_EXTENSION_FALLBACK_PATTERNS.md` - `docs/development/PRODUCTION_DEPLOYMENT_CHECKLIST.md` - `docs/development/DEV_TOOLING.md` - `docs/development/ESLINT_MIGRATION_2026.md` - `docs/systems/landing-page-redirects/LANDING_PAGE_REDIRECTS.md` #### mcp-usage.mdc **Description:** MCP tool governance—when to use each MCP, MCP vs direct API, trigger phrases. **Related Documentation:** - `docs/development/MCP_INTEGRATION.md` - Setup, MCP vs API matrix, tool limit - `.cursor/README-MCP.md` - Quick setup #### gdpr-consent.mdc **Description:** GDPR/consent requirements for tracking scripts. All non-essential tracking must be consent-gated. **Related Documentation:** - `docs/systems/gdpr/GDPR_DSGVO_WEBSITE_AUDIT.md` - Website tracking and consent audit - `docs/systems/gdpr/GDPR_DSGVO_HUBSPOT_AUDIT.md` - HubSpot integration audit #### page-improvement-data-baseline.mdc **Description:** GSC/GA baseline and research stack for improving existing public URLs (`v2/pages/**/*.php`). **Related Documentation:** - `docs/content/PAGE_IMPROVEMENT_DATA_PLAYBOOK.md` - `docs/content/pages/marketing-pages/VIP_MARKETING_SEO_DATA_TIERS.md` - VIP marketing SISTRIX tiers, selective `keyword.domain.seo` + `kw`, data utilization - `docs/content/tools/DATA_COLLECTION_TOOLS.md` - `docs/content/blog/IMPROVEMENT_DATA_COLLECTION_GUIDE.md` ### Page-Type Rules #### blog-\*.mdc (Blog Rules) See individual blog rule files for specific documentation mappings. Key documentation: - `docs/content/blog/BLOG_SEO_TITLE_STANDARDS.md` - SEO title format: `{keyword} - Ordio`, no | Lexikon/Ratgeber (blog-templates-seo.mdc) - `docs/content/blog/CONTENT_WRITING_GUIDELINES.md` - Natural flow, H2+intro+H3 pattern, anti-cheesy transitions - `docs/content/blog/CONTENT_DEPTH_GUIDELINES.md` - Content depth, section standards, main-topic H2 targets - `docs/content/blog/CONTENT_CREATION_WORKFLOW_2026.md` - Outline-first, section-by-section drafting; no incremental word-count chasing - `docs/content/blog/BLOG_CONTENT_EDIT_WORKFLOW.md` - Canonical `content-draft.html`, `update-post-content.php`, `apply-and-validate-post.sh`, `make blog-post-validate-strict` - `docs/content/CONTENT_WRITING_BEST_PRACTICES_2026.md` - Comprehensive content writing guide - `docs/content/blog/MANUAL_REVIEW_RESUME_RUNBOOK.md` - Single entry point for one-by-one manual review (when user says "review post X") - `docs/content/blog/README.md` - Blog documentation index (data layout, reports, scripts) - `docs/content/blog/FINAL_STATUS.md` - Current blog system status - `docs/content/blog/MONITORING_RUNBOOK.md` - Monitoring and cron setup - `docs/content/blog/SEO_DATA_MANAGEMENT.md` - Data freshness, SISTRIX/GSC/GA4 - `docs/content/blog/SISTRIX_ENDPOINTS_AND_REPORTS.md` - SISTRIX endpoint → script → report mapping, credit use, actionability - `docs/content/blog/PERFORMANCE_ANALYSIS.md` - GA4/GSC collection and analysis - `docs/content/blog/DATA_FRESHNESS_REPORT.md` - Data freshness status (regenerated by script) - `docs/content/blog/AUDIT_RUNBOOK.md` - Blog traffic & SEO audit steps and cadence - `docs/content/blog/CONTENT_BACKLOG_WORKFLOW.md` - Content backlog workflow; full-site surface classification; "Create new" = content gap only (see blog-monitoring.mdc) - `docs/content/blog/TRAFFIC_SEO_SNAPSHOT_*.md` - Traffic/SEO summary (regenerate for current date) - `docs/content/blog/guides/` - Blog guides and workflows - `docs/content/blog/PAA_TOPIC_OVERRIDE_GUIDE.md` - When SISTRIX returns off-topic PAA; paa-questions-manual.json (blog-data-collection.mdc) - `docs/content/blog/FAQ_CREATION_WORKFLOW_2026.md` - FAQ workflow; when generate-faq-questions filters all PAA, create faq-answers-optimized.json manually (blog-new-post-creation.mdc) #### comparison-pages-core.mdc & comparison-pages-content.mdc **Related Documentation:** - `docs/guides/comparison-pages/COMPARISON_PAGES_GUIDE.md` - Step-by-step creation guide - `docs/guides/comparison-pages/COMPARISON_PAGES_STRUCTURE.md` - Page structure documentation - `docs/guides/comparison-pages/COMPARISON_PAGES_TEMPLATE_ANALYSIS.md` - Template analysis - `docs/content/pages/comparison-pages/COMPARISON_PAGES_INVENTORY.md` - Complete page list - `docs/content/pages/comparison-pages/SEO_ONLY_COMPARISON_PAGES.md` - SEO-only pages - `docs/content/competitors/COMPETITORS_VS_COMPARISON_PAGES.md` - Critical distinction guide - `docs/content/competitors/COMPETITORS_INVENTORY.md` - Competitor data #### product-pages.mdc **Related Documentation:** - `docs/ai/RULE_TO_DOC_MAPPING.md` - `docs/ai/cursor-playbook.md` - `docs/content/AI_CONTENT_AVOIDANCE_GUIDE.md` - `docs/content/CONTENT_WRITING_BEST_PRACTICES_2026.md` - `docs/content/META_TAGS_OPTIMIZATION_GUIDE.md` - `docs/content/pages/product-pages/PRODUCT_PAGE_FAQ_GUIDE.md` - Product page FAQ workflow (structure, schema, keyword research) - `docs/content/pages/product-pages/FEATURE_PAGES_CONTENT_INDEX.md` - Product feature SEO hub (registry scripts, orchestrator, synthesis) - `docs/content/pages/product-pages/FEATURE_PAGE_IMPROVEMENT_WORKFLOW.md` - Phased data → FAQ → validate → monitor - `docs/content/pages/product-pages/PRODUCT_PAGES_INVENTORY.md` - `docs/content/product-features/PRODUCT_FEATURES_INVENTORY.md` - `docs/content/product-features/README.md` - `docs/content/product-features/PRODUCT_FEATURE_CARDS_SPEC.md` - `docs/guides/PAGE_TYPE_GUIDES.md` #### product-pages-faq.mdc **Related Documentation:** - `docs/content/pages/product-pages/PRODUCT_PAGE_FAQ_GUIDE.md` - Research-first workflow, scripts, validation - `docs/content/pages/product-pages/FEATURE_PAGES_CONTENT_INDEX.md` - Orchestrator + synthesis + registry vs legacy FAQ sources - `docs/content/blog/FAQ_BEST_PRACTICES.md` - AEO/GEO, answer length, prioritization - `docs/content/blog/FAQ_SCHEMA_BEST_PRACTICES.md` - Schema requirements #### product-feature-cards.mdc **Related Documentation:** - `docs/content/product-features/PRODUCT_FEATURE_CARDS_SPEC.md` - Character target (70–95), copy formula, SEO/AEO/GEO - `docs/content/CONTENT_WRITING_BEST_PRACTICES_2026.md` #### tools-pages-\*.mdc (All Tools Page Rules) **Related Documentation:** - `docs/guides/tools-pages/README.md` - Tools documentation index - `docs/guides/tools-pages/TOOL_DOCUMENTATION_TEMPLATE.md` - Documentation template - `docs/guides/tools-pages/TOOLS_INVENTORY.md` - Complete tool list - `docs/guides/tools-pages/TOOLS_MAINTENANCE_GUIDE.md` - Annual update process - `docs/guides/tools-pages/DOCUMENTATION_STRUCTURE.md` - Structure guide - `docs/content/tools/TOOLS_INVENTORY.md` - Content tools inventory #### tools-prioritization.mdc **Related Documentation:** - `docs/content/tools/TOOLS_PRIORITIZATION_2026.md` - Recommended build order and quick wins - `docs/content/tools/TOOLS_OPPORTUNITY_LIST.md` - Keyword → tool mapping and SISTRIX merge - `docs/content/tools/TOOLS_COMPETITIVE_LANDSCAPE.md` - Competitor tools overview - `docs/content/tools/PROZENTRECHNER_AUDIT_CHECKLIST.md` - Prozentrechner SEO audit - `docs/content/tools/TOOLS_PERFORMANCE_DATA.md` - GSC/GA export and usage for tools analysis - `docs/guides/tools-pages/README.md` - Tools index (includes "What to build next") - `docs/seo-strategy-2026/guides/KEYWORD_RESEARCH_GUIDE.md` - Tools/Rechner SISTRIX section - `docs/content/tools/TOOLS_DOCUMENTATION_QUALITY_REPORT.md` - Quality assessment - `docs/content/tools/README.md` - Tools content docs index #### templates-pages-\*.mdc **Related Documentation:** - `docs/guides/PAGE_TYPE_GUIDES.md` - Page type quick reference - `docs/content/pages/templates-pages/` - Template pages documentation #### index-pages-annual-update.mdc **Related Documentation:** - `docs/content/LABOR_LAW_VALUES_2026.md` - Single source of truth for Mindestlohn, Minijob-Grenze - `docs/guides/index-pages/INDEX_PAGES_ANNUAL_UPDATE_GUIDE.md` - Annual update checklist for tools, templates, downloads index pages ### System Rules #### api-endpoints-core.mdc & api-endpoints-security.mdc **Related Documentation:** - `docs/systems/apis/HUBSPOT_API_REFERENCE.md` - `docs/systems/forms/FORM_CONFIGURATION_REFERENCE.md` - `docs/systems/forms/FORM_TO_PAGE_MAPPING.md` - `docs/systems/forms/EVENT_FORM_IMPLEMENTATION.md` - Event lead capture (Internorga, Intergastra) - `docs/systems/forms/TRADE_FAIR_LEAD_SOURCE_BACKFILL.md` - Backfill runbook for trade fair Lead Source - `docs/guides/HUBSPOT_INTEGRATION_GUIDE.md` #### lead-capture.mdc & lead-capture-copy.mdc **Related Documentation:** - `docs/systems/lead-capture/FONIO_CALLBACK_COPY.md` - Fonio/webhook callback flow and Step 1 copy guardrails - `docs/systems/lead-capture/COPY_MANAGEMENT.md` - `docs/systems/lead-capture/LEAD_CAPTURE_COPY_BEST_PRACTICES.md` - `docs/systems/shared-components/LEAD_CAPTURE_COMPONENT.md` #### omr-review-badges.mdc **Related Documentation:** - `docs/systems/shared-components/OMR_REVIEW_BADGES.md` - SSOT data, partials, CSS bundles, quarterly update checklist #### merchant-center.mdc **Related Documentation:** - `docs/systems/merchant-center/MERCHANT_CENTER_SETUP.md` - GCP setup, feed, landing pages, validation #### shiftops-backend.mdc **Related Documentation:** - `docs/ai/RULE_TO_DOC_MAPPING.md` - `docs/guides/PAGE_TYPE_GUIDES.md` - `docs/systems/shiftops/README.md` - `docs/systems/shiftops/SHIFTOPS_API_DOCUMENTATION.md` - `docs/systems/shiftops/SHIFTOPS_ARCHITECTURE.md` - `docs/systems/shiftops/SHIFTOPS_COMPONENTS.md` #### product-updates-\*.mdc **Related Documentation:** - `docs/systems/product-updates/README.md` - Product Updates system index #### excel-template-generator-\*.mdc **Related Documentation:** - `docs/systems/excel-generator/README.md` - Excel generator index - `docs/systems/excel-generator/` - All Excel generator documentation #### affiliate-referral.mdc **Related Documentation:** - `docs/systems/affiliate/REFERRAL_PAGE_GUIDE.md` - Referral page and UTM generator - `docs/systems/affiliate/API_REFERENCE.md` - Generate Referral URL endpoint - `docs/systems/affiliate/PARTNER_UTM_AND_ATTRIBUTION.md` - Partner UTM parameters and HubSpot attribution #### affiliate-hubspot.mdc **Related Documentation:** - `docs/systems/affiliate/CRON_SYNC_RUNBOOK.md` - HubSpot affiliate sync triggers (server cron vs GitHub backup vs webhook limits) - `docs/systems/affiliate/ARCHITECTURE.md` - Cache-first flow and cron role - `docs/systems/affiliate/HUBSPOT_INTEGRATION_TEST_PROCEDURE.md` - Sync testing ### Other Rules #### shared-patterns.mdc **Related Documentation:** - `docs/AI_AGENT_GUIDE.md` - `docs/DOCUMENTATION_STANDARDS.md` - `docs/ai/RULE_TO_DOC_MAPPING.md` - `docs/content/AI_CONTENT_AVOIDANCE_GUIDE.md` - `docs/content/CONTENT_STRUCTURE_FORMATTING_GUIDE.md` - `docs/content/CONTENT_WRITING_BEST_PRACTICES_2026.md` - `docs/content/blog/ANCHOR_TEXT_FORMATTING.md` - `docs/forms/FORM_TRACKING_BEST_PRACTICES.md` - `docs/forms/FORM_TRACKING_DEVELOPER_GUIDE.md` - `docs/forms/GTM_FORM_TRACKING_GUIDE.md` - `docs/guides/PAGE_TYPE_GUIDES.md` - `docs/seo/ahrefs-link-opportunities-process.md` ## Documentation → Rules Mapping This section helps find which rules reference specific documentation files. Organized by directory. ### docs/ai/ #### RULE_TO_DOC_MAPPING.md **Referenced by rules:** - `.cursor/rules/global.mdc` - `.cursor/rules/shared-patterns.mdc` - Multiple page-type rules #### cursor-playbook.md **Referenced by rules:** - `.cursor/rules/global.mdc` - `.cursor/rules/product-pages.mdc` - Multiple other rules ### docs/content/pages/marketing-pages/ #### VIP_MARKETING_SEO_DATA_TIERS.md **Referenced by rules:** - `.cursor/rules/marketing-pages-seo-data.mdc` - `.cursor/rules/page-improvement-data-baseline.mdc` ### docs/guides/ #### PAGE_TYPE_GUIDES.md **Referenced by rules:** - `.cursor/rules/shared-patterns.mdc` - `.cursor/rules/product-pages.mdc` - `.cursor/rules/booking-calendars.mdc` - `.cursor/rules/shiftops-backend.mdc` - `.cursor/rules/base-components.mdc` - `.cursor/rules/webinar-pages.mdc` - `.cursor/rules/static-pages.mdc` - `.cursor/rules/homepage.mdc` - `.cursor/rules/pillar-pages.mdc` - `.cursor/rules/industry-pages.mdc` - `.cursor/rules/content-clusters.mdc` - `.cursor/rules/tools-pages-core-design.mdc` - `.cursor/rules/download-pages.mdc` ### docs/content/pages/static-pages/ #### EVENTS_PAGE_COMPONENTS.md **Referenced by rules:** - `.cursor/rules/static-pages.mdc` ### docs/content/blog/ #### FINAL_STATUS.md **Referenced by rules:** - `.cursor/rules/blog-templates-core.mdc` ### docs/systems/ #### shiftops/README.md **Referenced by rules:** - `.cursor/rules/shiftops-backend.mdc` #### partner-pages/PARTNER_PAGES_GUIDE.md **Referenced by rules:** - `.cursor/rules/partner-pages.mdc` #### affiliate/PARTNER_UTM_AND_ATTRIBUTION.md **Referenced by rules:** - `.cursor/rules/affiliate-referral.mdc` #### affiliate/CRON_SYNC_RUNBOOK.md **Referenced by rules:** - `.cursor/rules/affiliate-hubspot.mdc` #### guides/index-pages/INDEX_PAGES_ANNUAL_UPDATE_GUIDE.md **Referenced by rules:** - `.cursor/rules/index-pages-annual-update.mdc` #### content/LABOR_LAW_VALUES_2026.md **Referenced by rules:** - `.cursor/rules/index-pages-annual-update.mdc` - `.cursor/rules/templates-pages-core.mdc` (implied by templates documentation) #### video-carousel/VIDEO_CAROUSEL_IMPLEMENTATION_SUMMARY.md & VALIDATION_REPORT.md **Referenced by rules:** - `.cursor/rules/static-pages.mdc` (customers page video schema) ## Usage Patterns ### For AI Agents **When working with a rule:** 1. Check the rule's `relatedDocs` array in its frontmatter 2. Check this mapping for additional context 3. Read relevant guide files before making changes 4. Update documentation when rule patterns change **When working with documentation:** 1. Check this mapping to find related rules 2. Ensure changes align with rule patterns 3. Update rules if documentation patterns change ### For Human Maintainers **When updating rules:** - Update `relatedDocs` array if new documentation is created - Update this mapping file if structure changes significantly - Ensure documentation links are valid **When creating documentation:** - Reference related rules in documentation - Add documentation paths to rule `relatedDocs` arrays - Ensure documentation aligns with rule patterns ## Related Documentation - **[Cursor Rules Index](.cursor/rules/README.md)** - Complete rule list - **[Rule Hierarchy](rule-hierarchy.md)** - Rule architecture - **[AI Agent Guide](AI_AGENT_GUIDE.md)** - Documentation discovery patterns - **[Documentation Standards](../DOCUMENTATION_STANDARDS.md)** - Documentation conventions - **[Documentation hygiene log](../DOCUMENTATION_HYGIENE_LOG.md)** — Maintenance SSOT + archived meta-docs index - **[Documentation inventory manual notes](../DOCUMENTATION_INVENTORY_MANUAL_NOTES.md)** — Durable inventory addenda - **[METADATA_INDEX.json](../docs/ai/METADATA_INDEX.json)** - Machine-readable rule metadata ## Note on Completeness This mapping is generated from rule metadata. For the most complete and up-to-date mappings, check: 1. Individual rule files' `relatedDocs` arrays (most accurate) 2. `METADATA_INDEX.json` (machine-readable, auto-generated) 3. This file (human-readable summary, updated periodically)