From 5f3ba8914561219a8670a1dbcc906b04814e3857 Mon Sep 17 00:00:00 2001 From: Cai Frazier Development Date: Tue, 10 Nov 2026 15:59:46 -0800 Subject: [PATCH] docs: no new WordPress must-use plugins in the agent guidance files Heavier features go in proper plugins; small fixes are consolidated into the plugin they belong to or the site's existing site plugin or theme. Existing MU files are being migrated, so none are added in the meantime. --- AGENTS.md | 11 +++++++++++ CLAUDE.md | 11 +++++++++++ 2 files changed, 22 insertions(+) create mode 100644 AGENTS.md create mode 100644 CLAUDE.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..9faf106 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,11 @@ +# AGENTS.md — CF WordPress Plugins + +Orientation for AI coding agents working in this repo. `README.md` covers the plugins, `TESTING.md` the test setup, and `PRODUCT_PRINCIPLES.md` the design rules. Each plugin's `readme.txt` is the source of truth for its version and changelog. + +## WordPress must-use plugins: none new + +Do not create WordPress must-use plugins (`wp-content/mu-plugins/`), and do not ship one from any plugin in this repo. + +- **Heavier features** (their own routes, admin screens, stored data, or files) go in a proper, versioned plugin: the product plugin they belong to, or a new standalone plugin. +- **Small fixes** (CSS, a redirect, schema, an accessibility patch, a single filter) are consolidated into the plugin they belong to, or into the site's existing site plugin or theme when the fix is site-specific rather than product behavior. +- **Existing MU files on sites are being migrated** into those homes. Don't add new ones in the meantime. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..ccab637 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,11 @@ +# CLAUDE.md — CF WordPress Plugins + +Orientation for Claude (and other AI agents) working in this repo. `README.md` covers the plugins, `TESTING.md` the test setup, and `PRODUCT_PRINCIPLES.md` the design rules. Each plugin's `readme.txt` is the source of truth for its version and changelog. + +## WordPress must-use plugins: none new + +Do not create WordPress must-use plugins (`wp-content/mu-plugins/`), and do not ship one from any plugin in this repo. + +- **Heavier features** (their own routes, admin screens, stored data, or files) go in a proper, versioned plugin: the product plugin they belong to, or a new standalone plugin. +- **Small fixes** (CSS, a redirect, schema, an accessibility patch, a single filter) are consolidated into the plugin they belong to, or into the site's existing site plugin or theme when the fix is site-specific rather than product behavior. +- **Existing MU files on sites are being migrated** into those homes. Don't add new ones in the meantime.