Skip to content

docs: refresh Perform AGENTS workflow guidance#130

Open
mehul0810 wants to merge 2 commits into
developfrom
docs/agents-branch-policy
Open

docs: refresh Perform AGENTS workflow guidance#130
mehul0810 wants to merge 2 commits into
developfrom
docs/agents-branch-policy

Conversation

@mehul0810

@mehul0810 mehul0810 commented Jun 15, 2026

Copy link
Copy Markdown
Collaborator

@mehul0810

Learning type

Supersede stale AGENTS snapshot fields and add durable release-cadence workflow guidance.

Evidence

  • gh repo view performwp/perform --json nameWithOwner,defaultBranchRef,url shows the default branch is develop.
  • git branch --format='%(refname:short)' in the local checkout shows active release branches release/1.6.0, release/1.6.1, and release/1.7.0, so a single hardcoded release branch in AGENTS.md is stale.
  • rg -n '^Stable tag:' readme.txt returns Stable tag: 1.6.0, which contradicted the old Current public line: 1.5.1 snapshot.
  • gh run list --repo performwp/perform --limit 8 shows current CI activity on release/1.7.0 and on this docs PR, reinforcing that branch and release state changes over time.
  • rg -n '30 days|7 days|x\\.9\\.x|cadence checkpoints' /Users/mehulgohil/.codex/automations/perform-daily-issue-triage/automation.toml /Users/mehulgohil/.codex/automations/perform-daily-issue-triage/memory.md shows the active Perform automation already uses explicit 30-day minor, 7-day patch, and major-rollover cadence rules that were not yet preserved in repo docs.

Scope

  • Remove the time-sensitive Current public line and Active release branch in this workspace bullets from AGENTS.md.
  • Keep the durable branch and release verification guidance for future agents.
  • Add repo-specific cadence rules for minor releases, patch releases, pre-major rollover, and live checkpoint verification.

Why AGENTS.md is the durable home

  • This is repo-specific branch, release, and cadence workflow policy that future automations need before choosing bases or trusting release timing.
  • Leaving it only in automation prompts or memory would allow the same drift to repeat.

What future agents should do differently

  • Start workflow-policy and docs PRs from develop unless live release evidence proves a different base.
  • Verify release/<milestone> branches, readme.txt, GitHub releases, and WordPress.org state live each run.
  • Evaluate release readiness against the 30-day minor cadence, 7-day patch cadence, and pre-major rollover rule, while pulling the active milestone due date live instead of hardcoding dates in AGENTS.md.
  • Set PR bases explicitly instead of inheriting GitHub defaults.

Base branch

  • Base: develop
  • Why: this PR changes durable workflow guidance only, and live repo metadata shows develop is the current integration/default branch.

Validation

  • Reviewed the docs-only diff with git diff -- AGENTS.md.
  • Ran git diff --check after the AGENTS update.

Rollback or removal notes

  • If the repo adopts a different branch model or cadence later, update this section again with live evidence instead of reintroducing fixed snapshot values.

@github-actions

github-actions Bot commented Jun 15, 2026

Copy link
Copy Markdown

Test on Playground
Test this pull request on the Playground

@mehul0810 mehul0810 added type: maintenance Engineering maintenance, CI, dependency, refactor, tooling, or release hygiene. area: docs Documentation URLs, help links, readme copy, changelog, or support guidance. labels Jun 15, 2026
@mehul0810 mehul0810 changed the title docs: refresh Perform AGENTS branch guidance docs: refresh Perform AGENTS workflow guidance Jun 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Documentation URLs, help links, readme copy, changelog, or support guidance. type: maintenance Engineering maintenance, CI, dependency, refactor, tooling, or release hygiene.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant