v2.2.1 — Doc catch-up after v2.2.0 (May 27, 2026)

Summary

Content-only patch release. The v2.2.0 release updated the actively maintained docs (README, STATE, docs/usage, docs/configuration, docs/workflows) and the two refreshed SKILL.md files, but left some surfaces behind. v2.2.1 closes those gaps via a parallel three-agent documentation sweep that touched 17 files with +131/-40 lines net.

No new features, no breaking changes, no version-controlled behavior changes. Plugin still validates with claude plugin validate ..

What got caught up

Top-level docs

• CLAUDE.md — "currently 5.2" → "currently 5.6"; architecture diagram's skills/ line now lists divi5-performance alongside the two existing skills.
• docs/troubleshooting.md — 5 new entries:
  • Loop Builder posts not showing or showing wrong posts (query/post-type mismatch, posts_per_page=-1, custom field registration)
  • Loop Builder CSS doesn't apply inside the loop template (.et_pb_loop_item scoping; cross-refs loop-builder.css)
  • New Divi 5.6 module styles not applying (Timeline, Breadcrumbs, SVG, TOC, Instagram Feed — module-specific class selectors, currentColor SVG pattern; cross-refs new-modules.css)
  • Contact Form 7 Styler fields look unstyled (native Styler vs. direct field CSS specificity, 5.3 pseudo-class tabs; cross-refs forms.css)
  • Core Web Vitals are poor (LCP/INP/CLS failing — entry at top of Performance Issues routing to the divi5-performance agent)
• README.md / docs/workflows.md — command counts (6 → 7) and divi_version default (5.2 → 5.6) in non-changelog prose and sample config blocks.

9 older agent/command files (predate v2.2.0)

File	Change
agents/divi5-validator.md	Frontmatter description references Divi 5.6, 5.3 form fields, pseudo-class editing, 5.5 Aspect Ratio/Framing, Composable Settings. Recommends /divi5-toolkit:diagnose for ambiguous symptoms.
agents/divi5-researcher.md	Description names the 5.3–5.6 changelog features and victorduse.com source. New Features research topic expanded to cover 5.6 modules, 5.4/5.6 Variable/Color Generators, 5.3 pseudo-class editing, CF7 Styler, 5.5 Aspect Ratio/Framing.
agents/divi5-accessibility.md	Description references Divi 5.6 and 5.3 pseudo-class editing. Check 1 (Focus Indicators) notes that 5.3 native pseudo-class tabs cover form field focus states — recommends no-code first.
commands/audit.md	divi_version default 5.2 → 5.6. Composable Settings opportunities section adds 5.3 pseudo-class editing. Step 7 routes Category D performance issues to divi5-performance agent or /divi5-toolkit:diagnose.
commands/generate.md	Opening line "v5.2+" → "v5.6, current". Step 5 renamed "Check Builder-Native Alternatives" listing Composable Settings (5.2+), pseudo-class editing (5.3+), Aspect Ratio/Framing (5.5+).
commands/validate.md	Check 13 renamed "Builder-Native Alternatives" and expanded for 5.3+ and 5.5+ paths. Mentions /diagnose for ambiguous symptoms.
commands/convert.md	Conversion 9 renamed "Builder-Native Alternatives (Divi 5.2+)" with a pseudo-class editing example.
commands/research.md	Topic 2 (New Features) expanded with 5.6 module count, 5.4/5.6 Generators, 5.3 pseudo-class editing + CF7 Styler, 5.5 Aspect Ratio/Framing.
commands/scaffold.md	Research-guidance version ref 5.2 → 5.6.

agents/divi5-error-learner.md intentionally left untouched — its version references are accurate historical statements ("fixed in 5.2"), not stale current-state claims.

Skill references + older CSS example headers

• skills/divi5-css-patterns/references/divi-selectors.md — header 5.2 → 5.6; Contact Form 7 Styler row added to Forms table; new section for the 5.6 modules with confirmed selectors and cross-reference to new-modules.css.
• skills/divi5-compatibility/references/unit-conversions.md — header 5.2 → 5.6 (cosmetic; content was already version-agnostic).
• examples/woocommerce.css — header cross-references loop-builder.css for product card grids.
• examples/accessibility.css — header notes 5.3 native focus pseudo-class editing as the preferred path over custom CSS focus ring overrides.
• button-variants.css, design-tokens.css, animations.css, dark-mode.css, hooks/*, and template files verified clean — no changes needed.

Process notes

This release was produced by a three-agent parallel doc sweep coordinated via team mode:

• doc-project (top-level docs, 4 files)
• doc-src-1 (older agents + commands, 9 files)
• doc-src-2 (older skill references + CSS example headers, 4 files)

Each agent ran with a disjoint scope so no file conflicts occurred. Total: 17 files modified, +131 / -40 lines.

Installation

Per-project loading (recommended for active Divi work) — in your project's .claude/settings.local.json:

{
  "extraKnownMarketplaces": {
    "divi5-local": {
      "source": {
        "source": "directory",
        "path": "/absolute/path/to/Divi5-ToolKit"
      }
    }
  },
  "enabledPlugins": {
    "divi5-toolkit@divi5-local": true
  }
}

After restart, /divi5-toolkit: autocompletes all 7 commands. See Installation in the README for per-session and global options.

Changelog

For full release history including v2.2.0 (which added the divi5-performance skill, the divi5-performance agent, the /divi5-toolkit:diagnose command, 5 new CSS examples, and refreshed the knowledge base for Divi 5.3 – 5.6), see README.md Changelog.

🤖 Generated with Claude Code