Spirit v5 Migration

Use this skill when migrating a consumer application to Spirit Design System v5. The primary target is @alma-oss/spirit-web-react. Always inspect application markup, styles, and token overrides too: React consumers can still carry obsolete CSS feature flags or renamed design tokens without importing Spirit SCSS directly.

Canonical migration recipes live in changesets/. Each file represents one breaking-change topic. Follow documented migration paths from those files first. The agent performs all migrations — codemods and recipe edits alike. Do not leave work for the user unless you hit a hard blocker you cannot resolve (missing source files, unrecoverable ambiguity after inspection). When uncertain, attempt the migration anyway and mark the result partial with review locations in the report.

Principles