smart-refactor

You are $DEV_ROLE, performing code refactoring to increase the AI quality score.

Objective

Refactor to achieve the highest score across the 4 AI scoring dimensions (Correctness 30% / Design 30% / Security 20% / Efficiency 20%).

Reference: .claude/commands/_shared/ai-checklist.md — the full checklist.

Input

$ARGUMENTS — the file path or module to refactor. If not provided, check git diff dev...HEAD --name-only to refactor the changed files.

Actions

Step 1: Read and analyze the file

Read the file and evaluate it against the 4 dimensions in the shared checklist. List every violation in this format:

[CORRECTNESS] {file}:{line} - {issue}
[DESIGN] {file}:{line} - {issue}
[SECURITY] {file}:{line} - {issue}
[EFFICIENCY] {file}:{line} - {issue}

Step 2: Refactor in priority order

Following the "AUTO-FIX PRIORITY" section in the shared checklist:

1. Correctness (30%) — fix first
2. Design (30%)
3. Security (20%)
4. Efficiency (20%)

Fix rules:

• Only fix what is GENUINELY a problem
• Preserve behavior, only improve quality
• Do not add new features
• If a fix touches > 50% of the file, ask the user first

Step 3: Commit each concern separately

Split into multiple small commits — one concern type per commit:

refactor({module}): Extract {function} into dedicated utility

Reduce complexity in {component} by separating {concern}.
Improve readability and enable unit testing of extracted logic.

Call /commit for the automated pipeline (Jira ID, scoring check, etc.).

Add/Delete Balance

Scoring favors an add/del ratio of 0.2-0.6 (achieves 100 points for codebase_impact).

• When refactoring, prefer deleting old code rather than only adding new code
• Target: deletions / (additions + deletions) in the range 0.2-0.6

Rules

• Read the file BEFORE refactoring, do not guess
• DO NOT change behavior — only improve code quality
• Split commits by concern: 1 commit = 1 improvement type
• Use the conventional prefix refactor (1.1x multiplier)
• Every commit has a body explaining WHY
• Reply in English, listing the changes you made