From 0610e08d59df2d5c0ea732581c69f179120657dd Mon Sep 17 00:00:00 2001
From: David Stone <david@nnucomputerwhiz.com>
Date: Mon, 6 Apr 2026 21:16:44 -0600
Subject: [PATCH] chore: add wp-cli.yml and local dev environment docs

Point wp-cli at shared WordPress 7.0-RC2 multisite dev install at
../wordpress (wordpress.local:8080). Documents reset workflow and
WP-CLI usage in AGENTS.md.
---
 AGENTS.md  | 18 ++++++++++++++++++
 wp-cli.yml |  2 ++
 2 files changed, 20 insertions(+)
 create mode 100644 wp-cli.yml

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