Refresh AGENTS.md so repo workflow guidance does not encode stale release facts
Open
@mehul0810 is already working on this.
Since Jul 7, 2026.
area: docs
priority: medium
status: ready
type: maintenance
- Dominant language
- PHP
- Stars
- 5
- Forks
- 2
- PR merge metrics
- No merged PRs in 30d
Description
Summary
AGENTS.md exists, but its source-of-truth section is stale enough to misroute product and worker behavior.
Evidence
/AGENTS.mdstill saysCurrent public line: 1.5.1./AGENTS.mdstill saysActive release branch in this workspace: release/1.6.0.- Live repo state now has default branch
develop, active release branch work onrelease/1.7.0, beta tag1.7.0.beta.1, and stable public line1.6.0.
Why this matters
PO and worker threads are expected to rehydrate live state first, but the repo-local guardrail doc should not start from incorrect branch and release assumptions.
Scope
- Refresh
AGENTS.mdsource-of-truth guidance so it does not hard-code stale branch/public-line facts. - Make the doc explicitly tell agents to verify live repo, release branch, GitHub release, and WordPress.org state before acting.
- Keep repo workflow guidance durable without encoding time-sensitive facts that drift quickly.
Acceptance criteria
AGENTS.mdno longer states stale public-line or active-release-branch values as fixed facts.- The doc clearly distinguishes durable rules from live state that must be rechecked.
- Release-branch, PR-base, and public-version guidance matches current Perform workflow.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.