Upgrade dependencies without breaking the project: audit what is outdated and why it matters (security, EOL, features), read the changelogs and migration guides for each major, upgrade in ordered small batches with the test suite and typecheck run after each, apply codemods where they exist, handle lockfile and peer-dependency conflicts, and leave a record of what changed and what was deferred. Use when a security advisory lands, when a runtime or framework reaches end of life, when a…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
Upgrades fail when they are done all at once and diagnosed all at once. The discipline is: know what changed, change one thing, run the tests, commit, repeat. A day of small green steps beats a week of bisecting a red branch.
## Step 1: inventory
- `npm outdated` / `pnpm outdated` / `pip list --outdated` / `cargo outdated` / `go list -m -u all`, plus the audit: `npm audit`, `pip-audit`, `cargo audit`, `govulncheck`.
- For each candidate: current, latest, is it a major bump, does an advisory apply, is the current version EOL, does it block another upgrade (e.g. the test runner must move before the framework can).
- Classify: **security** (do first, minimal version that fixes), **blocking** (needed for another upgrade), **major** (needs reading), **minor/patch** (batchable).
Write the plan as a table before touching anything; get agreement if the list is long or a major touches the framework.
## Step 2: prepare
- Green baseline: full test suite, typecheck, lint, and build pass on the current commit; record timings.
- A branch per major upgrade; one branch for the minor/patch batch.
…
The line at the top of this page pins the label git:20260921.8d3f9eb, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_qqq3dajiou5trofd
GET https://markdownregistry.com/api/v1/resolve?ref=khaledsaeed18/dotclaude/dependency-upgrade
GET https://markdownregistry.com/api/v1/blob/55d204e71cee5bf8923040db575d05f4a6f6ded901f29c0e39b07d65bc9a07c4
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
khaledsaeed18/dotclaude · .agents/skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/coolify-image-app/SKILL.md · Create and configure a Coolify application that runs a prebuilt image from a registry. Use when adding an app to…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/coolify-vps-baseline/SKILL.md · Prepare a Linux VPS to run production containers under Coolify. Use when setting up a new server, auditing an existing…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/deploy-verification/SKILL.md · Prove a deployment from the server side. Use when a deploy finished and needs sign-off, when a rolling update may have…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/express-prisma-coolify-image/SKILL.md · Package an Express and Prisma API as a runtime-only image that migrates its Postgres database at start. Use when…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/ghcr-coolify-pipeline/SKILL.md · Write the single GitHub Actions workflow that takes a repository from pull request to production through GHCR and…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/live-domain-cutover/SKILL.md · Move a live domain from one host to another without downtime or lost sessions, with a rehearsal, a timed DNS switch, a…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/nextjs-coolify-image/SKILL.md · Package a Next.js app as a runtime-only container image with a health probe and a fast shutdown. Use when…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/proxy-client-address/SKILL.md · Forward the real client address from a server-side proxy to a backend without trusting forgeable headers. Use when an…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/vps-ops-toolkit/SKILL.md · Install host operations on a VPS, with a cron health check that alerts on change, restore-verified encrypted database…
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/adr-writing/SKILL.md · Write Architecture Decision Records that a future engineer can act on: a numbered, immutable record with the context…
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/openapi-spec/SKILL.md · Write, generate, or review an OpenAPI 3.1 specification for an HTTP API so that it is accurate to the implementation…
wshobson/agents · plugins/framework-migration/skills/dependency-upgrade/SKILL.md · Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use…
dicklesworthstone/pi_agent_rust · tests/ext_conformance/artifacts/agents-wshobson/framework-migration/skills/dependency-upgrade/SKILL.md · Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use…
secondsky/claude-skills · plugins/dependency-upgrade/skills/dependency-upgrade/SKILL.md · Secure dependency upgrades with supply chain protection, cooldowns, and staged rollout. Use when upgrading deps…
hermeticormus/libreuiux-claude-code · plugins/framework-migration/skills/dependency-upgrade/SKILL.md · Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use…
hermeticormus/claude-code-game-development · plugins/framework-migration/skills/dependency-upgrade/SKILL.md · Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use…
rudycity/superagent · .agents/skills/dependency-upgrade/SKILL.md · Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use…
byerlikaya/claude-starter-kit · kit/skills/dependency-upgrade/SKILL.md · Bring dependencies current without breaking the build: find what is vulnerable, deprecated or behind,
classify each…
byerlikaya/claude-starter-kit · plugin/skills/dependency-upgrade/SKILL.md · Bring dependencies current without breaking the build: find what is vulnerable, deprecated or behind,
classify each…