docs: Add plugin-structure instructions, CLAUDE.md, clean up scratch file, and resolve merge conflicts by Copilot · Pull Request #370 · lightspeedwp/.github

Copilot · 2026-05-20T14:29:43Z

Completes the stalled instructions work by adding two missing referenced files, removing a leftover scratch file from the repo root, and merging the latest develop changes.

Linked issues

Relates to #

What changed

.github/instructions/plugin-structure.instructions.md — new org-wide instruction file for WordPress block plugin structure: canonical directory layout (single- and multi-block), block.json conventions ($schema, apiVersion: 3, automatic asset loading via register_block_type()), editor/front-end asset separation, security (sanitize/escape/nonces), i18n (POT + JSON pipeline), and PHP class organisation
CLAUDE.md — new repo-root file providing Claude AI with project context, dev commands, key conventions, and boundary rules; companion to the existing AGENTS.md
AGENTS.md — added CLAUDE.md entry to the Cross-References & Discoverability table for bidirectional linking; accepted develop version of table rows (better column alignment, updated agents/agent.md path)
Copilot-Processing.md — removed from repo root (scratch file, gitignored in .github/tmp/)
Merge conflicts resolved — merged origin/develop into the PR branch; resolved AGENTS.md content conflict (took develop alignment/path updates) and the Copilot-Processing.md modify/delete conflict (kept file deleted)

Audience & placement

Audience: contributors, AI agents (Claude, Copilot, Codex)
Location: .github/instructions/, repo root

Preview / Screenshots

N/A — documentation only.

Notes

Sources/references: instructions.instructions.md, WordPress Block Editor Handbook, @wordpress/create-block

Changelog

Added

plugin-structure.instructions.md: org-wide WordPress block plugin structure conventions covering directory layout, block.json, asset enqueueing, security, and i18n.
CLAUDE.md: Claude AI companion instructions at repo root, covering repo purpose, dev commands, boundary rules, and key conventions.

Changed

AGENTS.md: added CLAUDE.md entry to the Cross-References & Discoverability table; updated agents/agent.md path and column alignment to match develop.

Fixed

Removed

Copilot-Processing.md scratch file removed from repo root.

Checklist (Global DoD / PR)

Original prompt

can you restart this work and complete it?

The user has attached the following file paths as relevant context:

.github/instructions/plugin-structure.instructions.md

.github/instructions/.archive/file-management.instructions.md

.github/instructions/a11y.instructions.md

.github/instructions/coding-standards.instructions.md

.github/instructions/copilot-operations.instructions.md

.github/instructions/file-organisation.instructions.md

.github/instructions/labeling.instructions.md

.github/instructions/self-explanatory-code-commenting.instructions.md

.github/instructions/spec-driven-workflow.instructions.md

.github/instructions/tasksync.instructions.md

.github/copilot-instructions.md

.github/copilot-instructions.md

AGENTS.md

AGENTS.md

CLAUDE.md

AGENTS.md

CLAUDE.md

AGENTS.md

CLAUDE.md

Created from VS Code.

- Create .github/instructions/plugin-structure.instructions.md with WordPress block plugin structure conventions (directory layout, block.json, enqueueing, security, i18n, PHP organisation) - Create CLAUDE.md at repo root as Claude AI companion to AGENTS.md - Remove Copilot-Processing.md scratch file from repo root (moved to .github/tmp/ which is gitignored) - Update AGENTS.md cross-references table to include CLAUDE.md entry Agent-Logs-Url: https://github.com/lightspeedwp/.github/sessions/bedf8bf7-2de3-473b-a489-e45580925aee Co-authored-by: ashleyshaw <1805352+ashleyshaw@users.noreply.github.com>

ashleyshaw · 2026-05-20T15:00:22Z

@copilot I created a github issue here - #13

You created a pull request but never did anything - #336

I want you to proceed the #21 issue and working in the #333 PR, how do I get you to do that?

Copilot · 2026-05-20T15:01:43Z

@copilot I created a github issue here - #13

You created a pull request but never did anything - #336...

To direct me to a specific issue and PR, here are the two best options:

To continue work on issue #21 inside PR #333:
Go to PR #333 and leave a comment like @copilot please work on issue #21 in this PR (or simply describe what you want done). The Copilot coding agent responds to comments mentioning @copilot on open PRs.

To start fresh on issue #21 with a new PR:
Go to issue #21 and click "Start working with Copilot" (the Copilot button), or leave a comment on the issue mentioning @copilot with the task description. This will create a new PR automatically.

Note: PR #333 is currently scoped to the CONTRIBUTING.md audit, not issue #21 (the a11y/security checklist task). If you want both in the same PR, just clarify that in a comment on #333 and I'll pick it up there.

ashleyshaw · 2026-05-20T15:14:11Z

@copilot is there anything else you can do on this issue? - #13

Copilot · 2026-05-20T15:15:08Z

@copilot is there anything else you can do on this issue? - #13

Issue #13 (migrate CI scripts from bash to JavaScript) is a significant engineering task that's out of scope for this documentation PR.

The dedicated PR for it is #336. To get me working on it, go to PR #336 and leave a comment like @copilot please implement the changes described in issue #13 — I'll pick up the task from there and start making the actual code changes.

Alternatively, you can close PR #336 and comment on issue #13 itself with @copilot to have me create a fresh PR scoped to that work.

ashleyshaw · 2026-05-20T15:27:12Z

@copilot have you committed these files

Copilot · 2026-05-20T15:28:07Z

@copilot have you committed these files

Yes — all four files were committed in commit 5dc42db:

✅ .github/instructions/plugin-structure.instructions.md — added
✅ CLAUDE.md — added
✅ AGENTS.md — updated with CLAUDE.md cross-reference
✅ Copilot-Processing.md — removed from repo root

