Skip to content

Make AGENTS.md the single agent guide and import it from CLAUDE.md - #143

Merged
erseco merged 1 commit into
feature/remove-dead-codefrom
feature/claude-md-sync
Sep 26, 2026
Merged

erseco merged 1 commit into
feature/remove-dead-codefrom
feature/claude-md-sync

Conversation

@erseco

@erseco erseco commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

Stacked on #142. Last of the stack.

One agent guide

CLAUDE.md is now only @AGENTS.md. AGENTS.md is the single guide for every agent. Before this change the two files overlapped and contradicted each other.

CLAUDE.md described things that no longer match the code:

  • .elp files and an "ElpParser";
  • an editor git submodule on release/3.1-…, with a make update-submodule target;
  • classes that no longer exist.

Its useful content moved into AGENTS.md, corrected, which now covers:

Meta keys are listed with their full _exelearning_ names. The branch rule now allows stacked PRs to target the previous branch. The exelearning.php comment about the file service now says .elpx.

The README's "Working with AI coding agents" section now describes the new arrangement.

make architecture-check passes. The ADR-68-01 references to CLAUDE.md "Data Storage" are pinned to a commit and left as accepted history.

@github-actions

github-actions Bot commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

Test in WordPress Playground

Test the plugin with the code from this branch:

Preview in WordPress Playground

ℹ️ The eXeLearning editor is fetched from the shared release and unpacked into the plugin when the playground boots, so the first load may take a few extra seconds. ELP upload, shortcode, Gutenberg block and preview work normally.

@erseco
erseco force-pushed the feature/claude-md-sync branch from 56e056e to 954eb99 Compare September 26, 2026 07:19
@erseco erseco changed the title Bring CLAUDE.md and AGENTS.md in line with the code Make AGENTS.md the single agent guide and import it from CLAUDE.md Sep 26, 2026
@erseco
erseco force-pushed the feature/claude-md-sync branch from 954eb99 to 2af5d25 Compare September 26, 2026 07:20
@erseco
erseco added this pull request to stack #144 September 26, 2026 07:38
@erseco
erseco force-pushed the feature/claude-md-sync branch 2 times, most recently from 0499338 to 61c609c Compare September 26, 2026 07:44
@erseco
erseco force-pushed the feature/claude-md-sync branch from 61c609c to 3ebf047 Compare September 26, 2026 08:01
CLAUDE.md duplicated and contradicted AGENTS.md: it described .elp files, an
ElpParser, an editor git submodule on a 3.1 branch with a make
update-submodule target, and classes that no longer exist. Its content now
lives, corrected, in AGENTS.md, and CLAUDE.md is just '@AGENTS.md'.

AGENTS.md gains how the plugin works (flow, components by area, the REST
table with permissions, meta and options), the real editor build (gitignored
clone pinned by .editor-version), the local environment and the persistent
test uploads directory, the vendored-WP-CLI translation command, and workflow
rules (env: for external values, persist-credentials: false). It drops the
stale ban on Block API version 3, which the block has used since #89.
@erseco
erseco force-pushed the feature/claude-md-sync branch from 3ebf047 to 5fa472e Compare September 26, 2026 08:29
@erseco
erseco merged commit cc94167 into main Sep 26, 2026
5 checks passed
@erseco
erseco deleted the feature/claude-md-sync branch September 26, 2026 08:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant