웜뱃 블로그

안녕하세요.개인 프로젝트로 산책 기록 앱을 만들면서 구현 대부분을 Claude Code에게 맡기고 있습니다. 오늘은 AI에게 "왜 이렇게 했는지"를 넘겨주는 방법, 결정 기록 문서를 쓰는 방식을 정리해 보려고 합니다. AI 에이전트로 오래 작업하다 보면 같은 설명을 몇 번이고 반복하는 상황을 만나게 됩니다. 새 세션은 지난 대화를 기억하지 못하기 때문입니다. 어제 한 시간 동안 고민해서 정한 내용도 오늘 세션에서는 처음 듣는 이야기가 됩니다.코드만 보고는 이유를 알 수 없는 선택도 많습니다. 흔히 쓰는 라이브러리를 일부러 뺀 코드를 보면 AI는 "개선"한다며 다시 넣고 싶어질 수 있습니다. 그래서 이유를 따로 적어 두는 문서가 필요했습니다. 아래 그림처럼 결정은 사람이 고르고, 적는 일과 다음 세션에서 ..

안녕하세요. 개인 프로젝트로 만들고 있는 산책 기록 앱에서 실내 위치 문제를 들여다본 내용을 정리해 보려고 합니다. 건물 안에서 걷기 기록을 시작하면 "위치 신호가 약해요. 하늘이 트인 곳으로 이동해보세요." 안내가 뜨고 거리는 0에서 움직이지 않습니다. 그런데 같은 자리에서 네이버 지도나 카카오맵을 열면 내 위치 점이 바로 보입니다.지도 앱은 되는데 기록 앱은 왜 안 될까, 지금 방식이 정말 최선일까 궁금해져서 하나씩 확인해 봤습니다. 위 그림처럼 두 앱은 같은 위치를 받아도 쓰는 목적이 다릅니다. 이번 포스팅에서는 실내에서 GPS가 약한 이유, 지도 앱이 실내에서도 점을 보여 주는 방법, 기록 앱이 그 방법을 그대로 쓰기 어려운 이유와 개선 방향을 다뤄보겠습니다. 실내에서 GPS가 약한 이유GPS ..

안녕하세요.개인 프로젝트로 산책 기록 앱을 만들면서 코스 공유 기능을 Claude Code와 함께 설계부터 출시까지 진행했습니다. 오늘은 그 기능의 코드보다, 일을 어떤 순서로 나눠 맡겼는지를 정리해 보려고 합니다. AI에게 기능을 통째로 "만들어 줘"라고 하면 일단 돌아가는 코드는 금방 나옵니다. 그런데 사람이 정해야 할 것까지 AI가 조용히 정해 버리거나, Android와 iOS가 미묘하게 다르게 동작하는 상황을 만나게 됩니다.코스 공유는 특히 조심스러운 기능이었습니다. 걸은 길을 링크로 보내는 기능이라, 잘못 만들면 출발 지점, 그러니까 집 위치가 그대로 드러납니다. 그래서 아래 그림처럼 다섯 단계로 나누고, 단계마다 사람과 Claude가 맡을 일을 나눴습니다. 화면과 규칙은 사람이 먼저 확인하고,..

