Version Migration Guide

samber/developer-relations-skills/skills/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.

Only the file list is public. File contents are available once the skill is installed in a workspace.

PathSizeType
evals/evals.json43 KBapplication/json
references/api-version-migration.md4 KBtext/markdown
references/automated-migration-tooling.md6.7 KBtext/markdown
references/breaking-change-entry-template.md3.1 KBtext/markdown
references/deprecation-timeline-patterns.md3.7 KBtext/markdown
references/guide-outline-examples.md4.9 KBtext/markdown
references/guide-types-beyond-libraries.md5.3 KBtext/markdown
references/sources.md6.1 KBtext/markdown
references/validation-and-adoption-metrics.md6.2 KBtext/markdown
SKILL.md28.8 KBtext/markdown

Source 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.

Report or request removal