Migrate Sass Modules

Contract and operating modes

Read .ai-shared/bundles/umbrella/frontend/contract.md and the optional repository umbrella-frontend.json. Apply only this skill's scope. Analyze reports without changing application files; Apply implements requested setup/repairs; Verify checks the result. An explicit setup/fix request authorizes Apply after inspecting existing changes; do not add a second approval step. Upgrades and source migrations are separate unless requested.

Report selected projects/profile, findings and exceptions, changed files, actual checks and unresolved validation. Missing tools/credentials mean incomplete verification, not success. Use the report vocabulary from the contract.

Workflow

1. Inventory global/scoped entry graphs and separate canonical application sources, generated copies and third-party code. Capture CSS/visual baselines and warnings. Read migration guidance matching installed Sass/framework versions.
2. Migrate original helpers, not copies or node_modules. Use sass: modules for built-ins and explicit application namespaces/forwarded APIs. @use loads once per compilation, not once across all separate component compilations; CSS-emitting helpers can still duplicate output.
3. Preserve variable override timing and framework order. Bootstrap legacy chains may need a compatibility boundary; mechanical import-to-use replacement can change visibility/configuration. Do not force vendor module support or unrequested upgrades.
4. If using Sass migrator, inspect installed help/version and dry-run in an isolated source copy with correct load paths. Review its write set; dependency traversal must not rewrite licensed/vendor or unrelated sources.
5. Migrate coherent helper groups and all consumers, refresh generated copies, then compare output. Handle nested imports/side-effect CSS separately using supported loading patterns without accidentally changing selector nesting.

Verify

Compile every affected entry, compare normalized CSS and check order, theme values, URLs, icons and .NET ::deep. Use existing visual tests and review differences. Separate residual vendor warnings from application problems; suppression is not migration. Report deliberate compatibility boundaries.

Reference: https://sass-lang.com/documentation/breaking-changes/import/

.NET analyzer compatibility

If the requested work includes C# or Razor changes, read .ai-shared\bundles\umbrella\analyzer-compatibility.md and verify affected projects with their installed analyzers. For read-only audits, use it only as review guidance. Pure NPM/JavaScript/SCSS edits do not require unrelated .NET source changes.