1 hour
How to 코드베이스 리팩터링하기 with Eigent
동작은 바꾸지 않으면서 죽은 코드를 제거하고 레거시 패턴을 현대화하세요 — 작고 검토 가능한 단계로 진행합니다.
What you need
- Eigent 데스크톱 앱
- 코드베이스 접근 권한(로컬 또는 연결된 리포지토리)
- 테스트 스위트 또는 CI 파이프라인
Best for
- 죽은 코드, 지나치게 큰 모듈, 또는 오래된 추상화 때문에 일상적인 수정 비용이 큰 코드베이스
- 작업을 스택 마이그레이션으로 바꾸지 않으면서 기존 코드 자체를 현대화해야 하는 팀
- 새 기능 작업이나 팀 온보딩을 위해 코드베이스를 준비하는 엔지니어
Starter Prompt
이 코드베이스를 현대화하고 리팩터링하세요. 요구사항: - 내가 명시적으로 기능 변경을 요청하지 않는 한 동작은 유지하세요. - 먼저 변경을 느리게 만드는 죽은 코드, 중복 경로, 지나치게 큰 모듈, 오래된 추상화, 레거시 패턴을 식별하는 것부터 시작하세요. - 제안하는 각 작업 단계마다 현재 동작, 구조적 개선 사항, 그리고 동작이 안정적으로 유지되었음을 입증해야 하는 검증 확인을 명시하세요. - 죽은 코드 삭제, 제어 흐름 단순화, 헬퍼 추출, 또는 리포지토리의 현재 규칙에 맞게 오래된 패턴 교체와 같은 작고 검토 가능한 리팩터링 단계로 작업을 나누세요. - 리팩터링에 의해 변경이 필요하지 않은 한 public API는 안정적으로 유지하세요. - 별도의 마이그레이션 작업으로 분리해야 하는 프레임워크 마이그레이션, 의존성 업그레이드, API 변경, 아키텍처 이동이 있으면 반드시 지적하세요. 이를 수행할 계획을 제안하세요.
작동 방식
- 편집하기 전에 Eigent에게 해당 영역을 먼저 매핑하도록 요청하세요 — 소음이 많은 모듈, 중복 로직, 사용하지 않는 코드, 오래된 패턴을 식별합니다.
- 한 번에 하나의 정리 주제만 선택하세요 — 사용하지 않는 코드 제거, 제어 흐름 단순화, 오래된 패턴 현대화, 또는 큰 파일 분리.
- Eigent가 파일을 수정하기 전에 현재 동작, 구조적 개선 사항, 그리고 동작이 안정적으로 유지되었음을 증명하는 가장 작은 검증을 먼저 설명하게 하세요.
- 전체 정리를 한 번에 묶어 diff를 만들기보다, 각 단계 후에 가장 작고 유용한 검증을 리뷰하고 실행하세요.
- 스택 변경, 의존성 마이그레이션, 아키텍처 이동은 정리를 끝내는 데 필수적이지 않은 한 별도 작업으로 유지하세요.
더 시도해볼 프롬프트
- 이 영역에서 죽은 코드나 사용되지 않는 export가 가장 많은 파일은 무엇인가요?
- 동일한 로직이 반복되는 모든 위치를 식별하고 하나의 통합 지점을 제안하세요.
- 이 모듈에서 리포지토리의 현재 규칙과 충돌하는 레거시 패턴은 무엇인가요?
- public API를 변경하지 않고 이 지나치게 큰 파일을 더 작고 명확하게 소유권이 구분된 조각으로 나누세요.
사용 방법
먼저 Eigent에게 지저분한 영역을 매핑해 달라고 요청하세요 — 어떤 코드도 건드리기 전에 가장 가치 있는 정리 기회를 식별합니다. 한 번에 하나의 주제만 작업하고, 각 diff를 검토한 뒤 다음 단계로 넘어가세요. 각 단계 후에는 테스트 스위트나 CI를 검증 확인으로 사용하세요. Eigent가 스택 마이그레이션이나 의존성 변경을 제안하면 별도 작업으로 표시하고, 현재 리팩터링은 구조에만 집중하세요.
예상 출력
우선순위가 지정된 정리 계획, 작고 집중된 일련의 diff(단계당 하나), 그리고 각 단계마다 무엇이 변경되었는지와 어떤 검증이 동작 안정성을 확인하는지 보여주는 검증 요약입니다.
제한 사항
- 해당 영역에 기존 테스트 스위트나 검증할 수 있는 명확한 동작 계약이 있을 때 가장 효과적입니다.
- 큰 모노레포는 한 번에 하나의 서비스나 모듈로 범위를 좁히는 것이 좋습니다.
- 아키텍처 변경, 런타임 업그레이드, 프레임워크 마이그레이션은 별도 작업이어야 합니다 — 이를 리팩터링과 섞으면 diff를 검토하기 어려워집니다.