/ue-refactor

Refactor the specified Unreal Engine C++ code to improve AI-friendliness.

Target

$ARGUMENTS

Refactoring Process

Phase 1: Analysis

1. If target is a directory, use Glob to find all .h and .cpp files
2. Read each file and identify AI-friendliness violations
3. Prioritize issues: Critical > Warning > Info

Phase 2: Preview (REQUIRED)

Before making any changes, present a complete preview of all planned modifications:

## Refactoring Preview

### [filename]

#### Change 1: [Issue Type]
**Before:**
```cpp
[original code]

After:

[proposed code]

Reason: [explanation]

---

[Additional changes...]

### Phase 3: Confirmation
After presenting all changes, ask the user:
"Proceed with these refactoring changes? (yes/no/select specific changes)"

Wait for user confirmation before applying any edits.

### Phase 4: Apply Changes
Only after user approval:
1. Apply each change using the Edit tool
2. Report each change as it's applied
3. Summarize total changes made

## Refactoring Rules

### Always Apply (Critical Fixes)
- Extract functions exceeding 100 lines into smaller functions
- Reduce nesting using Early Return pattern
- Split files with multiple class definitions

### Apply with Caution (Warnings)
- Add `this->` prefix to member variable access
- Replace unnecessary `auto` with explicit types
- Add parameter names to header declarations
- Extract 50-100 line functions if logically separable

### Suggest Only (Info)
- Add Doxygen comments (show example, let user decide)
- Convert includes to forward declarations
- Add UPROPERTY/UFUNCTION metadata

## Refactoring Patterns

### Early Return Pattern
```cpp
// Before
if (Actor)
{
    if (Actor->IsValid())
    {
        DoSomething();
    }
}

// After
if (!Actor) return;
if (!Actor->IsValid()) return;
DoSomething();

Member Variable Explicit Access

// Before
Health += Delta;

// After
this->Health += Delta;

Explicit Type Declaration

// Before
auto Result = GetPlayerState();

// After
APlayerState* Result = GetPlayerState();

Function Extraction

// Before: 80-line function
void ProcessAll()
{
    // 30 lines of input processing
    // 25 lines of validation
    // 25 lines of output generation
}

// After: 3 focused functions
void ProcessAll()
{
    ProcessInput();
    ValidateData();
    GenerateOutput();
}

Language

Follow the user's language preference:

• If user communicates in Korean, respond in Korean
• If user communicates in English, respond in English

Important Notes

• NEVER apply changes without showing preview first
• NEVER skip user confirmation
• Preserve all original functionality
• Maintain Unreal Engine naming conventions (A, U, F, I, E, T prefixes)
• Keep UPROPERTY/UFUNCTION macros intact
• Do not modify generated code (*.generated.h references)