Test: add forms claude codex by CGastrell · Pull Request #47144 · Automattic/jetpack

CGastrell · 2026-02-16T16:30:39Z

WIP

Proposed changes:

Add a thin codex system to keep up with our code major guidelines and processes. The idea is to provide agents with pointers to processes and flows, tooling and commands, so that whenever a task is started it doesn't have to search the entire base.

Other information:

Have you written new tests for your changes, if applicable?
Have you checked the E2E test CI results, and verified that your changes do not break them?
Have you tested your changes on WordPress.com, if applicable (if so, you'll see a generated comment below with a script to run)?

Jetpack product discussion

p1771259406233769-slack-C052XEUUBL4

Does this pull request change what data or activity we track or use?

No

Testing instructions:

TBD

github-actions · 2026-02-16T16:31:29Z

Are you an Automattician? Please test your changes on all WordPress.com environments to help mitigate accidental explosions.

To test on WoA, go to the Plugins menu on a WoA dev site. Click on the "Upload" button and follow the upgrade flow to be able to upload, install, and activate the Jetpack Beta plugin. Once the plugin is active, go to Jetpack > Jetpack Beta, select your plugin (Jetpack), and enable the test/forms-add-claude-codex branch.
To test on Simple, run the following command on your sandbox:

bin/jetpack-downloader test jetpack test/forms-add-claude-codex

Interested in more tips and information?

In your local development environment, use the jetpack rsync command to sync your changes to a WoA dev blog.
Read more about our development workflow here: PCYsg-eg0-p2
Figure out when your changes will be shipped to customers here: PCYsg-eg5-p2

github-actions · 2026-02-16T16:31:48Z

Thank you for your PR!

When contributing to Jetpack, we have a few suggestions that can help us test and review your patch:

✅ Include a description of your PR changes.
✅ Add a "[Status]" label (In Progress, Needs Review, ...).
✅ Add testing instructions.
✅ Specify whether this PR includes any changes to data or privacy.
✅ Add changelog entries to affected projects

This comment will be updated as you work on your PR and make changes. If you think that some of those checks are not needed for your PR, please explain why you think so. Thanks for cooperation 🤖

Follow this PR Review Process:

Ensure all required checks appearing at the bottom of this PR are passing.
Make sure to test your changes on all platforms that it applies to. You're responsible for the quality of the code you ship.
You can use GitHub's Reviewers functionality to request a review.
When it's reviewed and merged, you will be pinged in Slack to deploy the changes to WordPress.com simple once the build is done.

If you have questions about anything, reach out in #jetpack-developers for guidance!

Jetpack plugin:

The Jetpack plugin has different release cadences depending on the platform:

WordPress.com Simple releases happen as soon as you deploy your changes after merging this PR (PCYsg-Jjm-p2).
WoA releases happen weekly.
Releases to self-hosted sites happen monthly:
- Scheduled release: March 3, 2026
- Code freeze: March 3, 2026

If you have any questions about the release process, please ask in the #jetpack-releases channel on Slack.

Copilot

Pull request overview

This PR introduces a codex system to help Claude AI agents (and human developers) navigate the Jetpack Forms package more efficiently. The codex serves as a persistent architecture documentation system that provides quick orientation without requiring developers to re-read thousands of lines of source code.

Changes:

Added a comprehensive .codex/ documentation system for the Forms package with architecture maps, flow documentation, and file deep-dives
Created command templates (codex-init and codex-update) to bootstrap and maintain codex systems for other projects
Updated root and project-level CLAUDE.md files with guidance on using the codex system

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
`projects/packages/forms/changelog/test-forms-add-claude-codex`	Changelog entry documenting the addition of the codex system
`projects/packages/forms/CLAUDE.md`	Project-specific documentation with tooling commands and codex reference
`projects/packages/forms/.codex/README.md`	Bootstrap file explaining how to use the codex system
`projects/packages/forms/.codex/map.md`	Architecture overview with file inventory and class relationships
`projects/packages/forms/.codex/references.md`	External dependency references including Gutenberg, WordPress Core, and Jetpack packages
`projects/packages/forms/.codex/log.md`	Creation log documenting initial codex setup
`projects/packages/forms/.codex/flows/*.md`	Five flow documentation files covering form rendering, submission, validation, JWT encryption, and email sending
`projects/packages/forms/.codex/files/*.md`	Three deep-dive documentation files for complex classes (3,000+ lines each)
`CLAUDE.md`	Root-level documentation providing repository overview and development commands
`.claude/CLAUDE.md`	Updated to reference the new codex system
`.claude/commands/codex-init.md`	Command template for bootstrapping new codex systems
`.claude/commands/codex-update.md`	Command template for maintaining codex documentation

CLAUDE.md

projects/packages/forms/changelog/test-forms-add-claude-codex

projects/packages/forms/.codex/references.md

jp-launch-control · 2026-02-16T16:42:23Z

Code Coverage Summary

This PR did not change code coverage!

That could be good or bad, depending on the situation. Everything covered before, and still is? Great! Nothing was covered before? Not so great. 🤷

Full summary · PHP report · JS report

_{Coverage check overridden by

Coverage tests to be added later
Use to ignore the Code coverage requirement check when tests will be added in a follow-up PR
.}

CLAUDE.md

Copilot

Pull request overview

Copilot reviewed 18 out of 18 changed files in this pull request and generated 9 comments.

projects/packages/forms/CLAUDE.md

projects/packages/forms/.codex/map.md

projects/packages/forms/.codex/references.md

projects/packages/forms/.codex/README.md

CLAUDE.md

projects/packages/forms/.codex/flows/jwt-encryption.md

Copilot · 2026-02-16T19:04:36Z

projects/packages/forms/changelog/test-forms-add-claude-codex

+Significance: minor
+Type: added
+
+Add codex system for Claude to keep track of useful guidelines for our code


Changelog entry should follow the repo guidelines (imperative, capitalized, and ending with a period). Line 4 is missing a trailing period, and it may be worth wording it as a user-facing/docs change rather than referencing a specific tool name (“Claude”).

Suggested change

Add codex system for Claude to keep track of useful guidelines for our code

Add codex system to document useful coding guidelines.

projects/packages/forms/.codex/files/class-contact-form.md

Forms: update codex with file field email rendering gotchas Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…ff, use .claude/CLAUDE instead

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 1 comment.

projects/packages/forms/CLAUDE.md

dhasilva · 2026-02-17T00:39:49Z

.claude/commands/codex-update.md

+### 6. Log the update
+
+Append to `.codex/log.md`:
+
+```markdown
+## YYYY-MM-DD — [Brief description of changes]
+- Changed files: [list]
+- Updated codex docs: [list]
+- Notes: [any gaps found, improvements needed]
+```


This confused Claude in my test. It added a log of the branch changes, not of the changes it made to the codex files (none). We should probably make it clearer that the log is for changex in the codex only, not a changelog of the project.

…odex with new format

CGastrell self-assigned this Feb 16, 2026

Copilot AI review requested due to automatic review settings February 16, 2026 16:30

Copilot started reviewing on behalf of CGastrell February 16, 2026 16:31 View session

github-actions bot added [Feature] Forms Docs labels Feb 16, 2026

Copilot AI reviewed Feb 16, 2026

View reviewed changes

CLAUDE.md Outdated Show resolved Hide resolved

projects/packages/forms/changelog/test-forms-add-claude-codex Show resolved Hide resolved

projects/packages/forms/.codex/references.md Outdated Show resolved Hide resolved

Copilot AI review requested due to automatic review settings February 16, 2026 18:56

Copilot started reviewing on behalf of CGastrell February 16, 2026 18:57 View session

dhasilva reviewed Feb 16, 2026

View reviewed changes

CLAUDE.md Outdated Show resolved Hide resolved

Copilot AI reviewed Feb 16, 2026

View reviewed changes

CGastrell and others added 2 commits February 16, 2026 16:23

add changelog

28faf89

CGastrell force-pushed the test/forms-add-claude-codex branch from dbfda24 to ea81c84 Compare February 16, 2026 19:24

CGastrell and others added 2 commits February 16, 2026 18:56

remove repo-wide CLAUDE file, it only held basic (maybe outdated) stu…

74afce7

…ff, use .claude/CLAUDE instead

Scope codex system and commands to packages/forms only

8225b1f

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Copilot AI review requested due to automatic review settings February 16, 2026 22:11

Copilot started reviewing on behalf of CGastrell February 16, 2026 22:11 View session

Copilot AI reviewed Feb 16, 2026

View reviewed changes

projects/packages/forms/CLAUDE.md Show resolved Hide resolved

dhasilva reviewed Feb 17, 2026

View reviewed changes

iterate with Claude for efficiency and scalability, rewrite package c…

2e73daf

…odex with new format

	Add codex system for Claude to keep track of useful guidelines for our code
	Add codex system to document useful coding guidelines.

Conversation

CGastrell commented Feb 16, 2026

Proposed changes:

Other information:

Jetpack product discussion

Does this pull request change what data or activity we track or use?

Testing instructions:

Uh oh!

github-actions bot commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 16, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jp-launch-control bot commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code Coverage Summary

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

dhasilva Feb 17, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions bot commented Feb 16, 2026 •

edited

Loading

jp-launch-control bot commented Feb 16, 2026 •

edited

Loading