From ac24fe0b9ab7cebb5212a25413490b34ad3c20e0 Mon Sep 17 00:00:00 2001 From: David Stone Date: Wed, 29 Apr 2026 01:22:38 -0600 Subject: [PATCH] docs: expand AGENTS.md to cover recurring contributor error patterns (GH#978) - Add missing test directories (Builders/, functional/, unit/) to project structure - Clarify WP_Ultimo/ as main test suite in project map - Add three commonly-attempted non-existent paths to the file-not-found table: inc/bootstrap.php, tests/WP_Ultimo/bootstrap.php, inc/class-plugin.php/class-main.php Addresses contributor-insight patterns: read:file_not_found (38x) and bash:other (75x) from superdav42 sessions. Fills gaps identified vs canonical AGENTS.md target state. Fixes #978 --- AGENTS.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index c587bcbc..e667d86c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -68,8 +68,11 @@ inc/ traits/ # Shared traits (Singleton, deprecated compat) exception/ # Runtime_Exception tests/ - WP_Ultimo/ # Unit tests mirroring inc/ structure + WP_Ultimo/ # Unit tests mirroring inc/ structure (main test suite) Admin_Pages/ # Admin page tests + Builders/ # Block editor / widget builder tests + functional/ # Functional/integration tests (e.g. SSO) + unit/ # Standalone unit tests (API schema, checkout request, etc.) e2e/ # Cypress E2E tests bootstrap.php # WP test bootstrap (loads plugin via muplugins_loaded) views/ # PHP template files @@ -267,6 +270,9 @@ read them will produce `read:file_not_found`: | `inc/class-site.php` | Does not exist at root of `inc/`; model classes are in `inc/models/` | | `inc/class-domain.php` | Does not exist at root of `inc/`; model classes are in `inc/models/` | | `lang/*.po`, `lang/*.mo` | Compiled translation files are not tracked; only `lang/ultimate-multisite.pot` is in the repo | +| `inc/bootstrap.php` | Does not exist; plugin bootstraps from `ultimate-multisite.php` at repo root | +| `tests/WP_Ultimo/bootstrap.php` | Does not exist; test bootstrap is at `tests/bootstrap.php` | +| `inc/class-plugin.php`, `inc/class-main.php` | Do not exist; the main plugin class is `inc/class-wp-ultimo.php` | Always verify a file is tracked before reading it with `git ls-files ''`. An empty result means the file does not exist in the repo.