drupal / ai_best_practices
A canonical place to put opinionated Drupal best practice guidance for AI agents
Maintainers
This package is auto-updated.
Last update: 2026-03-27 19:05:16 UTC
README
This project attempts to provide a CANONICAL place to put opinionated Drupal best practice guidance for AI agents (and their humans!).
What is the scope?
This project should contain universal guidance that applies across Drupal projects (both core and contrib)
Think of this as Context Control Center (CCC), but for Drupal!
Who is this for? / What guidance goes in here?
Contributors Drupal developers Site builders
How to install
composer config extra.drupal-scaffold.allowed-packages --json --merge '["drupal/ai_best_practices"]'
composer require --dev drupal/ai_best_practices
How to use it with a coding agent
In most cases you only have to start the coding agent in the root of your Drupal project and it will automatically pick up the best practices from this module.
There are some exceptions:
Aider
Configure Aider to use AGENTS.md in .aider.conf.yml:
read: AGENTS.md
Gemini CLI
Configure Gemini CLI to use AGENTS.md in .gemini/settings.json:
{ "context": { "fileName": "AGENTS.md" }}