안녕하세요.개인 프로젝트로 산책 기록 앱을 만들고 있습니다. 오늘은 내가 걸은 코스를 친구에게 링크 하나로 보내는 기능을, 서버 없이 만든 방법을 정리해 보려고 합니다. 코스를 공유하려면 보통 서버에 코스를 저장하고, 링크에는 그 코스의 id만 담습니다. 그런데 이 앱은 Firebase 무료 플랜으로 운영하고 있어서 서버 코드를 둘 수 없습니다.설령 저장할 수 있다고 해도 걱정이 남습니다. 산책 코스는 위치 정보라서, 서버에 쌓이는 순간 그 데이터를 지키는 책임도 같이 생깁니다. 그래서 반대로 접근했습니다. 아래 그림처럼 코스 자체를 링크 안에 담아 보내고, 받는 쪽이 링크를 풀어서 지도를 그립니다.이번 포스팅에서는 좌표를 링크의 해시(#) 뒤에 담는 이유, 좌표를 짧은 글자로 바꾸는 방법, 그리고 집 ..

안녕하세요.개인 프로젝트로 산책 기록 앱을 만들면서 구현 대부분을 Claude Code에게 맡기고 있습니다. 오늘은 그 코드를 리뷰하는 쪽, 서브에이전트로 리뷰어를 세 명 만들어 PR마다 돌린 방법을 정리해 보려고 합니다. AI가 쓴 코드를 같은 대화에서 "리뷰해 줘"라고 하면 대개 비슷한 답이 돌아옵니다. 방금 자기가 쓴 코드라 의도를 이미 알고 있어서, 놓친 부분도 그대로 넘어가기 쉽습니다.보안, 성능, 스타일을 한 번에 보라고 해도 마찬가지입니다. 항목마다 얕게 훑고 "전반적으로 잘 작성되었습니다"로 끝나기 일쑤입니다. 그래서 리뷰어를 역할별로 나눴습니다. 아래 그림처럼 같은 변경 파일을 세 리뷰어가 동시에 따로 읽고, 메인 세션이 결과를 모아 심각도 순으로 정리합니다.이번 포스팅에서는 리뷰어 파일..

안녕하세요.개인 프로젝트로 산책 기록 앱을 만들면서 백엔드를 Firebase 무료 플랜(Spark)만으로 꾸렸습니다. 서버 코드를 한 줄도 두지 않고 출시 준비까지 오면서 정리한 방법과 한계를 적어 보려고 합니다. Firebase로 앱을 만들다 보면 "이건 서버에서 처리해야 하는데" 싶은 순간을 자주 만나게 됩니다. 겹치지 않는 초대 코드를 발급하거나, 사용자가 자기 계정의 정지 상태를 몰래 풀지 못하게 막거나, 다 쓴 임시 데이터를 시간이 지나면 지우는 일 같은 것들입니다. 보통은 Cloud Functions를 쓰면 되지만, Cloud Functions는 종량제 플랜(Blaze)에서만 쓸 수 있습니다. 카드 등록 없이 무료로 운영하고 싶었기 때문에 이 프로젝트에서는 서버 코드 없이 가기로 처음부터 정해..

안녕하세요.개인 프로젝트로 산책 기록 앱을 Android와 iOS로 만들고 있는데, 구현의 대부분을 AI 코딩 에이전트인 Claude Code에게 맡겼습니다. 하나씩 시키는 대신 에이전트가 스스로 다음 할 일을 골라 진행하는 "루프" 방식으로요. 오늘은 그 루프를 어떻게 만들었고, 돌려 보면서 무엇을 바꿨는지 정리해 보려고 합니다. AI 에이전트에게 코드를 맡기다 보면 금방 두 가지 고민이 생깁니다. 한 가지씩 시키면 기능 하나가 끝날 때마다 다음 할 일을 설명하고 테스트 결과를 확인하느라 결국 사람이 계속 붙어 있어야 합니다. 그렇다고 "알아서 다 만들어 줘"라고 맡기면 어디까지 진행됐는지, 왜 그렇게 만들었는지 따라가기 어렵고, 배포처럼 되돌릴 수 없는 일까지 건드릴까 봐 불안합니다. 그래서 이 프로..

안녕하세요. 오랜만에 글을 올립니다.그동안 개인 프로젝트로 산책 기록 앱을 만들고 있었는데, 만들면서 고민했던 내용들을 하나씩 정리해 보려고 합니다. 오늘은 그중에서 기록 데이터를 어떻게 저장하고 서버와 동기화했는지에 대한 이야기입니다. 산책이나 러닝 기록 앱을 만들다 보면 네트워크가 불안정한 상황을 자주 만나게 됩니다. 산길, 지하 주차장, 엘리베이터 안처럼 신호가 잠깐씩 끊기는 곳이 생각보다 많고, 데이터를 아끼려고 모바일 데이터를 꺼 두고 걷는 사용자도 있습니다. 문제는 GPS 기록은 한 번 놓치면 다시 만들 수 없다는 점입니다. 서버 저장에 실패했다고 "다시 시도해 주세요"를 띄우면 사용자는 방금 걸은 1시간을 그대로 잃게 됩니다. 그래서 이 앱에서는 처음부터 기기에 저장되면 기록은 성공이라는 원..

Compose 기반 UI 개발이 주류로 자리 잡으면서, 기존의 View 클래스 기반으로 설계된 API는 AndroidView를 사용해 Compose 환경에서 활용할 수 있었습니다. 하지만 이 접근법은 제약이 많아 완전한 Compose 개발의 장점을 누리기 어렵다는 한계가 있었습니다. Compose에 대한 지원이 확대되면서 네이버 지도 SDK에서도 naver-map-compose를 제공하여 Compose 환경에 적합한 지도 구현이 가능해졌습니다. 이번 포스팅에서는 naver-map-compose를 활용하여 Android Compose 프로젝트에서 지도를 표시하고, 맵 타입과 레이어를 동적으로 변경하는 방법을 다뤄보겠습니다.  환경 설정안드로이드 스튜디오에서 프로젝트를 생성할 때, Compose 기반의 Em..

CameraX는 Jetpack 라이브러리 중 하나로, 카메라 앱을 더욱 쉽게 개발할 수 있도록 설계되었습니다. 새로운 앱에 카메라 기능을 추가할 계획이시라면 CameraX를 활용하는 것이 좋습니다. CameraX는 대부분의 Android 기기에서 잘 작동하며, Android 5.0(API 레벨 21)까지도 호환되어 호환성 문제를 줄여줍니다. 또한, 일관성 있고 사용이 쉬운 API를 제공해 개발 효율성을 높입니다.이번 포스팅에서는 CameraX 아키텍처와 Compose로 구현된 앱에서 어떤 식으로 활용할 수 있는지 알아보겠습니다.  Camera 아키텍처 CameraX를 사용하면 추상화 UseCase를 통해 장치의 카메라와 연결할 수 있습니다. 대표적으로 아래 4가지 Usecase를 활용할 수 있습니다.Pr..