# Plain Upgrade

> Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions.

- Skill: `majiayu000/plain-upgrade` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/plain-upgrade`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/plain-upgrade/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/plain-upgrade

---


# Upgrade Plain Packages

## 1. Run the upgrade

```
uv run plain upgrade [package-names...]
```

This will show which packages were upgraded (e.g., `plain-models: 0.1.0 -> 0.2.0`).

## 2. Apply code changes for each upgraded package

For each package that was upgraded:

1. Run `uv run plain changelog <package> --from <old-version> --to <new-version>`
2. Read the "Upgrade instructions" section
3. If it says "No changes required", skip to next package
4. Apply any required code changes

## 3. Validate

1. Run `uv run plain fix` to fix formatting
2. Run `uv run plain preflight` to validate configuration

## Guidelines

- Process ALL packages before testing
- DO NOT commit any changes
- Keep code changes minimal and focused
- Report any issues or conflicts encountered