cargdev/endorsment/alias-guardian

Alias Guardian

When to use this skill

• Run after adding tsconfig path aliases or when many long relative imports exist.
• Triggered by prompts to convert ../../.. style imports to @/ aliases.

Instructions

1. First Step: Ensure tsconfig.json has paths configured ("@/*": ["src/*"]) and vite.config.ts supports the aliases (via vite-tsconfig-paths or manual resolve.alias).

1. Second Step: Use an AST-based tool (e.g., jscodeshift, ts-morph) or a controlled regex to find and replace relative import paths. Prefer AST to avoid accidental matches.

1. Third Step: Update affected files' imports to the alias form and run TypeScript to verify no resolution errors.

Examples

• Before: import PaperCard from '../../components/molecules/PaperCard'
• After: import PaperCard from '@/components/molecules/PaperCard'

Additional Resources

• ts-morph: https://github.com/dsherret/ts-morph
• jscodeshift: https://github.com/facebook/jscodeshift

Notes

• Always run tests and TypeScript type-check after mass refactors; commit in a dedicated branch and use Git to move files safely.