# Blog Rule Discovery Patterns

**Last Updated:** 2026-01-13

Quick reference for discovering which Cursor rules apply when working with blog-related files.

## File Path → Rule Mapping

### Blog Templates & Pages

**File Pattern:** `v2/pages/blog/**/*.php`
**Rules Applied:**
- `blog-templates.mdc` - Template patterns
- `blog-index-hero.mdc` - Index page patterns (if index.php or category.php)
- `blog-cta-patterns.mdc` - CTA patterns
- `shared-patterns.mdc` - Universal patterns
- `global.mdc` - Always applied

**Examples:**
- `v2/pages/blog/index.php` → blog-templates.mdc, blog-index-hero.mdc, blog-cta-patterns.mdc
- `v2/pages/blog/post.php` → blog-templates.mdc, blog-cta-patterns.mdc
- `v2/pages/blog/category.php` → blog-templates.mdc, blog-index-hero.mdc

### Blog Components

**File Pattern:** `v2/components/blog/**/*.php`
**Rules Applied:**
- `blog-templates.mdc` - Component patterns
- `blog-cta-patterns.mdc` - CTA patterns (if CTA component)
- `shared-patterns.mdc` - Universal patterns
- `global.mdc` - Always applied

**Examples:**
- `v2/components/blog/PostContent.php` → blog-templates.mdc
- `v2/components/blog/PostCard.php` → blog-templates.mdc
- `v2/components/blog/BlogIndexHero.php` → blog-index-hero.mdc

### Blog Configuration

**File Pattern:** `v2/config/blog-*.php`
**Rules Applied:**
- `blog-templates.mdc` - Helper function patterns
- `global.mdc` - Always applied

**Examples:**
- `v2/config/blog-template-helpers.php` → blog-templates.mdc
- `v2/config/blog-meta-generator.php` → blog-templates.mdc
- `v2/config/blog-schema-generator.php` → blog-templates.mdc

### Blog Data Files

**File Pattern:** `v2/data/blog/posts/**/*.json`
**Rules Applied:**
- `blog-backup.mdc` - Backup requirements
- `blog-post-documentation.mdc` - Documentation requirements
- `global.mdc` - Always applied

**Examples:**
- `v2/data/blog/posts/lexikon/slug.json` → blog-backup.mdc, blog-post-documentation.mdc

### Blog Scripts

**File Pattern:** `v2/scripts/blog/**/*.php` or `v2/scripts/blog/**/*.py`

**Data Collection Scripts:**
- Pattern: `collect-*.php`, `run-all-data-collection.php`, `run-all-advanced-collection.php`
- Rule: `blog-data-collection.mdc`

**Analysis Scripts:**
- Pattern: `analyze-*.php`
- Rule: `blog-post-documentation.mdc`

**Documentation Scripts:**
- Pattern: `generate-post-documentation.php`, `generate-improvement-plan.php`
- Rule: `blog-post-documentation.mdc`

**Review Scripts:**
- Pattern: `generate-manual-review-checklist.php`, `safe-regenerate-documentation.php`, `validate-documentation-quality.php`
- Rule: `blog-manual-review.mdc`

**Backup Scripts:**
- Pattern: `*.py` (backup scripts)
- Rule: `blog-backup.mdc`

**Examples:**
- `v2/scripts/blog/collect-post-keywords-sistrix.php` → blog-data-collection.mdc
- `v2/scripts/blog/generate-post-documentation.php` → blog-post-documentation.mdc
- `v2/scripts/blog/generate-manual-review-checklist.php` → blog-manual-review.mdc
- `v2/scripts/blog/backup-blog-content.py` → blog-backup.mdc

### Blog Documentation

**File Pattern:** `docs/content/blog/posts/**/*.md`
**Rules Applied:**
- `blog-post-documentation.mdc` - Documentation requirements
- `blog-manual-review.mdc` - Review requirements
- `global.mdc` - Always applied

