Version Migration Guide
by samber98ed86da8babMIT2 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 10 days ago
Writes or audits the migration guide for a breaking change - what breaks, ordered by blast radius, with a detection signal and before/after code per entry, a deprecation timeline, the codemod's coverage boundary, and verification by a cold upgrade of a real project. Use whenever someone mentions a migration guide, an upgrade guide, a breaking-changes page, a major version bump, "how do we tell users about v3", an API version cutover, a deprecation or sunset notice, or a codemod or compat build - even if they only say they are shipping v2. Covers libraries, SDKs, CLIs, frameworks, hosted APIs and schema runbooks. Not release notes - use samber/developer-relations-skills@changelog-writing.
Add to a SourceWeft workspace
- Open the skill in your dashboard and add it to a workspace.
- Enable it for the chats that should use it.
This skill is instructions only: it ships no scripts to execute.
Add to SourceWeftYou will be asked to sign in first, then taken straight to this skill.
Ask your agent to install it
Paste this prompt into Claude Code, Codex, Cursor or another agent that can run commands — or into SourceWeft chat. The agent reads this skill's install guide, shows you its source, license and scripts, and installs it with the SourceWeft CLI once you agree.
Read https://sourceweft.com/skills/gh-samber-developer-relations-skills-version-migration-guide/install.md and install the skill it describes. Before installing, show me its source, license and whether it ships scripts, and wait for my OK. Ask me before changing anything else on my machine.Install it yourself from a terminal
For Claude Code, Codex, Cursor and other local agents. The SourceWeft CLI fetches the skill from its source repository at the commit scanned here, and verifies every file against the hashes recorded when the skill was scanned. If anything differs, nothing is written.
npx @sourceweft/cli skills install gh-samber-developer-relations-skills-version-migration-guideAdd --agent claude-code, codex, cursor or universal to choose which agent gets it (Claude Code by default).
Upstream installer — not verified by SourceWeft
The open-source skills installer fetches the same pinned commit, but does not check the files against the hashes SourceWeft recorded.
npx skills add https://github.com/samber/developer-relations-skills/tree/98ed86da8bab1572417d03d294f0ce8cd00d0d74/skills/version-migration-guideSource and attribution
Source:samber/developer-relations-skillsinskills/version-migration-guideat commit98ed86d
License: MIT
Content belongs to its original authors. SourceWeft indexes it from a public repository.
More from samber/developer-relations-skills
Technical Video Script
samber
Writes or reviews shooting-ready scripts for technical videos, screencasts and animated explainers.
Tech Talk Outline
samber
Turns an accepted conference talk abstract into a rehearsable outline with an arrow, arc, time budget, demo placement and slide skeleton.
Tech Press Relations
samber
Guides press and analyst relations for developer-facing products, from news qualification to pitching, embargoes and press assets.
Tech Podcast Interview Prep
samber
Prepares a guest for a technical podcast, video interview, livestream or panel, producing a markdown prep brief and promotion plan.
Tech Employer Branding
samber
Builds an engineering employer-brand strategy: EVP, verification-surface audit, channel bets and measurement baseline.
Oss Sponsors Fundraising
samber
Designs a maintainer-side open-source sponsorship program: tier ladder, pricing, rewards, funding goals and corporate payment path.
More in Writing & Content
Doc Coauthoring
anthropics
Guides users through a three-stage workflow to co-author documentation, proposals, specs and decision docs.
Writing Guidelines
vercel-labs
Reviews documentation and prose against fetched Writing Guidelines and reports style findings.
Job Post Builder
anthropics
Builds a hiring packet — job post, interview guide with rubrics, and offer letter template — from a role brief.
Write Spec
anthropics
Turns a feature idea or problem statement into a structured PRD with goals, user stories, requirements and metrics.
Draft Content
anthropics
Drafts marketing content such as blog posts, social posts, newsletters, landing pages, press releases and case studies.
Brand Voice Enforcement
anthropics
Applies existing brand voice guidelines to sales and marketing content, then explains the brand choices made.