hex-upgrade-migration
Analyze, plan, and execute Hex SDK upgrades with breaking change detection. Use when upgrading Hex SDK versions, detecting deprecations, or migrating to new API versions. Trigger with phrases like "upgrade hex", "hex migration", "hex breaking changes", "update hex SDK", "analyze hex version".
Allowed Tools
Provided by Plugin
hex-pack
Claude Code skill pack for Hex (18 skills)
Installation
This skill is included in the hex-pack plugin:
/plugin install hex-pack@claude-code-plugins-plusClick to copy
Instructions
Hex Upgrade & Migration
Overview
Hex API is versioned at /api/v1/. Monitor the Hex changelog for new endpoints and deprecations.
Instructions
Check API Usage
grep -r "app.hex.tech" src/ --include="*.ts" --include="*.py"
Airflow Provider Updates
pip install --upgrade airflow-provider-hex
Prerequisites
- Pinned current and target versions, a compatibility assessment, sandbox project fixtures, and an owner for each changed contract.
- Versioned configuration backups plus approved downgrade, cancellation, and integration-disable procedures.
Output
Produce an upgrade receipt with from/to versions, affected contracts, fixture/canary outcomes, aggregate assertions, owner approval, compatibility decision, and rollback revision. Exclude SQL, workspace output, and credentials.
Error Handling
Stop for incompatible parameter/output contracts, authorization drift, unbounded replays, or a failed canary assertion. Restore the exact pinned prior revision and retain redacted evidence rather than forcing migration.
Examples
from=client-r12; to=client-r13; sandbox=pass; staging=pass; assertions=pass; canary=held; rollback=r12 is a defensible upgrade record.