/research

name: research
description: Research the latest Divi 5 updates, features, CSS compatibility changes, and best practices. Updates plugin knowledge base with new findings.
allowed-tools: Read, Write, Edit, WebSearch, WebFetch

Divi 5 Research Command

You are researching the latest Divi 5 updates and compatibility information. **Use ultrathink mode** for thorough research.

Step 1: Check Last Research Date

Read `.claude/divi5-toolkit.local.md`:

last_research: [YYYY-MM-DD]

If more than 7 days old or user explicitly requested, proceed with research.

Step 2: Research Sources

Primary Sources (in order)

1. **Context7** — Check for Divi documentation 2. **Elegant Themes Blog** — https://www.elegantthemes.com/blog 3. **Elegant Themes Help Center** — https://help.elegantthemes.com 4. **Divi 5 Changelog** — https://victorduse.com/divi-5-changelog/ and https://www.divichangelog.com/divi-update/divi-5 (exact per-version dates) 5. **Divi GitHub Repos** — https://github.com/elegantthemes

Official release notes follow `elegantthemes.com/blog/divi-resources/divi-5-<major>-<minor>-release-notes` (5.9 is the exception: `/divi-5-9`). The plugin currently documents through **5.13.1** — start from the next version up.

Community Sources

• **Divi Engine** — https://diviengine.com
• **DiviFlash** — https://diviflash.com
• **WP Zone** — https://wpzone.co
• **Quiroz.co** — https://quiroz.co
• **Pee-Aye Creative** — https://www.peeayecreative.com
• **Reddit r/divi** — Community discussions

Search Queries

"Divi 5" CSS compatibility [current year]
"Divi 5" new features update
"Divi 5" release notes changelog
"Divi 5" breaking changes
"Divi 5" CSS Grid Flexbox
"Divi 5" design variables presets

Step 3: Research Topics

Topic 1: CSS Compatibility Updates

• New supported units or features?
• Changed selector requirements?
• New CSS integration methods?
• Builder field changes?

Topic 2: New Features

• New modules added? (5.6 added Timeline, Breadcrumbs, SVG, Table of Contents, Instagram Feed; 5.8 Tooltip; 5.10 Post Filter + Post Filter Item; 5.11 Charts, Gravity Forms, Imagely Gallery, Payment Button — total now 20+ D5-native modules; 5.12/5.13 added none)
• Has **Components + Slots** (announced after 5.13) shipped? If so, document wrapper classes and how detached per-instance settings render
• New design options (e.g., 5.5 Aspect Ratio/Framing, 5.4 Sizing/Colorscheme Variable Generators, 5.6 Color Scale/Harmony Generators, 5.7 Gradient Variables + text effects, 5.9 Variable Fonts + CSS Grid Editor, 5.12 backdrop-blur/invert/sepia Filters, 5.13 Contact Form Show Labels + Slider swipe controls)?
• New breakpoints or responsive tools?
• Performance improvements?
• Interactions and animation updates?
• Loop Builder / Canvas updates?
• Composable Settings expansions or new pseudo-class editing modes (5.3+)?
• New form field options or modules (5.3 Contact Form 7 Styler, harmonized field options)?

Topic 3: Breaking Changes

• Deprecated selectors or patterns?
• Changed class names?
• Removed features?
• Migration requirements?
• Plugin compatibility issues?

Topic 4: Best Practices

• Updated patterns from community?
• New recommendations from Elegant Themes?
• Performance optimization tips?
• Accessibility improvements?

Step 4: Document Findings

Format for New Findings

## Research Update: [Date]

### CSS Compatibility
- [Finding 1]

### New Features
- [Finding 1]

### Breaking Changes
- [Change 1]

### Best Practices
- [Practice 1]

### Sources
- [URL 1]

Step 5: Update Plugin Knowledge

If significant findings, update:

1. **divi5-compatibility skill** — Add new rules or fix outdated info 2. **divi5-css-patterns skill** — Add new patterns or selectors 3. **divi-selectors.md** — Add new module selectors 4. **divi5-performance skill** — Cache / lazy-loading / asset-loading changes 5. **Config template** — bump the `divi_version` default + comment list in `${CLAUDE_PLUGIN_ROOT}/templates/divi5-toolkit.local.md` and its `last_research` value 6. **Local settings** — Update last_research date

Update Settings File

last_research: [today's date]
research_notes: |
  [Summary of key findings]

Step 6: Report to User

========================================
DIVI 5 RESEARCH REPORT
Date: [today]
========================================

NEW FINDINGS:

CSS Compatibility:
- [Finding with impact assessment]

New Features:
- [Feature with usage notes]

Breaking Changes:
- [Change with migration steps]

KNOWLEDGE BASE UPDATES:
- Updated [skill] with [changes]

SOURCES:
- [Source with URL]

RECOMMENDATIONS:
- [Action items for user]

========================================

Research Triggers

This command should run: 1. **On-demand** — User runs `/divi5-toolkit:research` 2. **Automatic** — When divi5-researcher agent detects stale knowledge (>7 days) 3. **Error-triggered** — When unknown Divi error is encountered