1 hour
How to 코드 마이그레이션 실행 with Eigent
레거시 스택을 통제된 체크포인트 단위로 마이그레이션하세요 — 기존 시스템을 새 시스템에 매핑하고, 전환을 마일스톤별로 진행하며, 각 전환 전에 패리티를 검증합니다.
What you need
- Eigent 데스크톱 앱
- 코드베이스 접근 권한(로컬 또는 연결된 저장소)
- 테스트 스위트, 린트, 타입 체크 도구
Best for
- 프레임워크, 런타임 또는 플랫폼 규칙을 변경해야 하는 레거시에서 최신 스택으로의 전환
- 호환성 계층, 단계적 전환, 각 체크포인트에서의 명시적 검증이 필요한 팀
- 점진적 strangler-fig 또는 branch-by-abstraction 마이그레이션을 관리하는 엔지니어
Starter Prompt
이 코드베이스를 [legacy stack or system]에서 [target stack or system]으로 마이그레이션하세요. 요구사항: - 먼저 레거시 가정들을 인벤토리화하세요: 라우팅, 데이터 모델, 인증, 설정, 빌드 도구, 테스트, 배포, 외부 계약. - 기존 스택을 새 스택에 매핑하고 직접 대응되는 항목이 없는 부분은 명확히 짚으세요. - 한 번에 크게 다시 쓰는 대신 호환성 계층 또는 체크포인트를 포함한 점진적 마이그레이션 계획을 제안하세요. - 마이그레이션에서 사용자에게 보이는 변경이 명시적으로 필요하지 않다면 동작은 그대로 유지하세요. - 마일스톤 단위로 작업하고, 각 마일스톤 후에는 린트, 타입 체크, 집중 테스트를 실행하세요. - 전환이 완료될 때까지 롤백 또는 대체 경로 옵션을 보이도록 유지하세요. - 검증에 실패하면 계속 진행하기 전에 수정하세요. 먼저 마이그레이션 범위를 매핑하고 체크포인트 계획을 제안하세요.
작동 방식
- 레거시 가정을 인벤토리화합니다 — 라우팅, 데이터 모델, 인증, 설정, 빌드 도구, 테스트, 배포, 외부 계약.
- 기존 스택을 새 스택에 매핑하고 직접 대응되는 항목이 없는 부분을 짚어냅니다.
- 한 번에 크게 다시 쓰는 대신 호환성 계층 또는 체크포인트를 포함한 점진적 마이그레이션 계획을 제안합니다.
- 마이그레이션에서 사용자에게 보이는 변경이 명시적으로 필요하지 않다면 동작은 그대로 유지합니다.
- 각 마일스톤 후에는 린트, 타입 체크, 집중 테스트를 실행해 계속 진행하기 전에 패리티를 입증합니다.
- 전환이 완료될 때까지 롤백 또는 대체 경로 옵션을 보이도록 유지합니다.
더 시도해볼 프롬프트
- 이 코드베이스에서 대상 스택에 직접 대응되는 것이 없는 부분은 무엇인가요? 각 격차를 어떻게 처리해야 하나요?
- 전환 기간 동안 기존 코드와 새 코드가 공존할 수 있게 하는 호환성 계층을 제안하세요.
- 이 마일스톤 이후 레거시 경로와의 패리티를 입증하는 가장 작은 테스트나 검사는 무엇인가요?
- 이 체크포인트의 마이그레이션이 운영 환경에서 실패하면 롤백 단계는 무엇인가요?
사용 방법
코드베이스가 연결된 상태로 Eigent를 열고 소스 스택과 대상 스택을 설명하세요. 마이그레이션 범위 인벤토리부터 시작하세요 — 이렇게 하면 코드 변경 전에 이동해야 할 모든 항목을 완전히 파악할 수 있습니다. 마일스톤별로 작업하고 각 단계마다 검증하세요. 마이그레이션이 며칠에 걸친다면 결정 사항, 보류 항목, 검증 결과를 세션 간에 추적할 ExecPlan 문서를 생성해 달라고 Eigent에 요청하세요.
예상 결과
마이그레이션 범위 인벤토리, 체크포인트 기반 마이그레이션 계획, 각 마일스톤의 구현 diff, 그리고 각 단계 후 패리티를 확인하는 검증 요약. 각 전환 지점에는 롤백 옵션이 기록됩니다.
제한 사항
- 복잡한 데이터 모델 변경에는 Eigent가 초안을 작성하더라도 사용자가 검토해야 하는 수동 스키마 마이그레이션 스크립트가 필요할 수 있습니다.
- 외부 계약 변경은 마이그레이션 자체와 별도로 조율해야 합니다.
- 대규모 리라이트는 여러 개의 작은 마일스톤으로 나누는 것이 가장 좋습니다 — 마일스톤당 스택의 한 레이어 이상을 묶지 마세요.