# Default AGENTS.md for themes and plugins

**URL:** https://meta.discourse.org/t/default-agents-md-for-themes-and-plugins/390102
**Category:** Development
**Created:** [December 1, 2025, 9:06pm UTC](https://meta.discourse.org/t/default-agents-md-for-themes-and-plugins/390102 "2025-12-01T21:06:15Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [December 1, 2025, 9:06pm UTC](https://meta.discourse.org/t/default-agents-md-for-themes-and-plugins/390102/1 "2025-12-01T21:06:15Z")

</div>

I recently read about [Writing a good CLAUDE.md | HumanLayer Blog](https://www.humanlayer.dev/blog/writing-a-good-claude-md?utm_source=tldrdev) , which made me notice [discourse/AI-AGENTS.md at main · discourse/discourse · GitHub](https://github.com/discourse/discourse/blob/main/AI-AGENTS.md), 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

````plaintext

# 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?