LLM Playbooks¶

Instruction guides that teach AI assistants how to operate Divi 5.

Quick Reference

What These Are¶

Playbooks are LLM-first documentation. Their primary reader is an AI assistant (Claude, ChatGPT, Copilot, etc.) that's been asked to help someone build or modify a Divi 5 website. Their secondary reader is a human trying to understand how to use AI tools with Divi effectively.

This is fundamentally different from the reference docs in the rest of this site. Reference docs answer "what does this setting do?" Playbooks answer "how do I actually accomplish this task, step by step, without hitting the landmines?"

Why These Exist¶

Every Divi user who asks an AI assistant for help gets the same experience: the AI gives advice that sounds plausible but breaks in Divi's specific context. Divi 5's Visual Builder has behaviors, constraints, and quirks that no LLM has been trained on. These playbooks fix that gap.

How to use them: Drop one or more playbooks into your AI assistant's context (Claude Project Knowledge, ChatGPT custom instructions, system prompt, etc.) before asking Divi-related questions. The AI will follow the instructions and avoid the documented pitfalls.

Playbook Index¶

Getting Started¶

Playbook	What It Teaches the LLM
Design System Setup	Configure global typography, colors, and variables BEFORE building pages
Build a Page	End-to-end workflow for creating a new Divi 5 page
Visual Builder Operations	How the VB works — dual-frame architecture, panels, saving behavior

Building & Styling¶

Playbook	What It Teaches the LLM
CSS in Divi 5	When to use Design tab vs Custom CSS vs Free-Form CSS vs child theme
Responsive Design	Breakpoints, device-specific overrides, mobile-first patterns
Layout Patterns	Common section layouts with exact module/row/column configurations
HTML Workarounds	Table-based cards, SVG icons, inline CSS patterns that survive sanitization

Developer Operations¶

Playbook	What It Teaches the LLM
REST API Content Management	Programmatic content creation — block format, encoding, boundaries
Browser Automation	Automating the Visual Builder with Playwright/Claude in Chrome
Theme Builder Operations	Global headers, footers, and post templates

Guardrails¶

Playbook	What It Teaches the LLM
Known Limitations	Things LLMs consistently get wrong about Divi 5
Troubleshooting Decision Tree	Systematic diagnosis for common problems

Contributing Playbooks

If you've discovered a Divi 5 behavior that tripped up your AI assistant, write it up as a playbook. The format is different from reference docs — see the Contributing Guide for playbook-specific guidelines.