Multi-File Refactor

Refactor the {{module_name}} module from {{current_pattern}} to {{target_pattern}}.

Scope:
- Files to change: all files in {{directory_path}} and their imports
- Preserve all existing functionality — no behavior changes
- Maintain backward compatibility for any exported public API

Steps:
1. List all files that will be affected before making changes
2. Create the new structure/pattern first
3. Migrate each file, updating imports as you go
4. Update all tests to match the new pattern
5. Run the existing test suite and fix any failures

Constraints:
- No temporary "bridge" code — do the full migration in one pass
- Update barrel exports (index.ts) if they exist
- Add JSDoc comments to any new public interfaces
- If a file exceeds 300 lines after refactoring, split it and explain the split

After completing, provide a summary: files changed, files created, files deleted, and any decisions you made.