migrar-modulo

What problem does it solve?

This Skill prevents broken module migrations in the oimpresso.com Laravel modular architecture by guiding safe moves and renames while avoiding accidental changes to URLs, permissions, pages, and database-backed identifiers.

Core Features & Use Cases

• Controlled move/rename operations: Use it to execute git mv for module folders or individual controllers (including controller moves inside Modules/<X>/Http/Controllers).
• Guided drift resolution: Apply the Pattern A approach when SCOPE.md flags drift between origin and destination modules.
• PHP-only module rename: Apply the Pattern B approach to rename Modules/<X> → Modules/<Y> while keeping the facade stable (URLs/permissions/pages) to reduce blast radius.
• Hard-earned guardrails: Includes checks and “gotchas” like nWidart cache files, InstallController hardcoded module identifiers, modules_statuses.json updates, and DB system version backfill.

Quick Start

Ask an AI: "Plan and perform the migration to rename Modules/Copiloto to Modules/Jana using PHP-only changes, applying the correct drift/rename pattern, updating composer autoload, caches, InstallController hardcodes, modules_statuses.json, and validating with bin/check-scope.php."