Codex use case
코드 마이그레이션 수행하기
단계별로 검증하며 레거시 스택을 이전하세요.
Codex로 레거시 시스템의 각 구성 요소가 새 스택에서 무엇에 대응하는지 파악하세요. 마이그레이션을 단계별로 진행하고, 다음 단계로 넘어가기 전에 기존 시스템과 동일하게 동작하는지 확인하세요.
Best for
- 프레임워크, 런타임, 빌드 시스템 또는 플랫폼별 개발 관례를 바꿔야 하는 레거시 스택 현대화 작업
- 호환성 계층과 단계적 전환이 필요하고, 마이그레이션의 각 단계에서 정해진 검증 절차를 거쳐야 하는 팀
Contents
코드 마이그레이션 수행하기
단계별로 검증하며 레거시 스택을 이전하세요.
Codex로 레거시 시스템의 각 구성 요소가 새 스택에서 무엇에 대응하는지 파악하세요. 마이그레이션을 단계별로 진행하고, 다음 단계로 넘어가기 전에 기존 시스템과 동일하게 동작하는지 확인하세요.
Codex로 레거시 시스템의 각 구성 요소가 새 스택에서 무엇에 대응하는지 파악하세요. 마이그레이션을 단계별로 진행하고, 다음 단계로 넘어가기 전에 기존 시스템과 동일하게 동작하는지 확인하세요.
Related links
Best for
- 프레임워크, 런타임, 빌드 시스템 또는 플랫폼별 개발 관례를 바꿔야 하는 레거시 스택 현대화 작업
- 호환성 계층과 단계적 전환이 필요하고, 마이그레이션의 각 단계에서 정해진 검증 절차를 거쳐야 하는 팀
Skills & Plugins
- 병합하기 전에 위험도가 높은 마이그레이션 작업, 종속성 변경 사항, 외부에 노출되는 부분을 점검하세요.
- 마이그레이션의 각 단계가 끝날 때마다 CI 오류를 해결해 마지막 단계까지 문제가 쌓이지 않도록 하세요.
- 마이그레이션이 ASP.NET Core 앱 모델, `Program.cs`, 미들웨어, 테스트, 성능 또는 버전 업그레이드와 관련된 경우에는 프레임워크별 지침을 활용하세요.
| Skill | Why use it |
|---|---|
| Security Best Practices | 병합하기 전에 위험도가 높은 마이그레이션 작업, 종속성 변경 사항, 외부에 노출되는 부분을 점검하세요. |
| Gh Fix Ci | 마이그레이션의 각 단계가 끝날 때마다 CI 오류를 해결해 마지막 단계까지 문제가 쌓이지 않도록 하세요. |
| Aspnet Core | 마이그레이션이 ASP.NET Core 앱 모델, `Program.cs`, 미들웨어, 테스트, 성능 또는 버전 업그레이드와 관련된 경우에는 프레임워크별 지침을 활용하세요. |
Starter prompt
소개
기술 스택을 전환할 때는 Codex로 마이그레이션 범위를 파악하고 계획에 따라 작업을 진행할 수 있습니다. 라우팅, 데이터 모델, 설정, 인증, 백그라운드 작업, 빌드 도구, 배포, 테스트는 물론 언어와 프레임워크의 관례까지 전환 범위에 포함될 수 있습니다.
Codex는 레거시 시스템의 구성 요소를 파악하고 기존 개념이 새 스택에서 무엇에 해당하는지 정리합니다. 시스템 전체를 한꺼번에 다시 작성할 필요 없이 변경 사항을 단계별로 적용할 수 있습니다. 이런 방식은 레거시 프레임워크에서 벗어나거나, 새 런타임으로 이식하거나, 제품을 계속 운영하면서 기존 스택을 점진적으로 교체할 때 유용합니다.
사용 방법
- 먼저 마이그레이션 범위를 정리하세요. 레거시 패키지, 프레임워크 관례, 라우팅, 데이터 접근, 인증, 설정, 빌드 도구, 테스트, 배포 시 전제하는 조건과 전환 후에도 지켜야 할 외부 시스템과의 계약을 목록으로 만드세요.
- 기존 개념이 대상 스택에서 각각 무엇에 해당하는지 정리하고, 직접 대응하는 개념이 없는 항목을 짚어 달라고 Codex에 요청하세요.
- 점진적인 전환 전략을 선택하세요. 호환성 계층을 두거나, 모듈별로 이식하거나, 추상화 계층을 통해 기존 구현과 새 구현을 분기하거나, 시스템 경계를 하나씩 정해 교체하는 스트랭글러 패턴을 사용할 수 있습니다.
- 마이그레이션 과정에서 사용자에게 드러나는 변화가 불가피한 경우에만 기존 동작을 변경하고, 어떤 경우가 예외인지 명시하세요.
- 각 단계가 끝나면 기존과 동일하게 동작하는지 확인하는 데 필요한 최소한의 검증을 수행하세요. 린트, 타입 검사, 변경 범위에 집중한 테스트, 계약 테스트, 스모크 테스트를 실행하거나 기존 실행 경로와 새 실행 경로의 결과를 나란히 비교하세요.
- 전체 재작성이 끝날 때까지 기다리지 말고, 각 점검 시점에 코드 변경 내역과 남은 전환 위험을 검토하세요.
ExecPlans 활용하기
코드 현대화 쿡북에서는 실행 계획 문서인 ExecPlans를 소개합니다. Codex는 이 문서로 코드 정리 작업의 전체 진행 상황을 파악하고, 목표로 하는 최종 상태를 명시하며, 작업을 한 차례 마칠 때마다 검증 결과를 기록할 수 있습니다. Codex에 복잡한 마이그레이션을 맡길 때는 시스템의 각 부분에 대해 ExecPlan을 작성해 달라고 요청하세요. 그러면 모든 결정 사항과 기술 스택 선택을 기록해 두고 나중에 검토할 수 있습니다.
목표와 함께 사용하기
마이그레이션 단계 중 오래 걸리는 작업에는 목표를 설정해 Codex가 작업 방향을 유지하도록 하세요. 목표에는 도달해야 할 최종 상태, 기존과 동일하게 동작하는지 확인하는 방법, 롤백 시 요구 사항, 작업을 중단할 조건을 명확히 적으세요.
Related use cases
Codex가 사용할 CLI 만들기
Codex에 어느 폴더에서나 실행할 수 있고 레포지토리 스크립트와 조합하거나 파일을 다운로드할 때 쓸 수 있는 CLI를 만들어 달라고 하세요
검증 모듈 마이그레이션
Codex에 마이그레이션 범위를 명시한 문서와 계약 테스트 픽스처, 미리 설정한 클라우드 환경을 제공하세요
목표를 향해 작업하기
Codex가 여러 대화 턴에 걸쳐 작업을 이어가야 하고 종료 조건의 충족 여부를 확인할 수 있다면 `/goal`을 사용하세요.