Trim CLAUDE.md to what the codebase can't tell you #141

2026-07-29T19:40:35Z

thatguygriff commented

2026-07-29 19:40:35 +00:00

Most of CLAUDE.md described the repo as it was around v1.0: three domain packages, two database tables, twenty-one classes. There are now eleven packages, fifteen tables, and well over a hundred classes — so those sections weren't just redundant with ls and Schema.php, they were teaching the wrong shape of the codebase. The CI section had drifted too (no build job).

Cut (all derivable, all stale): the command list (composer.json has the scripts), the plugin-bootstrap description, the directory tree, the database table list, the Key Classes table, and the CI job summary.

Kept — every rule the code can't explain on its own: package-by-domain organisation, no $wpdb outside repositories, capability checks rather than role-name checks, and the Schema.php version-bump gotcha (schema change without a version bump never reaches existing sites).

Moved: the Brain\Monkey and Mockery API gotchas now live in tests/CLAUDE.md, which loads only when working under tests/ rather than in every session.

Net: 6,985 → 1,986 chars in the always-loaded file.

Tests

Documentation only — no PHP changed, so composer test / lint / cs were not run locally. CI will run them on this PR.

No CHANGELOG.md entry: this changes agent guidance, not anything a plugin user sees.

🤖 Generated with Claude Code

Most of CLAUDE.md described the repo as it was around v1.0: three domain packages, two database tables, twenty-one classes. There are now eleven packages, fifteen tables, and well over a hundred classes — so those sections weren't just redundant with `ls` and `Schema.php`, they were teaching the wrong shape of the codebase. The CI section had drifted too (no `build` job). **Cut** (all derivable, all stale): the command list (`composer.json` has the scripts), the plugin-bootstrap description, the directory tree, the database table list, the Key Classes table, and the CI job summary. **Kept** — every rule the code can't explain on its own: package-by-domain organisation, no `$wpdb` outside repositories, capability checks rather than role-name checks, and the `Schema.php` version-bump gotcha (schema change without a version bump never reaches existing sites). **Moved**: the Brain\Monkey and Mockery API gotchas now live in `tests/CLAUDE.md`, which loads only when working under `tests/` rather than in every session. Net: 6,985 → 1,986 chars in the always-loaded file. ## Tests Documentation only — no PHP changed, so `composer test` / `lint` / `cs` were not run locally. CI will run them on this PR. No `CHANGELOG.md` entry: this changes agent guidance, not anything a plugin user sees. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

thatguygriff added 1 commit 2026-07-29 19:40:35 +00:00

Trim CLAUDE.md to what the codebase can't tell you

CI / Tests (PHP 8.2) (pull_request) Successful in 53s

Details

CI / No Debug Code (pull_request) Successful in 3s

Details

CI / Coding Standards (pull_request) Successful in 2m54s

Details

CI / PHPStan (pull_request) Successful in 3m0s

Details

CI / Tests (PHP 8.1) (pull_request) Successful in 53s

Details

CI / Tests (PHP 8.3) (pull_request) Successful in 2m47s

Details

CI / Build Plugin Zip (pull_request) Skipped

Details

7fdf97b073

Most of this file described the repo as it was around v1.0: three domain
packages, two database tables, twenty-one classes. There are now eleven
packages, fifteen tables, and well over a hundred classes, so those
sections were not just redundant with `ls` and Schema.php — they were
teaching the wrong shape of the codebase. Same for the CI section, which
had drifted past the build job.

Cut the command list (composer.json has the scripts), the bootstrap
description, the directory tree, the table list, the Key Classes table,
and the CI job summary. Kept every rule the code can't explain on its
own: package-by-domain, no $wpdb outside repositories, capability checks
rather than role names, and the Schema.php version-bump gotcha.

Moved the Brain\Monkey and Mockery gotchas to tests/CLAUDE.md, which
loads only when working under tests/ instead of in every session.

Co-Authored-By: Claude Opus 5 <[email protected]>

thatguygriff merged commit 7ea6616ba0 into main

2026-07-29 19:41:35 +00:00

thatguygriff deleted branch docs/trim-claude-md

2026-07-29 19:41:35 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Unsupervised/unsupervised-scheduler#141