diff --git a/AGENTS.md b/AGENTS.md
index ea58163d..2b0e3095 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -157,3 +157,21 @@ Set up with: `npm run setup:hooks` or `bash bin/setup-hooks.sh`.
 ## JSON / YAML
 
 Indent with 2 spaces (not tabs). See `.editorconfig`.
+
+## Local Development Environment
+
+The shared WordPress dev install for testing this plugin is at `../wordpress` (relative to this repo root).
+
+- **URL**: http://wordpress.local:8080
+- **Admin**: http://wordpress.local:8080/wp-admin — `admin` / `admin`
+- **WordPress version**: 7.0-RC2
+- **This plugin**: symlinked into `../wordpress/wp-content/plugins/$(basename $PWD)`
+- **Reset to clean state**: `cd ../wordpress && ./reset.sh`
+
+WP-CLI is configured via `wp-cli.yml` in this repo root — run `wp` commands directly from here without specifying `--path`.
+
+```bash
+wp plugin activate $(basename $PWD)   # activate this plugin
+wp plugin deactivate $(basename $PWD) # deactivate
+wp db reset --yes && cd ../wordpress && ./reset.sh  # full reset
+```
diff --git a/wp-cli.yml b/wp-cli.yml
new file mode 100644
index 00000000..d72e23a2
--- /dev/null
+++ b/wp-cli.yml
@@ -0,0 +1,2 @@
+path: ../wordpress
+url: http://wordpress.local:8080