The PR branch copilot/restart-work-on-instructions is pushed and ready for review.

ashleyshaw · 2026-05-26T02:30:52Z

@copilot resolve the merge conflicts in this pull request

…rk-on-instructions # Conflicts: # AGENTS.md # Copilot-Processing.md Co-authored-by: ashleyshaw <1805352+ashleyshaw@users.noreply.github.com>

Copilot · 2026-05-26T02:33:07Z

@copilot resolve the merge conflicts in this pull request

Done — merged develop into the branch and resolved both conflicts in commit 28f3e60:

AGENTS.md — took the develop version (better column alignment, updated agents/agent.md path)
Copilot-Processing.md — kept deleted (the scratch file removal was intentional)

chatgpt-codex-connector · 2026-05-26T02:34:05Z

💡 Codex Review

.github/CLAUDE.md

Line 57 in 5dc42db

npm run validate:frontmatter

Replace nonexistent frontmatter validation command

The development command npm run validate:frontmatter is not defined in this repository, so anyone following this setup block will immediately fail with Missing script and may skip validation altogether. Please point this step at an existing script (or add the script) so the onboarding commands are runnable as documented.

.github/.github/instructions/plugin-structure.instructions.md

Line 201 in 5dc42db

    
           - Check `block.json` validates against the schema: `npx @wordpress/scripts check-engines`.

Use a real block metadata validation command

This line claims npx @wordpress/scripts check-engines validates block.json schema, but check-engines only checks Node/npm/yarn version ranges (per the @wordpress/scripts command docs) and does not validate block metadata. That gives a false validation signal and can let invalid block.json files pass the documented checklist.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Initial plan

e0502c2

Copilot AI assigned Copilot and ashleyshaw May 20, 2026

Copilot started work on behalf of ashleyshaw May 20, 2026 14:29 View session

Copilot AI changed the title ~~[WIP] Restart and complete work on instructions~~ docs: Add plugin-structure instructions, CLAUDE.md, and clean up scratch file May 20, 2026

Copilot finished work on behalf of ashleyshaw May 20, 2026 14:39

Copilot AI requested a review from ashleyshaw May 20, 2026 14:39

Copilot started work on behalf of ashleyshaw May 20, 2026 15:00 View session

Copilot finished work on behalf of ashleyshaw May 20, 2026 15:02

Copilot started work on behalf of ashleyshaw May 20, 2026 15:14 View session

Copilot finished work on behalf of ashleyshaw May 20, 2026 15:16

Copilot started work on behalf of ashleyshaw May 20, 2026 15:27 View session

Copilot finished work on behalf of ashleyshaw May 20, 2026 15:30

ashleyshaw approved these changes May 20, 2026

View reviewed changes

ashleyshaw marked this pull request as ready for review May 26, 2026 02:30

Copilot started work on behalf of ashleyshaw May 26, 2026 02:31 View session

Merge remote-tracking branch 'origin/develop' into copilot/restart-wo…

28f3e60

…rk-on-instructions # Conflicts: # AGENTS.md # Copilot-Processing.md Co-authored-by: ashleyshaw <1805352+ashleyshaw@users.noreply.github.com>

Copilot AI changed the title ~~docs: Add plugin-structure instructions, CLAUDE.md, and clean up scratch file~~ docs: Add plugin-structure instructions, CLAUDE.md, clean up scratch file, and resolve merge conflicts May 26, 2026

Copilot AI requested a review from ashleyshaw May 26, 2026 02:33

Copilot finished work on behalf of ashleyshaw May 26, 2026 02:33

ashleyshaw requested a review from Copilot May 26, 2026 02:49

ashleyshaw merged commit 5ffb472 into develop May 26, 2026

Copilot started reviewing on behalf of ashleyshaw May 26, 2026 02:49 View session

ashleyshaw deleted the copilot/restart-work-on-instructions branch May 26, 2026 02:49

Copilot AI removed the request for review from Copilot May 26, 2026 03:09

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: Add plugin-structure instructions, CLAUDE.md, clean up scratch file, and resolve merge conflicts#370

docs: Add plugin-structure instructions, CLAUDE.md, clean up scratch file, and resolve merge conflicts#370
ashleyshaw merged 3 commits into
developfrom
copilot/restart-work-on-instructions

Copilot AI commented May 20, 2026 •

edited

Loading

Uh oh!

ashleyshaw commented May 20, 2026

Uh oh!

Copilot AI commented May 20, 2026

Uh oh!

ashleyshaw commented May 20, 2026

Uh oh!

Copilot AI commented May 20, 2026

Uh oh!

ashleyshaw commented May 20, 2026

Uh oh!

Copilot AI commented May 20, 2026

Uh oh!

ashleyshaw commented May 26, 2026

Uh oh!

Copilot AI commented May 26, 2026

Uh oh!

chatgpt-codex-connector Bot commented May 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

Copilot AI commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Linked issues

What changed

Audience & placement

Preview / Screenshots

Notes

Changelog

Added

Changed

Fixed

Removed

Checklist (Global DoD / PR)

Uh oh!

ashleyshaw commented May 20, 2026

Uh oh!

Copilot AI commented May 20, 2026

Uh oh!

ashleyshaw commented May 20, 2026

Uh oh!

Copilot AI commented May 20, 2026

Uh oh!

ashleyshaw commented May 20, 2026

Uh oh!

Copilot AI commented May 20, 2026

Uh oh!

ashleyshaw commented May 26, 2026

Uh oh!

Copilot AI commented May 26, 2026

Uh oh!

chatgpt-codex-connector Bot commented May 26, 2026

💡 Codex Review

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented May 20, 2026 •

edited

Loading