Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

plan-upgrade

/plan-upgrade

Planuje aktualizację głównej wersji frameworka, np. Rails, Laravel, Django czy Next.js, wskazując zmiany łamiące zgodność i wycofane API.

Licencja
MIT
Ostatnia zmiana repozytorium
05.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Planuje aktualizację głównej wersji frameworka, np. Rails, Laravel, Django czy Next.js, wskazując zmiany łamiące zgodność i wycofane API.

Wyzwalacze z opisu

upgrade RailsRails 7 to 8bundle update railsload_defaultsupgrade LaravelLaravel 11composer update laravel/frameworkupgrade Django
Oryginalny opis (EN)

This skill should be used when the user wants to upgrade a major framework version, for example "upgrade Rails", "Rails 7 to 8", "bundle update rails", "load_defaults", "upgrade Laravel", "Laravel 11", "composer update laravel/framework", "upgrade Django", "Django 5.2", "upgrade Next.js", "Next.js 15", "next codemod", "upgrade NestJS", "NestJS 11", "LTS upgrade", "breaking changes", "removed APIs", or "deprecation warnings before upgrading". Plans the upgrade one hop at a time for Rails 6.1 to 8.1, Laravel 10 to 13, Django 4.2 to 6.0, Next.js 13 to 16 and NestJS 9 to 12, with a test-gated chec

Jak działa

  1. Principles
  2. Workflow
  3. References
  4. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 39 linii, 620 słów
Podgląd SKILL.md
---
name: plan-upgrade
description: This skill should be used when the user wants to upgrade a major framework version, for example "upgrade Rails", "Rails 7 to 8", "bundle update rails", "load_defaults", "upgrade Laravel", "Laravel 11", "composer update laravel/framework", "upgrade Django", "Django 5.2", "upgrade Next.js", "Next.js 15", "next codemod", "upgrade NestJS", "NestJS 11", "LTS upgrade", "breaking changes", "removed APIs", or "deprecation warnings before upgrading". Plans the upgrade one hop at a time for Rails 6.1 to 8.1, Laravel 10 to 13, Django 4.2 to 6.0, Next.js 13 to 16 and NestJS 9 to 12, with a test-gated checklist per hop.
version: 1.1.0
---

# Plan a Framework Upgrade

Major upgrades fail when they skip versions, mix a framework bump with feature work, or start without a green suite. Plan them as a chain of small hops, each ending in passing tests and a deploy.

## Principles

1. **One hop at a time.** Rails minor to minor (6.1 -> 7.0 -> 7.1), Laravel, Next.js and NestJS major to major, Django feature release to feature release (LTS to LTS included). Each hop is its own branch or MR.
2. **Tests first.** The suite must pass on the latest patch of the current version before the first hop. If coverage is thin, add characterization tests for the risky areas first.
3. **Deprecations before versions.** Fix the warnings on the current version, then bump. Warnings from inside third-party gems or packages are not always a problem.
4. **Language runtime first.** If the next hop needs a newer Ruby, PHP, Python or Node.js, raise it as a separate step before the framework bump.
5. **Dependencies next.** Check that every gem, composer package, pip package or npm package that touches the framework supports the target. Replace or upgrade the ones that do not before the hop.
6. **No feature work in a hop.** Keep the diff to what the upgrade requires.

## Workflow

1. **Detect** the framework, current version, language version and target (see "Detecting versions" in the reference). `scripts/upgrade_path.py` reads a lock file (including `package-lock.json`, `pnpm-lock.yaml` and `yarn.lock` for Next.js and NestJS) and prints the hop list with language minimums.
2. **List the hops** from current to target. Ask for the target if it is missing; default to the newest supported version and say so.
3. **For each hop**, read the matching `## Hop` section in the reference and turn it into a checklist ordered from high impact to low: language minimum, dependency changes, config and defaults, removed APIs, behaviour changes.
4. **Find the code affected.** Use Grep for each removed or changed API named in the hop and list file:line hits. Do not claim a hit you did not see.
5. **Gate each hop** on: the suite passing, no new deprecation warnings left unexplained, a staging check, then deploy before starting the next hop.
6. **Report risk** the references flag as data-affecting (session or cookie invalidation, cache format changes, digest or hash changes, serialized data) and how to roll out around it.

## References

- `references/rails.md`: Rails 6.1 to 8.1, Ruby minimums, `app:update`, `load_defaults` and `new_framework_defaults` workflow
- `references/laravel.md`: Laravel 10 to 13, PHP support, per-hop impact lists, skeleton comparison
- `references/django.md`: Django 4.2 LTS to 6.0, Python support, deprecation warnings workflow, per-hop removals
- `references/nextjs.md`: Next.js 13 to 16, Node.js minimums, `@next/codemod` names per hop, async request APIs, Turbopack and caching changes
- `references/nestjs.md`: NestJS 9 to 12, Node.js minimums, Express 5 and Fastify 5 changes, per-hop package migrations

## Rules

- Never read credentials. Do not open `.env`, `config/database.yml`, `config/database.php`, `settings.py` `DATABASES`, npm and yarn configuration files, credential files or anything holding tokens or database URLs. Detect versions from lock and dependency files only.
- Never run the upgrade yourself. Produce the plan, the commands and the file:line hits; the user runs them.
- Facts in the references come from the official guides and carry a check date. Anything marked "verify" must be confirmed against the official guide for the user's exact patch version before it is stated as fact.
- If the current or target version is outside the covered range, say so and point to the official upgrade guide instead of guessing.
- Plan hops in order. Do not merge two hops into one checklist even when the user asks for a jump; explain that the intermediate deprecation warnings are the safety net.
Pliki w paczce (6)
  • SKILL.md 4 KB
  • references/django.md 12 KB
  • references/laravel.md 10 KB
  • references/nestjs.md 8 KB
  • references/nextjs.md 11 KB
  • references/rails.md 14 KB

Wersje

W bazie nie ma innych skilli o nazwie plan-upgrade.

Migawka bazy z 13.11.2026 · wersja paczki 6093693d3786 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100laravel-upgrade-v13
    Prowadzi przez aktualizację aplikacji Laravel 12 do Laravel 13.0: podniesienie wersji w Composerze, zmiany łamiące zgodność i migrację do Attributes.
  • 100dependency-upgrade
    Aktualizuje zależność, framework lub środowisko do nowej wersji, zwłaszcza głównej, z obsługą zmian łamiących kompatybilność oraz przestarzałych funkcji.
  • 100rails-upgrade
    Analizuje aplikację Rails i pisze raport aktualizacji ze zmianami łamiącymi, deprecjacjami i krokami migracji od wersji 2.3 do 8.1.
  • 100laravel-upgrade
    Planuje bezpieczne aktualizacje Laravela od wersji 5.0 do 5.8 aż po 13, najpierw audytując aplikację.
  • 100migration
    Porządkuje aktualizację wersji frameworka, migrację API i podbicie głównych zależności, porównując stan przed i po zmianie oraz wskazując zmiany łamiące zgodność.
  • 95migrate-ops
    Prowadzi migracje frameworków i języków: podnoszenie wersji, zmiany łamiące zgodność, audyt zależności, codemody i bezpieczny rollback, między innymi dla React 19, Next.js, Laravel i Pythona.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.