**Examples:**
- `docs/content/blog/posts/lexikon/slug/POST_ANALYSIS.md` → blog-post-documentation.mdc, blog-manual-review.mdc
- `docs/content/blog/posts/lexikon/slug/SEO_REPORT.md` → blog-post-documentation.mdc

## Task Type → Rule Selection

### Creating New Blog Post Template

**Files:** `v2/pages/blog/post.php` or new template
**Rules:**
1. `blog-templates.mdc` - Template patterns
2. `blog-cta-patterns.mdc` - CTA patterns
3. `shared-patterns.mdc` - Universal patterns
4. `global.mdc` - Always applied

### Modifying Blog Component

**Files:** `v2/components/blog/*.php`
**Rules:**
1. `blog-templates.mdc` - Component patterns
2. `blog-cta-patterns.mdc` - If CTA component
3. `shared-patterns.mdc` - Universal patterns
4. `global.mdc` - Always applied

### Running Data Collection

**Scripts:** `v2/scripts/blog/collect-*.php`
**Rules:**
1. `blog-data-collection.mdc` - Data collection rules
2. `blog-post-documentation.mdc` - Documentation requirements
3. `global.mdc` - Always applied

### Generating Documentation

**Scripts:** `v2/scripts/blog/generate-post-documentation.php`
**Rules:**
1. `blog-post-documentation.mdc` - Documentation requirements
2. `blog-manual-review.mdc` - Review requirements
3. `global.mdc` - Always applied

### Manual Review

**Files:** `docs/content/blog/posts/**/*.md`
**Rules:**
1. `blog-manual-review.mdc` - Review workflow
2. `blog-post-documentation.mdc` - Documentation requirements
3. `global.mdc` - Always applied

### Creating Backup

**Scripts:** `v2/scripts/blog/*.py` (backup scripts)
**Rules:**
1. `blog-backup.mdc` - Backup requirements
2. `global.mdc` - Always applied

## Rule Combination Patterns

### Blog Template Development

**Combination:**
- `blog-templates.mdc` (primary)
- `blog-cta-patterns.mdc` (if CTAs)
- `blog-index-hero.mdc` (if index/category pages)
- `shared-patterns.mdc` (validation)
- `global.mdc` (always)

### Blog Documentation Workflow

**Combination:**
- `blog-post-documentation.mdc` (primary)
- `blog-manual-review.mdc` (review process)
- `blog-data-collection.mdc` (data requirements)
- `global.mdc` (always)

### Blog Data Collection

**Combination:**
- `blog-data-collection.mdc` (primary)
- `blog-post-documentation.mdc` (documentation integration)
- `global.mdc` (always)

## Quick Decision Tree

```
Working on blog files?
│
├─ Is it v2/pages/blog/ or v2/components/blog/?
│  └─ → blog-templates.mdc, blog-cta-patterns.mdc
│
├─ Is it v2/scripts/blog/collect-*.php?
│  └─ → blog-data-collection.mdc
│
├─ Is it v2/scripts/blog/generate-*.php?
│  └─ → blog-post-documentation.mdc
│
├─ Is it v2/scripts/blog/*review*.php?
│  └─ → blog-manual-review.mdc
│
├─ Is it v2/scripts/blog/*.py (backup)?
│  └─ → blog-backup.mdc
│
├─ Is it v2/data/blog/posts/**/*.json?
│  └─ → blog-backup.mdc, blog-post-documentation.mdc
│
└─ Is it docs/content/blog/posts/**/*.md?
   └─ → blog-post-documentation.mdc, blog-manual-review.mdc
```

## Related Documentation

- [HOW_TO_USE_THIS_SYSTEM.md](HOW_TO_USE_THIS_SYSTEM.md) - Complete usage guide
- [BLOG_QUICK_REFERENCE.md](BLOG_QUICK_REFERENCE.md) - Quick reference
- [.cursor/rules/README.md](.cursor/rules/README.md) - Complete rule index