Skip to content

feat: Make prepare-release project-agnostic & GitHub-Release-aware (prepare-github-release)#28

Merged
miguelcolmenares merged 1 commit into
mainfrom
feature/27-prepare-github-release
Jun 30, 2026
Merged

feat: Make prepare-release project-agnostic & GitHub-Release-aware (prepare-github-release)#28
miguelcolmenares merged 1 commit into
mainfrom
feature/27-prepare-github-release

Conversation

@miguelcolmenares

Copy link
Copy Markdown
Member

Summary

Renames prepare-releaseprepare-github-release and refactors it into a project-agnostic, GitHub-Release-aware orchestrator. It auto-detects WordPress plugin vs Node/npm package and analyzes the repo's GitHub Actions workflows to choose the correct post-merge action (bare tag vs full Release).

Motivated by the v2.5.0 release of this very repo, where the old WordPress-only prompt didn't apply to an npm package and gave wrong "push the tag and it publishes" guidance (publish.yml triggers on release: created).

Related Issue

Closes #27

Changes Made

  • Rename prepare-release.prompt.mdprepare-github-release.prompt.md (no alias). Releases are GitHub-only (Bitbucket has no Releases), so this aligns with the existing *-github-* convention.
  • Agnostic orchestrator — detects project type → loads the matching partial; promotes [Unreleased][X.Y.Z]; creates release/vX.Y.Z branch + PR; analyzes .github/workflows/*.yml to distinguish:
    • on: release: → must create a GitHub Release
    • on: push: tags: → pushing the tag is enough
    • neither → tag-only / optional Release
  • New partials _partials/release-node.md and _partials/release-wordpress.md with ecosystem-specific version source-of-truth, bump commands, and quality checks.
  • Registration — both partials added to PARTIALS; categorized release-nodereact, release-wordpresswordpress in FILE_CATEGORIES.partials; prompt renamed in PROMPTS.workflow and FILE_CATEGORIES.prompts.
  • Docs — README prompt + partial tables and CHANGELOG updated.

Type of Change

  • ✨ New feature
  • 💥 Breaking change (command renamed: prepare-releaseprepare-github-release)
  • 📝 Documentation

Testing

  • node --test → 44/44 pass
  • Export↔file sync verified: PROMPTS/PARTIALS match the filesystem; arrays alphabetically sorted; no stale prepare-release references except the CHANGELOG rename note.

Note on release ordering

This feature targets the next release (it's separate from the pending v2.5.0 bump in #26). Once #26 merges and 2.5.0 is published, this lands under a fresh [Unreleased].

🤖 Generated with Claude Code

Rename prepare-release → prepare-github-release and refactor it into an
ecosystem-agnostic orchestrator that detects the project type and analyzes
GitHub workflows to choose the correct post-merge action.

- Rename prompt (no backward-compat alias); aligns with the *-github-*
  convention since releases are GitHub-only (no Bitbucket equivalent)
- Orchestrator detects WordPress plugin vs Node/npm and loads the matching
  partial; analyzes .github/workflows to decide bare-tag vs GitHub Release
  (fixes the wrong 'push the tag and it publishes' guidance for on: release:)
- Add _partials/release-node.md and _partials/release-wordpress.md with the
  ecosystem-specific version source-of-truth, bump commands, and quality checks
- Register both partials in PARTIALS and categorize them under react/wordpress
  in FILE_CATEGORIES.partials; rename in PROMPTS.workflow and FILE_CATEGORIES
- Update README prompt/partial tables and CHANGELOG

Closes #27

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@miguelcolmenares miguelcolmenares merged commit 3c7c176 into main Jun 30, 2026
4 checks passed
@miguelcolmenares miguelcolmenares deleted the feature/27-prepare-github-release branch June 30, 2026 16:16
@miguelcolmenares miguelcolmenares mentioned this pull request Jun 30, 2026
miguelcolmenares added a commit that referenced this pull request Jun 30, 2026
Bundles caching + SEO instructions and the nextjs-caching skill (#25), the project-agnostic prepare-github-release refactor (#28, closes #27), the version-sync guardrail and documented release flow, and the 2.5.0 version bump.
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.

feat: Make prepare-release project-agnostic & GitHub-Release-aware (rename to prepare-github-release)

1 participant