KMP 앱에서 Koog로 LLM 기능을 빠르게 개발하는 워크플로 정리

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

앱 내부에 API 키를 둘 수 없어 LLM 호출을 서버로 옮기면 프롬프트 반복마다 백엔드 배포가 병목이 되므로 작성자는 개발 반복을 로컬에서 수행하는 워크플로를 채택했다. 공통 계약을 sealed interfaces로 commonMain에 정의하고 UI는 페이크 구현을 대상으로 개발하여 프롬프트와 출력 형식을 빠르게 검증했으며 디버그 빌드에서는 Koog을 사용해 로컬에서 동일한 동작을 시뮬레이션했다. 프롬프트가 안정화되면 Koog 호환성을 이용해 Kotlin 백엔드로 코드를 거의 그대로 복사할 수 있었고 이 과정은 배포 주기와 제품 피드백 루프를 단축하는 결과를 낳았다. 구조화된 출력을 함께 사용하면 UI와 백엔드 간 계약이 단순해져 전환 비용이 더 낮아지는 장점이 있었다.

실용적 조언

공통 계약을 sealed interfaces로 commonMain에 정의하면 플랫폼 간 인터페이스 불일치 문제를 사전에 차단할 수 있다. UI 개발 단계에서는 동일 인터페이스를 구현한 페이크를 사용하여 백엔드 배포 없이도 프롬프트와 출력 형식을 빠르게 검증할 수 있다. 디버그 빌드에서 Koog을 사용해 로컬 실행을 반복한 뒤 프롬프트가 안정화되면 해당 코드를 Kotlin 백엔드로 복사하면 구현 전환 비용이 거의 들지 않는다.

섹션별 상세

앱 내에 API 키를 포함할 수 없어 LLM 호출을 서버에서 해야 한다는 제약이 있고, 이 때문에 프롬프트를 반복적으로 개선할 때마다 백엔드 배포가 병목이 되는 문제가 발생했다. 작성자는 이 문제에 대해 프롬프트 반복 속도가 제품 개발 속도를 좌우한다고 판단했으며, 배포 주기를 줄이는 대신 개발 환경에서 반복을 빠르게 수행하는 방식을 선택했다. 이 방식은 프롬프트 변경 사항을 UI 개발자가 즉시 확인할 수 있게 하여 제품 측면에서 피드백 루프를 단축하는 효과가 있었다.

공통 계약을 sealed interfaces로 commonMain에 정의하고 실제 UI는 페이크 구현을 대상으로 개발하는 방식이 핵심이다. 입력과 출력의 스키마를 공통 모듈에 고정하면 UI는 서버 구현에 의존하지 않고도 상태와 렌더링을 테스트할 수 있으며, 페이크 구현은 같은 인터페이스를 구현하여 디버그 빌드에서 동작하도록 했다. 이 구조는 플랫폼 간 코드 재사용을 보장하면서도 프롬프트와 구조화된 출력의 반복 검증을 가능하게 했고, 결과적으로 백엔드로의 이식 비용을 최소화했다.

Koog을 디버그 빌드에서 로컬 엔진으로 사용해 프롬프트를 반복하고 안정화되면 동일한 코드를 Kotlin 백엔드로 복사하는 전략이 적용되었다. Koog이 KMP 환경에서 같은 런타임 동작을 지원하기 때문에 로컬에서의 개발 결과를 서버로 거의 그대로 이전할 수 있었고, 구조화된 출력 계약을 맞추면 API 변환 작업이 단순했다. 글쓴이는 이 흐름이 배포 빈도와 제품 민첩성 사이의 트레이드오프를 줄였다고 보고하며 Koog 설정과 구조화된 출력 관련 질문을 받겠다고 밝혔다.

용어 해설

Kotlin 멀티플랫폼(Kotlin Multiplatform): — Kotlin Multiplatform은 공통 코드베이스(commonMain)를 여러 플랫폼(Android, iOS, JVM 등)에서 재사용하도록 설계된 개발 방식이다. 공통 모듈에 인터페이스와 데이터 계약을 정의하면 플랫폼별 구현을 분리하여 UI와 비즈니스 로직을 동시에 개발할 수 있다. 이 글에서는 공통 코드에 sealed interfaces로 계약을 정의하고 각 플랫폼에서 페이크 구현과 실제 구현을 교체하는 워크플로가 핵심이다.
Koog: — Koog는 JetBrains 생태계에서 Kotlin Multiplatform 환경에서 LLM 관련 기능을 로컬 및 서버에서 실행할 수 있도록 지원하는 도구이다. 동일한 코드가 디버그 빌드에서는 로컬 모의 구현으로, 서버에서는 실제 LLM 호출로 동작하도록 해 워크플로 전환 비용을 줄인다. 게시글에서는 Koog를 이용해 디버그 단계에서 빠르게 프롬프트를 반복하고 안정되면 백엔드로 옮긴 사례를 다루고 있다.
구조화된 출력(Structured Output): — 구조화된 출력은 모델 응답을 JSON이나 명확한 스키마로 제한하여 클라이언트가 파싱과 후처리를 안정적으로 수행하도록 만드는 기법이다. 프롬프트 설계에서 결과 형식을 고정하면 UI와 백엔드 간 계약을 단순화하고 디버깅을 용이하게 만든다. 글에서는 구조화된 출력을 사용해 공통 계약에 맞춘 테스트와 복사·전환 과정을 수월하게 진행한 점을 언급하고 있다.

언급된 도구

Koog추천

Kotlin Multiplatform 환경에서 로컬 디버그와 서버 실행에서 동일한 LLM 관련 로직을 동작시키는 프레임워크

Kotlin Multiplatform (KMP)중립

commonMain에 공통 계약을 둬서 UI와 서버 구현을 공유하는 멀티플랫폼 개발 방식

언급된 리소스

문서Building AI features isn't scary