Refactor

Refactor Skill - Unified Agent v2.0

Lazy-loaded skill - Only loaded when explicitly invoked via /studio refactor

🛠️ Standard Tool Kit

✅ RECOMMENDED: grepai search "pattern" | /toolkit search "query"
✅ FOR READING: Read tool (optimized for file access)
✅ FOR EDITING: Edit tool (precise string replacement)
✅ FOR WRITING: Write tool (new file creation)

Tool Selection Guide

Quick Reference

Examples

# Quick cleanup for low-risk items
/studio refactor --quick

# Complete workflow on recent changes
/studio refactor --full --scope=recent

# Performance profiling
/studio refactor --profile --scope=all

# Security audit on auth module
/studio refactor --security --scope=directory:src/auth

# Type safety improvement
/studio refactor --types --scope=recent

Scope Options

Mode Details

--quick (Quick Mode)

Purpose: Auto-fix low-risk items with confidence

When to Use:

• Risk score < 30
• Complexity < 8
• Test coverage > 80%

What it does:

1. Identifies safe improvements
2. Applies refactoring patterns
3. Tests after each change
4. Commits verified changes

--full (Full Mode - Default)

Purpose: Complete refactoring workflow

Workflow:

1. ANALYZE - Detect issues
2. REVIEW - Classify and prioritize
3. RESOLVE - Apply changes
4. VERIFY - Validate results

--analyze (Analysis Only)

Purpose: Understand code health without changes

Analysis includes:

• Complexity metrics (cyclomatic, cognitive)
• Duplication detection
• Code smell identification
• Maintainability assessment

--profile (Performance Profiling)

Purpose: Identify and fix performance bottlenecks

When to Use:

• Functions are slow
• Memory usage is high
• Need optimization metrics

Workflow:

1. Measure current performance
2. Identify bottlenecks
3. Apply optimizations
4. Verify improvement

--security (Security Scanning)

Purpose: Detect and fix security vulnerabilities

OWASP Top 10 Checked:

• Injection attacks (SQL, NoSQL, XSS)
• Authentication/Authorization issues
• Sensitive data exposure
• Cryptographic failures
• Dependency vulnerabilities

Severity Levels:

• P0 - Critical (immediate fix)
• P1 - High (fix ASAP)
• P2 - Medium (fix soon)
• P3 - Low (fix when possible)

--types (TypeScript Improvement)

Purpose: Improve type safety and eliminate any

What it does:

• Replaces any with proper types
• Adds Zod validation at boundaries
• Removes unsafe type assertions
• Improves type coverage

Success Criteria:

• Zero any in production code
• Type coverage ≥ 95%
• tsc --strict passing

Core Principles

• Safety First - Validate all changes before implementation
• Incremental - Small, verifiable steps
• Evidence-Based - Use metrics to guide decisions
• Test Continuously - Run tests after each change
• Document Thoroughly - Explain what and why

Success Criteria

Universal

• ✅ All tests passing
• ✅ No type errors
• ✅ Complexity reduced
• ✅ No regressions
• ✅ Documentation complete

Mode-Specific

Best Practices

1. Always analyze first - Understand issues before acting
2. Validate changes - Never skip validation step
3. Start with quick wins - Build momentum
4. Test continuously - After each small change
5. Commit logically - Small, reviewable commits
6. Document thoroughly - Explain reasoning

Full Documentation

For complete documentation including advanced patterns, subagent collaboration, and configuration options, see the main refactor skill.

Version: 2.0.0 | Lazy Load: Enabled