Migration

The specification is versioned, and PO9 keeps a compatibility promise: a skin built for one spec version keeps working. When you’re ready to adopt newer features, migrate.

Check what changed

po9 migrate ./my-skin --to v1.1 --dry-run

A dry run reports what would change without touching your files.

Migrate

po9 migrate ./my-skin --to v1.1
po9 validate ./my-skin

The migrator rewrites the manifest spec version and applies any mechanical token/structure changes. Always re-run the Validator afterward.

Policy

• Backward-compatible changes (new optional tokens) never require migration.
• Breaking changes only land on a major spec bump and always ship a migrator. See Versioning and the Roadmap.