Template — Path aliases
Imports relativos (`../../../lib/auth`) son el primer olor a proyecto que se volvió difícil de mover. Los path aliases (`$components`, `$lib`, `$stores`) resuelven esto de entrada. El agente los usa naturalmente y el refactor de archivos deja de romper imports.
Alias absolutos > imports relativos — siempre, desde el minuto 0.
Los aliases del template
`js
// svelte.config.js
alias: {
$components: './src/components',
$lib: './src/lib',
$stores: './src/lib/stores',
$utils: './src/lib/utils'
}
`
Uso: import Button from '$components/Button.svelte' desde cualquier archivo.
Qué ganas
- Refactor safe: mover un archivo no rompe imports si alias resuelve.
- Legibilidad:
$components/Buttondice "es un componente",../../../no dice nada. - Agente-friendly: el agente busca por alias, no se pierde en estructuras profundas.
La disciplina
Si ves en un PR import x from '../../../lib/foo', es bandera. Casi siempre se puede reemplazar por alias. Tu skill del agente debe incluir: "preferir alias sobre relative imports".
Cuenta en tu proyecto los imports relativos con `../../`. Si son > 10, es señal de que alias no está configurado o no se usa.
- Alias: `$components`, `$lib`, `$stores`, `$utils`.
- Refactor de carpetas no rompe imports con alias.
- Skill del agente debe preferir alias sobre relative imports.