Default AGENTS.md for themes and plugins

I recently read about Writing a good CLAUDE.md | HumanLayer Blog , which made me notice discourse/AI-AGENTS.md at main · discourse/discourse · GitHub, which made me create my own version for my dashboard plugin. It’s mostly the same as the core one with a few changes like


# JavaScript tests - bin/qunit
# this is a plugin, so we must change to discourse and modify paths
```
cd ~/src/discourse-repos/discourse
bin/qunit --help # detailed help
bin/qunit plugin/discourse-pfaffmanager/path/to/test-file.js  # Run all tests in file
bin/qunit plugin/discourse-pfaffmanager/path/to/tests/directory # Run all tests in directory
 ```
# Linting
# this is a plugin, so we must change to discourse and modify paths
# NOTICE that the --fix switch can be used to correct most issues and should be tried before considering other fixes
 ```
cd ~/src/discourse-repos/discourse
bin/lint --fix plugin/discourse-pfaffmanager/path/to/file path/to/another/file
bin/lint --fix plugin/discourse-pfaffmanager/path/to/file path/to/another/file
bin/lint --fix --recent # Lint all recently changed files
```

And today I worked on a theme component and was reminded that without such help, the AI was very bad at helping.

are there plans to include something like this in the theme and plugin skeletons?

1 Like