dependency-upgrade

version	4.1.0-fractal
name	dependency-upgrade
description	Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major dependencies, or managing breaking changes in libraries.

Dependency Upgrade

Master major dependency version upgrades, compatibility analysis, staged upgrade strategies, and comprehensive testing approaches.

Do not use this skill when

• The task is unrelated to dependency upgrade
• You need a different domain or tool outside this scope

Instructions

• Clarify goals, constraints, and required inputs.
• Apply relevant best practices and validate outcomes.
• Provide actionable steps and verification.
• If detailed examples are required, open resources/implementation-playbook.md.

Use this skill when

• Upgrading major framework versions
• Updating security-vulnerable dependencies
• Modernizing legacy dependencies
• Resolving dependency conflicts
• Planning incremental upgrade paths
• Testing compatibility matrices
• Automating dependency updates

Semantic Versioning Review

MAJOR.MINOR.PATCH (e.g., 2.3.1)

MAJOR: Breaking changes
MINOR: New features, backward compatible
PATCH: Bug fixes, backward compatible

^2.3.1 = >=2.3.1 <3.0.0 (minor updates)
~2.3.1 = >=2.3.1 <2.4.0 (patch updates)
2.3.1 = exact version

Dependency Analysis

🧠 Knowledge Modules (Fractal Skills)

1. Audit Dependencies

2. Analyze Dependency Tree

3. Phase 1: Planning

4. Phase 2: Incremental Updates

5. Phase 3: Validation

6. Identifying Breaking Changes

7. Codemod for Automated Fixes

8. Custom Migration Script

9. Unit Tests

10. Integration Tests

11. Visual Regression Tests

12. E2E Tests

13. Renovate Configuration

14. Dependabot Configuration

15. Lock File Management

16. Peer Dependency Resolution

17. Workspace Upgrades