Notre avis

Migre un module entier vers l'architecture cible en suivant six phases avec des étapes d'approbation.

Processus structuré en phases avec validation intermédiaire
Couverture complète de la migration : analyse, structure, types, services, état et composants
Intègre des vérifications automatiques (build, svelte-check, tests) après chaque phase

Quand l'utiliser

Utilisez cette compétence lorsque vous devez migrer un module existant vers une nouvelle architecture Svelte/SvelteKit.

Quand l'éviter

Ne l'utilisez pas pour des modifications ponctuelles ou des modules ne nécessitant pas une migration complète.

name: migration-migrate-module description: "Use when a complete module needs migration to the target architecture — runs 6 phases with approval gates." user-invocable: true argument-hint: "[module-path]" allowed-tools: Read, Write, Edit, Bash, Glob, Grep

Migrate an entire module to the target architecture from docs/ARCHITECTURE.md.

Module/Path: $ARGUMENTS

Steps

Use @migrator to coordinate the full migration in phases:

Phase 0 -- Analysis: Map the module (files, Svelte 4 vs 5 patterns, JS vs TS, SvelteKit 1 vs 2 patterns, dependencies)
Phase 1 -- Structure: Create src/lib/modules/[name]/ and route files, move existing files
Phase 2 -- Types: Create .types.ts + .contracts.ts + adapter
Phase 3 -- Services: Migrate to pure service (no try/catch, native fetch)
Phase 4 -- State: Server state -> SvelteKit load functions, Client state -> Svelte stores
Phase 5 -- Components: Svelte 4 -> 5 runes + composition (see conversion table)
Phase 6 -- Review: Validate conformance, check for remaining legacy patterns

Validate build/svelte-check/tests after each phase. Ask for approval before each phase.