Agent-Skills.md

Agent Skills: Upgrade Plain Packages

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

UncategorizedID: dropseed/plain/plain-upgrade

Repository

dropseed/plain
dropseed
80318

Install this agent skill to your local

pnpm dlx add-skill https://github.com/dropseed/plain/tree/HEAD/.claude/skills/plain-upgrade

Skill Files

Browse the full folder contents for plain-upgrade.

Download Skill

Loading file tree…

.claude/skills/plain-upgrade/SKILL.md

Skill Metadata

Name
plain-upgrade
Description
Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions.

Upgrade Plain Packages

1. Run the upgrade

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

This will show which packages were upgraded (e.g., plain-postgres: 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. Update agent rules and skills

Run uv run plain agent install to sync any updated rules and skills from the upgraded packages.

4. Validate

  1. Run uv run plain fix to fix formatting
  2. Run uv run plain check to validate (linting, preflight, migrations, tests)

Guidelines

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