Uppgradera beroenden med tester som skyddsnät
Steg-för-steg-uppdrag för att lyfta beroenden ett i taget, köra tester efter varje steg och lämna en pull request som går att granska.
- Typ
- Playbook
- Område
- Kod
- Verktyg
- Claude Code, Codex, Cursor, Copilot
- Uppdaterad
- 8 september 2026
.claude/commands/uppgradera.md
Uppgradera projektets beroenden på ett kontrollerat sätt.
## Förberedelser
1. Kontrollera att arbetsträdet är rent och att testerna går igenom på
nuvarande version. Om testerna inte går igenom: stanna och rapportera.
Ingen uppgradering börjar från ett rött läge.
2. Skapa en gren `chore/upgrade-YYYY-MM-DD`.
3. Lista föråldrade beroenden med projektets pakethanterare (`npm
outdated`, `pip list --outdated`, `go list -m -u all` eller
motsvarande). Dela upp i tre grupper: patch, minor, major.
## Uppgradera i ordning
Gör grupperna i ordning: patch, sedan minor, sedan major. Inom major:
ett paket i taget.
För varje steg:
1. Uppgradera.
2. Kör typkontroll, lint och hela testsviten.
3. Om grönt: commit med meddelandet "Upgrade <paket> <från> -> <till>".
4. Om rött: läs felet och paketets changelog eller migrationsguide för
versionsintervallet. Gör den minsta kodändring som krävs. Kör om.
Commit som "Upgrade <paket> <från> -> <till>, adapt <vad>".
5. Om du efter två försök inte får grönt: backa uppgraderingen av det
paketet, notera det i en lista över "Kunde inte uppgradera" med
felmeddelande, och gå vidare.
## Avslutning
1. Kör hela sviten en sista gång. Bygg produktionsbygget.
2. Kör en sårbarhetsskanning (`npm audit`, `pip-audit` eller motsvarande)
och rapportera vad som återstår.
3. Öppna en pull request med rubriken "Upgrade dependencies YYYY-MM-DD".
Beskrivningen ska innehålla: tabell över uppgraderade paket med
versioner, lista över kodändringar som krävdes och varför, lista över
paket som inte kunde uppgraderas med orsak, och vad som bör testas
manuellt.
## Regler
- Ändra aldrig tester för att få dem gröna. Om ett test måste ändras på
grund av ett förändrat beteende i beroendet, förklara i commit-
meddelandet.
- Ta inte bort beroenden, byt inte ut ett bibliotek mot ett annat.
- Lås versioner exakt i lockfilen. Rör inte versionsintervall i
manifestfilen om projektet inte redan gör det.
- Om något kräver en ny major av runtime (Node, Python, Go): stanna och
fråga.
När den gör nytta
- Kvartalsvis städning av package.json, requirements.txt eller go.mod.
- När ett säkerhetsvarning kräver en uppgradering som drar med sig fler.
- När ni ligger tre major-versioner efter och ingen vågar börja.
Så installerar du
- Direkt
- Klistra in texten som uppgift i valfri agent. Anpassa sökvägar och verktygsnamn först.
- Claude Code
- Spara som .claude/commands/uppgradera.md så blir den ett snedstreckskommando. Återkommande uppgifter kan schemaläggas som rutiner.
- Codex
- Spara som en skill eller kör som uppgift. Codex kan schemalägga uppgifter i molnet.
Om playbooks
En uppgift i flera steg som agenten kör från början till slut. Klistra in, eller spara som kommando och schemalägg.
Närliggande
SKILL.mdSkill SKILL.mdSkill AGENTS.mdInstruktionsfil
Kodgranskning som hittar buggar, inte stilfel
Granskar en diff eller pull request med fokus på korrekthet, säkerhet och saker som går sönder i produktion. Stilfrågor lämnas till linters.
Säkerhetsgranskning av en webbfunktion
Går igenom en funktion eller ett API mot OWASP:s vanligaste sårbarheter plus de fel som agentbyggda appar ofta gör: läckta nycklar, saknade behörighetskontroller, promptinjektion.
AGENTS.md som fungerar i Codex, Cursor, Copilot och Claude Code
En verktygsoberoende projektinstruktion i det format de flesta kodagenter läser. Kort nog att faktiskt läsas, konkret nog att göra skillnad.