Accessibility rules for Drupal templates and stylesheets. Use when writing or reviewing *.html.twig, *.css, *.pcss, or theme libraries. Covers semantic HTML over ARIA, hide-content-properly utilities, WCAG 2.2 SC 2.5.8 target size, focus-visible, dark/forced-colours modes, and reduced-motion. Loaded by drupal-accessibility.
Accessibility rules for Drupal JavaScript, AJAX, modals, and test layers. Use when writing or reviewing *.js, Drupal.behaviors, dialog/modal code, or *Test.php that exercises the UI. Mandates Drupal.announce(), FocusCommand for AJAX, Playwright over Nightwatch, and Axe-core in PHPUnit. Loaded by drupal-accessibility.
Accessibility rules for Drupal Form API and render arrays. Use when writing or reviewing *.module, *.inc, *Form.php, or any PHP that builds a render array. Covers
Issue-authoring rules for Drupal accessibility work. Use when drafting or reviewing an accessibility issue, MR description, or change record. Enforces structured Bug ID / WCAG SC / severity field block, one-issue-per-criterion scoping, AI disclosure, and manual checks before RTBC. Pair with REFERENCE_BUG_REPORT.md. Loaded by drupal-accessibility.
Dispatcher for Drupal accessibility work. Routes to drupal-a11y-fapi (Form API / PHP), drupal-a11y-dom (Twig / CSS), drupal-a11y-dynamic (JS / AJAX / tests), or drupal-a11y-qa (issue authoring). Use for any Drupal code, theme, or test with accessibility implications.
Guidance for writing or modifying automated tests for Drupal modules (core, contrib, custom). Covers Functional, Kernel, FunctionalJavascript, and Unit tests; required PHPUnit attributes; test namespaces; the Functional dual-container trap; DDEV env vars; and mistakes agents often make.
Guidance for working with Drupal's configuration system — choosing between config, state, and settings; writing config schema; simple config vs. config entities; config dependencies; third-party settings; the config export workflow; and the override system. Covers the mistakes AI agents make most frequently when generating configuration code.
Guidance for working with Drupal's render pipeline — render arrays, cacheability metadata, cache tag propagation, lazy builders, BigPipe, and the render element types. Covers the mistakes AI agents make most frequently when generating controller and block output, especially caching bugs that are invisible in development.