Build a repeatable PHP-to-Java migration engine with Kiro

안녕하세요! 오랫동안 운영해 온 프로그램의 언어를 바꾸는 일, 상상만 해도 머리가 지끈지끈 아파오시죠? 라라벨(Laravel) 같은 PHP로 만든 오래된 프로그램을 자바(Java)로 옮기는 작업은 숨겨진 비즈니스 규칙과 구조 차이 때문에 그동안 개발자들에게 큰 도전이었어요.

오늘은 AI 개발환경과 재사용 가능한 엔진을 활용해 이 복잡한 과정을 체계적이고 반복 가능한 작업으로 바꾸는 방법을 소개해 드릴게요. 갑자기 어려운 이야기 같아 보이시죠? 걱정 마세요. 아주 쉽게 차근차근 풀어드릴게요!

전체 글 정리

1. 키로(Kiro)와 AI 에이전트의 만남

• 이번 방식의 핵심은 키로라는 AI 통합 개발환경(IDE)을 사용하는 거예요.
• 개발자와 AI 에이전트가 함께 호흡을 맞추며 여러 단계의 엔지니어링 작업을 처리할 수 있죠.
• 특히 AWS의 대규모 마이그레이션 서비스와도 연동되어, 똑같은 규칙 파일로 사람이 직접 개입하는 방식과 완전 자동화 방식 모두로 실행할 수 있어요.

2. 무작정 코딩 금지! 정확한 스캐너부터 실행하기

• 가장 중요한 철칙은 원본 코드를 대충 읽고 짐작해서 자바로 옮기지 않는 거예요.
• 의존성 설치 없이도 작동하는 가벼운 스캐너 도구를 먼저 실행해서 PHP 코드 속 데이터 구조와 규칙을 완벽하게 읽어내야 해요.
• 여기서 애매한 부분이 발견되면 AI가 억지로 추측하지 않고 사람이 직접 확인할 수 있도록 목록에 남겨둔답니다.

3. 총 8단계로 이뤄지는 체계적인 마이그레이션

• 준비 단계(스캐너 실행 및 인벤토리 구축)를 거쳐 총 8단계의 워크숍이 진행돼요.
• 자바 코드를 쓰기 전에 패리티 하네스(원본과 결과물이 똑같이 작동하는지 검증하는 도구)를 먼저 만들어서 시험에 통과하는지 확인해요.
• 그후 프로젝트 뼈대를 만들고, 데이터 모델과 화면 입출력 계층, 그리고 비즈니스 로직을 차례대로 변환해 나간답니다.

이용 방법 / 활용 방안

• 규칙을 파일로 관리하기: 이 방식의 장점은 마이그레이션 노하우가 특정 도구가 아니라 마크다운(Markdown) 같은 공유 파일에 담겨 있다는 점이에요. 규칙을 한 번 다듬어두면 다른 프로젝트를 할 때도 똑같이 재사용할 수 있죠.
• 수정이 필요할 때는 코드가 아니라 룰을 고치기: 번역된 자바 코드를 직접 일일이 수정하기보다, 변환 규칙이 담긴 룰북(Rulebook)을 수정하고 코드를 다시 생성하는 방식을 사용해요. 이렇게 하면 나중에 비슷한 작업을 할 때 훨씬 효율적이랍니다.
• 다양한 프레임워크 지원: 라라벨뿐만 아니라 심포니(Symfony)나 코드이그나이터(CodeIgniter) 같은 다양한 PHP 프레임워크에도 확장해서 적용할 수 있어요.

시스템을 완전히 새로운 언어로 재작성하는 일은 늘 큰 모험처럼 느껴지죠. 하지만 AI 도구와 명확한 검증 단계를 거친다면 이제는 예측 가능하고 반복할 수 있는 작업이 될 수 있어요.

여러분이라면 오랜 기간 공들여 만든 프로그램을 다른 언어로 옮겨야 할 때, 가장 먼저 무엇을 확인하고 싶으신가요?