50개 레포 Spring Boot 버전업 시나리오에서 Updater가 OpenRewrite(정적 코드 변환)와 Claude(빌드 에러 수정)를 역할 분담하는 방법을 상세히 설명하는 시리즈 3편. 결정론적 변환은 OpenRewrite recipe가 AST 기반으로 처리하고, 비즈니스 맥락이 필요한 예외는 Claude가 분석·수정하며, 빌드가 최종 가드레일이 되는 구조다.
핵심 포인트- Updater의 두 무기: OpenRewrite(결정론적 AST 기반 변환) + Claude(AI 빌드 에러 수정). 순서: OpenRewrite 먼저 → 빌드 성공 시 종료, 실패 시 Claude 투입 → 빌드 재시도 루프
- AST 기반 변환의 결정론: 단순 텍스트 치환(sed/정규식)은 주석·문자열 리터럴까지 건드림 — AST 기반은 "이 타입의, 이 시그니처를 가진 메서드 호출"만 정확히 지목
- Recipe 방식 2종: YAML(선언적 — 의존성 버전 조정, deprecated API 마이그레이션) + Java/Kotlin(프로그래밍 — AST visitor 구현, 비즈니스 판단 필요 변환)
- Init script 주입 방식: `build.gradle.kts` 수정 없이 외부에서 recipe 주입 → "변환 도구를 위한 변환"이라는 닭-달걀 순환 문제 회피, 대상 레포에 흔적 없음
- Claude의 역할 경계: 빌드 에러 로그 분석 + 주변 코드의 예외 처리 패턴을 읽어 수정안 생성. 수정이 옳은지는 Claude가 보장 불가 — 빌드 가드레일이 최종 검증
- Recipe = 실행 가능한 문서: 슬랙 메시지 대비 실행 가능성·재현 가능성·테스트 가능성·Idempotency·버전 관리 모두 우위
상세 정리- Recipe 변환 대상 4가지: 의존성 버전 업데이트, deprecated API 마이그레이션(.allowedOrigins → .allowedOriginPatterns), import 문(패키지 이동), application.yml 설정 프로퍼티 마이그레이션
- 공식 rewrite-spring + 커스텀 recipe 조합: 공식은 프레임워크 표준 마이그레이션, 커스텀은 내부 라이브러리 버전 규약·사내 컨벤션 추가
- Recipe 버전 관리(Nexus): 6개월 후에도 동일한 변환을 토씨 하나 다르지 않게 재현 가능. 변환 규칙 자체가 코드처럼 버전 이력을 가짐
- Idempotent recipe: 이미 변환된 코드에 다시 적용해도 추가 변경 없음 → 언제든 안전하게 재실행 가능
- Claude 수정 예시 1: nullable 타입 변경(findWorkspace 반환이 Workspace? 로 바뀜) — 주변 코드 패턴 읽어 WorkspaceNotFoundException(id) 예외 투입
- Claude 수정 예시 2: 대소문자 오류(getDefaultTimezone → getDefaultTimeZone) 수정
- Convention Plugin + 테스트 스위트가 Claude의 가드레일: 의존성 방향 강제 + 비즈니스 로직 검증 → Claude는 이 가드레일 안에서만 동작
- 파이오니어 경험 인코딩 과정: 첫 레포에서 MySQL 커넥션 릭 발견 → recipe 작성 → 커밋 + Nexus 퍼블리시 → 나머지 49개 레포에 자동 적용. 슬랙 메시지가 recipe로 대체되는 과정
- JUnit 기반 recipe 테스트: "이 변환이 의도한 것만 바꾸는지, 바꾸면 안 되는 것을 건드리지 않는지" 코드로 검증 가능
왜 읽나대규모 다중 레포 마이그레이션에서 OpenRewrite AST 변환과 Claude AI를 역할 분담해 결정론적 변환과 유연한 예외 처리를 동시에 달성하는 설계 — init script 주입 방식, recipe 조합, 빌드 가드레일 구조까지 실제 코드와 함께 배울 수 있는 시리즈 3편이다.
flex·
Twilio Engineering·
포스타입·