Generate AI guides

[theodorosploumis]

AI guides

We are going to generate AI instructions, rules, guides and md files from this repository that could be used on several coding tools like:

• gemini cli
• claude code
• grok cli
• codex
• warp
• opencode
• task-manager

Important sections on README

• 2. Site building
• 3. Theming, templates

Example files

Examples of files we need to generate

1. Claude code skills. Each Skill should refer to the sections above and their sub-sections. E.g. 2. Site building > 2.1 Nodes should have its own skill.
2. One AGENTS.md file for AI intructions, inherited from README
3. Rules. Same as 1 above but more generic to support any cli tool.
4. Bash scripts to validate the best practices (by sub-section)
5. AI Commands (e.g. /drupal-best-practices-nodes should refer to 2. Site building > 2.1 Nodes)
6. Anything else that should be useful to apply the best practices into Drupal development when we use AI coding or IDE tools.

Restrictions

• Focus on Drupal 10+. Do not add rules related to Drupal 7.x (they start with (7.x)
• Be more generic regarding the cli tool if possible (avoid cli specific rules when they can be generic)
• Add all the new files you create into a new folder with name ai. Create any other sub-folder if needed.
• Drupal developers are using tools like drush, ddev, composer and git. If you prefer can use commands of these tools for No 4 on ## Example files

Claude skills

• Each claude skill should have its own folder.
• Use the recommended format to add skills.
• Each skill should have a SKILL.md with metadata. It should also have folders like examples, scripts, reference etc.
• The claude skills docs are here: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
• See an example of a skill on https://github.com/anthropics/skills/tree/main/webapp-testing

[theodorosploumis]

Next phase plan.

ddev testing

• Create a drupal 11 ddev instance.
• Install drupal standard profile.
• Create some entity types with bad machine names (see the table on README).
• Use the scripts to test if they work correctly on a real Drupal project.
• Scripts can check for best practices using the Drupal APIs, the Drupal database or the exported configuration yml files.
• Update scripts if needed to meet the requirements for each Skill - Best practice.

Report

• Create a wrapper of all the scripts that generates a report for the whole site by sub-section.