Workflow Refactoring

Upgrade a Dependency

Safe workflow for upgrading a project dependency

refactoringdependenciesupgrade
CLAUDE.md

When upgrading a dependency:

  1. Read the changelog and migration guide between your current version and the target version.
  2. Check for breaking changes. Note any API changes, removed features, or renamed exports.
  3. Update the version in your package manifest.
  4. Run the build. Fix any compilation or type errors introduced by the upgrade.
  5. Run the full test suite. Fix any failing tests.
  6. If the upgrade has breaking changes, update your code to use the new APIs.
  7. Test the affected features manually to catch runtime issues that tests might miss.
  8. Commit the upgrade separately from other changes so it can be reverted cleanly if issues arise.

Copy this workflow into your CLAUDE.md or agent config file so your agent follows this process automatically.

get crystl