Drupal AI Code Guardrails

Drupal AI is a structured system of AI skills, agents, rules, and hooks 
for Drupal teams using Claude Code and Codex.

This is NOT a traditional Drupal module. It is a developer toolkit — 
a collection of knowledge files consumed by AI coding agents, not by 
Drupal itself.

What's included

- **30+ Skills** — focused, versionable knowledge files covering 
  dependency injection, security, caching, entity API, hooks, migrations, 
  Twig, testing, routing, queries, and more. Each skill is small enough 
  to load on demand — no bloated context, no hallucinated patterns.

- **9 Agents** — task-specific executors for backend development, 
  code review, quality gates, testing, frontend, and contributions.

- **8 Rule files** — always-on constraints enforcing Drupal coding 
  standards, PHPCS, DI patterns, workflow conventions, and documentation.

- **Hooks** — automated shell scripts that fire on session start and 
  resume to initialize the development environment.

Why this exists

AI coding agents are already being used by Drupal developers — but 
without structure. The result is AI-generated code with the same 
anti-patterns repeated over and over: \Drupal::service() called inside 
classes, no cache tags, SQL concatenation, outdated hook implementations 
that ignore Drupal 11's OOP #[Hook] attribute.

Drupal AI gives agents the up-to-date, tested, modular knowledge they 
need to produce code that actually follows Drupal best practices.

All skills were tested against Claude Code Opus and verified to be 
picked up correctly. The README for each skill includes human-readable 
explanations and example prompts.

Codex support

The .codex directory mirrors the Claude Code structure. Codex users 
can set up a symbolic link and get the same skills and rules working 
in their environment.

Links

- GitHub: https://github.com/edutrul/drupal-ai
- Full architecture: https://eduardotelaya.com/drupal-ai