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

게시글은 워크플로와 구현 세부를 공유하는 형태였기 때문에 실무 경험을 찾는 개발자들로부터 관심이 모였다. 많은 반응이 Koog을 통한 로컬 반복과 commonMain 계약의 현실적인 편의성에 집중되었고, 일부는 보안과 디버그 전용 로컬 실행의 한계에 대해 우려를 표했다. 전반적으로는 동일한 문제를 겪은 사람들이 구체적 실행 전략과 구현 팁을 얻었다는 반응이 우세했다.

• 공통 계약을 sealed interfaces로 commonMain에 정의하면 플랫폼 간 인터페이스 불일치 문제를 사전에 차단할 수 있다. UI 개발 단계에서는 동일 인터페이스를 구현한 페이크를 사용하여 백엔드 배포 없이도 프롬프트와 출력 형식을 빠르게 검증할 수 있다. 디버그 빌드에서 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와 백엔드 간 계약을 단순화하고 디버깅을 용이하게 만든다. 글에서는 구조화된 출력을 사용해 공통 계약에 맞춘 테스트와 복사·전환 과정을 수월하게 진행한 점을 언급하고 있다.