drupal-core

General-purpose Drupal development subagent with access to all drupal-core skills. Delegates specialized tasks and answers Drupal architecture, API, and best practice questions.

Cache bins, tags, contexts, invalidation strategies, and external caching for Drupal 10/11. Use when implementing caching, optimizing performance, or configuring cache backends.

Use when reviewing Drupal code for standards compliance across PHP, JavaScript, CSS, Twig, YAML, SQL, and markup — dynamically loads relevant standards per file type using Drupal's official community guidelines.

PHPCS, PHPStan, naming conventions, and code style enforcement for Drupal 10/11. Use when checking coding standards, running static analysis, or enforcing code quality.

Configuration management patterns for Drupal 10/11 — config split, config ignore, environments, import/export workflows, config readonly, and the sync/install/optional directory hierarchy. Use when working with config export/import, multi-environment deployments, config split setup, or managing configuration across dev/staging/prod.

Use when setting up editorial workflows, managing publishing states, or configuring content approval processes. Covers Drupal core Workflows and Content Moderation modules — states, transitions, and entity type/bundle attachments.

Comprehensive guide for managing Drupal contributed modules via Composer, including updates, patches, version compatibility, and Drupal 11 upgrades. Use when updating modules or resolving dependency issues.

REQUIRED when user mentions a Drupal module + error/bug/issue - even without stack traces. Trigger on: (1) "<module_name> module has an error/bug/issue", (2) "Acquia/Pantheon/Platform.sh" + module problem, (3) any contrib module name (metatag, webform, mcp, paragraphs, etc.) + problem description. Searches drupal.org BEFORE you write code changes. NOT just for upstream contributions - use for ALL local fixes to contrib/core.

Load Drupal-specific conventions (translations, CSS, error handling) on demand. Use when working on theming, translations, or exception handling.

DDEV local development environment patterns for Drupal, including configuration, commands, database management, debugging tools, and performance optimization.

Search and fetch official Drupal documentation from drupal.org and api.drupal.org. Matches natural language queries against a curated URL catalog and retrieves relevant documentation pages. Use when you need authoritative Drupal documentation.

Use when creating automated reactions to Drupal site events with ECA (Event-Condition-Action) workflows — covers component wiring, plugin discovery, and module management for content creation, form submissions, and user actions.

Field type selection, entity CRUD operations, view modes, and content modeling patterns for Drupal 10/11. Use when designing content types, selecting field types, or working with the Entity API.

Manage fields across all fieldable entity types, including field CRUD, form display widgets, view display formatters, and display mode configuration.

Drupal frontend and theming expertise. Use when working with Twig templates, Single Directory Components (SDC), theme development, CSS/JS libraries, Drupal.behaviors, or accessibility.

OOP hooks (Drupal 11), form alters, entity hooks, and legacy bridges for Drupal 10/11. Use when implementing hooks, form alterations, or event subscribers.

Drupal JSON:API module patterns for AI agents. Covers CRUD operations, filtering, sorting, pagination, includes, media upload, formatted text fields, path aliases, and common pitfalls. Use when interacting with Drupal content via the JSON:API.

Core Drupal development rules covering code quality, security, services, and testing verification. ALWAYS consult when writing Drupal code.

Create and maintain Drupal Single Directory Components (SDC) -- directory structure, component.yml schema, Twig templates, props/slots, compound patterns, and review criteria.

Manage Drupal Search API servers, indexes, fields, processors, and indexing operations. Use when creating search infrastructure, configuring search backends (Database, Solr, AI/vector search), adding fields or processors to indexes, or running indexing operations.

Comprehensive security auditing workflow for Drupal sites. Covers user accounts, role permissions, module inventory, site configuration, text formats, views access, file exposure, content injection scanning, and integration with the security_review contrib module. Use when performing security assessments, hardening a Drupal site, or investigating potential vulnerabilities.

OWASP prevention patterns, access control, input sanitization, and XSS protection for Drupal 10/11. Use when reviewing code for security issues, implementing access control, or hardening Drupal applications.

Service definitions, dependency injection patterns, and interface design for Drupal 10/11. Use when creating services, registering dependencies, or implementing the service container pattern.

Storybook patterns for Drupal Single Directory Components (SDC). Covers atomic design hierarchy, story organization, naming conventions, controls matching component props, structural testing via stories, page stories as regression references, and asset handling.

Practical Drupal testing patterns using curl smoke tests, drush eval, and test scripts. Use when verifying Drupal implementations actually work - module enabled, service exists, page renders, config correct.

Manage Drupal Views -- creating views, configuring displays, adding fields/filters/sorts/relationships/contextual filters, setting formats, page/block settings, and more.

Visual regression testing patterns for Drupal using Playwright screenshots and BackstopJS. Covers baseline capture, multi-viewport comparison, Drupal-specific concerns (toolbar masking, cache timing, status messages), CI integration, and review workflows.

Use when working with Drush CLI for Drupal site management - running cache rebuilds, config imports/exports, database queries, PHP evaluation, module management, user operations, or troubleshooting Drush commands that no longer exist

Manage Drupal migrations (import, rollback, status, debug)

Drupal performance optimization expertise. Use when working on caching, database queries, asset optimization, lazy loading, BigPipe, or profiling.

Quick inline code review for refactoring opportunities. Identifies over-engineering, god classes, missing interfaces, fat controllers, and Drupal anti-patterns.

Twig template patterns, filters, theme suggestions, and component architecture for Drupal 10/11. Use when creating or modifying Twig templates, implementing theme hooks, or building front-end components.

Use when starting any conversation in a Drupal project — establishes available Drupal development skills and when to invoke them

Use when starting any conversation in a Drupal project — establishes available Drupal development skills and when to invoke them

WCAG 2.2 compliance, keyboard navigation, ARIA patterns, and automated a11y testing for Drupal

Generate complete, installable Drupal 11 modules. This plugin transforms Claude into a senior Drupal architect with deep knowledge of Drupal 11 core APIs, modern development patterns, and best practices.

Diagnose and fix common Drupal code-level issues (hooks, services, cache, entities, routes, permissions)

Use when working with Drupal APIs — comprehensive patterns covering services, hooks, forms, entities, caching, testing, and 50+ topics from "Drupal at Your Fingertips" by Selwyn Polit.

1 hook across 1 event

Drush commands via MCP — run drush commands without leaving the AI session

Browser automation for visual testing and Drupal admin UI interaction