OpenParable
Skip to content
← Back to skills

React On Rails Update Changelog

Development
react-on-rails-update-changelog

React On Rails Update Changelog is an Agent Skill for development published in the shakacode/react_on_rails repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

React on Rails release-train changelog updates, including target=release and release/X.Y.Z PR targeting while the portable update-changelog skill remains mainline-only.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/shakacode/react_on_rails/blob/HEAD/.agents/skills/react-on-rails-update-changelog/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/react-on-rails-update-changelog, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

React on Rails Update Changelog

Use this repo-local skill only when React on Rails release-train targeting matters:

  • the user passes target=release or target=release/X.Y.Z
  • the current branch is release/X.Y.Z
  • an RC/final promotion workflow needs the changelog PR to target release/X.Y.Z
  • the user asks for React on Rails release-train changelog handling

For ordinary mainline changelog entries on main, use the installed/shared $update-changelog skill. This repo-local skill exists under a distinct name so Codex does not show a duplicate update-changelog picker entry.

Required Context

Before editing, read:

  1. AGENTS.md changelog and release-train sections.
  2. internal/contributor-info/release-train-runbook.md when the target is a release/* branch.
  3. .agents/agent-workflow.yml for base_branch, changelog, and changelog policy values.

Resolve the shared helper directory explicitly; do not assume this checkout has a repo-local shared skill copy:

UPDATE_CHANGELOG_SKILL_DIR="${UPDATE_CHANGELOG_SKILL_DIR:-$(.agents/bin/shared-skill-dir update-changelog)}"

Use that helper for mechanical classification sweeps:

BASE_REF="${BASE_REF:?set BASE_REF, e.g. v17.0.0.rc.2}"
TARGET_REF="${TARGET_REF:?set TARGET_REF, e.g. origin/main or origin/release/17.0.0}"
"${UPDATE_CHANGELOG_SKILL_DIR}/bin/changelog-merged-prs" "${BASE_REF}..${TARGET_REF}"

Target Resolution

Resolve the target before writing, stamping, branching, or creating a PR:

  • target=main: use the installed/shared $update-changelog flow against the configured base branch.
  • target=release/X.Y.Z: verify origin/release/X.Y.Z exists and target that branch.
  • target=release: use the current release/X.Y.Z branch when already on one; otherwise list origin/release/*. If exactly one active release branch exists, target it. If more than one exists, ask which branch to use.
  • No target= while on release/X.Y.Z: target the current release branch.
  • No target= while on main and exactly one active origin/release/* branch exists: ask whether this changelog update should target release/X.Y.Z or main. Default to main only when the user does not choose a release target.
  • No active release branch: default to main.

If a requested release target does not exist on origin, stop and report:

target=release requested but no matching origin/release/X.Y.Z branch exists.
Start the release line first, or use target=main.

Release-Branch Procedure

For a resolved release/X.Y.Z target:

  1. Fetch current release state:

    git fetch --prune origin main '+refs/heads/release/*:refs/remotes/origin/release/*'
    
  2. Require a clean worktree before changing branches or writing changelog entries.

  3. Create a feature branch from the release branch tip, not from main:

    git switch -c "changelog-<version-or-mode>" "origin/release/X.Y.Z"
    
  4. Add or curate entries in CHANGELOG.md under ### [Unreleased], using the classification taxonomy and entry format from AGENTS.md.

  5. Run the repo's version-stamping task when requested:

    bundle exec rake "update_changelog[rc]"
    bundle exec rake "update_changelog[release]"
    bundle exec rake "update_changelog[beta]"
    bundle exec rake "update_changelog[17.0.0.rc.1]"
    
  6. Keep compare-link anchoring consistent with the repo task. Release-target entries intentionally keep the [unreleased] comparison anchored to main because release-branch entries are forward-ported to main.

  7. Commit only the changelog files, push the feature branch, and open the PR against the release branch:

    git add CHANGELOG.md
    git commit -m "Update changelog for <version-or-mode>"
    git push -u origin "$(git branch --show-current)"
    gh pr create --draft --base "release/X.Y.Z" --head "$(git branch --show-current)"
    
  8. After the PR merges into release/X.Y.Z, follow the release-train runbook to forward-port the changelog result to main when required.

Do not recreate .agents/skills/update-changelog/SKILL.md in this repo unless a maintainer explicitly chooses to restore a same-name local override and accepts the duplicate skill picker entry. Keep same-name shared workflow skills in the installed shared pack.