bg-szy/TOP-SKILLS / skills/agent-skills/breaking-changes-management
breaking-changes-management
VerifiedManage breaking API changes, migration guides, deprecation notices, and semver versioning. Use when introducing breaking changes, writing migration paths, updating changelogs, or releasing major versions.
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 6.2 KB |
| LICENSE.txt | markdown | 1.1 KB |
| SKILL.md | skill md | 4.7 KB |
CHANGELOG.md
View on GitHub# Changelog
## [2026-09-08] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-09-08 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-09-05] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-09-05 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-31] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-31 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-29] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-29 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-24] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-24 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-08-14] - Catalog Freshness And Source Sync
### Added
- Refreshed the catalog metadata and retained-client portability baseline.
### Changed
- Updated the catalog metadata and last-updated state for the 2026-08-14 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Preserved explicit no-MCP fallbacks and the catalog's safety, approval, and source-boundary guidance.
## [2026-07-29] - Version 2.0 Client Support Reset
### Added
- Added the current GitHub Copilot, Claude Code, and Codex portability baseline.
### Changed
- **BREAKING:** Removed Gemini CLI and Antigravity as supported clients.
- Refreshed catalog metadata and last-updated state for the 2026-07-29 maintenance pass.
- Kept the retained-client portability, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
### Fixed
- Prevented catalog modernization from reintroducing removed Gemini or Antigravity guidance.
## [2026-07-11] - Catalog Maintenance Refresh
### Added
- Added the current catalog verification baseline where it was missing.
### Changed
- Refreshed catalog metadata and last-updated state for the 2026-07-11 maintenance pass.
- Kept the cross-client, MCP fallback, Anti-Patterns, Verification Protocol, and Related Skills sections aligned.
- Reclassified historical `Tested` or `Verified` changelog headings under the allowed changelog vocabulary without dropping their evidence.
### Fixed
- Closed validator and documentation drift so the enforced schema matches the documented skill baseline.
## [2026-04-25] - Version 1.2 Verification Protocol Refresh
### Added
- Added a `Verification Protocol` section with skill-specific pass/fail checks, one pressure-test scenario, and a measurable success metric.
- Added guidance to leverage native parallel subagent dispatch and 200k+ context windows where available.
### Changed
- Updated `SKILL.md` frontmatter to `version: "1.2"` and `last_updated: 2026-04-25`.
- Reframed activation guidance toward symptom -> action triggers and standardized two-stage review wording where applicable.
## [2026-04-24] - Version 1.1 Refresh
### Changed
- Updated the SKILL frontmatter version to `1.1` for the 2026-04-24 catalog refresh.
All notable changes to this skill will be documented in this file.
## [2026-04-24] - Skill Refresh
### Changed
- Standardized the SKILL frontmatter with version metadata, last-updated date, tags, and a concise catalog description.
- Reformatted the portability and MCP guidance with a preferred server line, a copy-paste fallback prompt, and consistent bullet lists.
- Added a catalog-standard Anti-Patterns section and refreshed the Related Skills links at the end of the skill.
## [2026-04-04] - Cross-Client Portability Refresh
### Changed
- Added a standard portability note covering GitHub Copilot, Claude Code, Codex, and Gemini CLI.
- Clarified that the core workflow does not require a dedicated MCP server and can run with local tools alone.
### Changed
- Validated `SKILL.md` frontmatter, portability sections, and Gemini export readiness with `python scripts/validate-skills.py`.
## [2026-03-09] - Workspace Modernization
### Changed
- Rewrote the skill into a tighter breaking-change workflow focused on migration impact, replacement paths, and release notes
### Added
- `scripts/migration-guide-scaffold.py` to generate migration-guide templates for breaking releases
## [2026-02-28] — Description Rewrite & Cross-References
### Changed
- Rewrote skill description to ~200 characters with clear, specific activation keywords
- Improved keyword specificity to reduce overlap with related skills
### Added
- `## Related Skills` cross-reference table with 2-4 related skills and "Use When" guidance
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |