- 패키지를 6개로 나눠도 경계는 린트가 지킨다 Flutter 앱을 app·presenter·usecase·network·local_storage·entity 6개 패키지로 나눈 구조를 실측 수치로 그려 보고, 나눠서 얻은 것과 치른 비용을 정리한 시리즈 첫 글이에요.
- 계층의 경계는 타입이 바뀌는 자리였다 — 토글 하나를 서버까지 따라가 보기 이메일 수신 토글 하나가 화면에서 서버까지 갔다 돌아오는 길을 실제 코드로 따라가며, 계층마다 무엇을 알고 무엇을 모르는지, 에러가 어디서 모양을 바꾸는지 정리한 시리즈 두 번째 글이에요.
- 실패를 값으로 바꾸자, 던져진 실패가 숨기 시작했다 Flutter 앱에서 실패를 예외 대신 Result 값으로 넘기기로 한 설계와 ResultChain 의 실제 동작, 그리고 onFailure 와 onCatch 사이로 실패가 새어 나간 사례를 코드와 실측으로 정리한 시리즈 3편이에요.
- emit 했는데 화면이 그대로인 이유 — 이벤트와 화면 사이의 다섯 칸 Flutter 앱에서 BLoC 을 ViewModel 로 쓰면서 상태·이벤트·사이드 이펙트를 나눈 방식과, 화면이 반응하지 않던 함정 다섯 가지를 실제 사례로 정리한 시리즈 4편이에요.
- 구조는 사람보다 AI 가 더 문자 그대로 읽는다 — DI·라우팅·테스트 편 문서와 달리 손으로 등록하던 DI, navigator 가 셋인 go_router 의 함정, 패키지를 따라 나뉜 테스트를 보고, 6개 패키지 구조가 AI 에이전트와 일할 때 무엇을 돕고 무엇을 막았는지로 시리즈를 닫아요.
- 일의 단위가 바뀌면 질문도 바뀐다 — 화면 하나에서 에픽 하나로, Flutter 1년 3개월 티켓 번호대로 화면을 하나씩 만들던 사람이 앱·서버·네이티브를 함께 설계하는 에픽을 맡기까지를, 분기마다 사건 하나씩 골라 돌아본 회고예요.
- AI 에게 규칙은 쓰는 것보다 읽히는 게 어렵다 — 12KB 규칙 예산과 리뷰 스킬 리뷰 봇이 막힌 PR 을 대신 리뷰하는 스킬과, AI 코딩 에이전트가 매 세션 읽는 규칙 문서를 예산 안에 두는 구조를 만들어 온 기록이에요.
- 기준 없이 AI 와 1년, 연타 방지 코드가 270가지가 됐다 AI 와 함께 리뷰 없이 빠르게 쌓은 Flutter 코드를 처음으로 직접 읽고, 다시 AI 와 함께 BLoC 이벤트 겹침 처리를 정리한 기록이에요.
- AI 가 읽는 화면은 픽셀이 아니라 접근성 트리였다 — WDA 와 Semantics ID 로 만든 실기기 QA Flutter 앱을 실기기 iPhone 에서 AI 에이전트가 직접 조작하게 만들고, 접근성 트리에 ID 를 붙여 비용을 줄이고, 40ms 간격 연타까지 재현한 기록이에요.
- CocoaPods 를 떠나고서야 보였다, 그가 대신 해 주던 일들 Flutter 앱의 iOS 의존성을 CocoaPods 에서 Swift Package Manager 로 옮기면서, CocoaPods 가 조용히 대신 해 주던 일들이 하나씩 드러난 기록이에요.
- 크래시 0건은 측정값이 아니었다 — 실패를 삼킨 dSYM 업로드 한 줄 CocoaPods 에서 SPM 으로 옮긴 뒤 Crashlytics 에 iOS 크래시가 한 건도 잡히지 않았어요. 조용히 실패하던 빌드 단계 하나를 찾아간 기록이에요.
- 유리를 흉내 내는 대신 진짜 유리를 가져왔다 — Flutter 앱에 UITabBar 한 장만 붙이기 Flutter 로 흉내 내던 유리 탭바를 iOS 26 시스템 UITabBar 로 바꿨어요. 화면은 Flutter 에 두고 탭바 한 장만 PlatformView 로 띄우면서 겪은 제스처 경쟁, 선택 어긋남, 시스템 배지를 버린 이유를 정리했어요.
- SDK 비용 대신 1픽셀과 싸웠다 — 초대 코드를 서버에서 직접 이어 붙인 디퍼드 딥링크 친구 초대 링크로 앱을 설치한 사람을 첫 실행 때 초대자와 연결하려고, Android 는 Play Install Referrer 로, iOS 는 기기 신호 매칭으로 디퍼드 딥링크를 직접 만든 판단 과정과 그 대가를 정리했어요.
- 띄우는 일과 바꾸는 일은 달랐다 — 앱이 잠든 동안 Live Activity 를 서버가 갱신하기 앱 안에서만 갱신하던 루틴 Live Activity 가 앱이 잠든 동안 멈췄어요. 서버가 push-to-start 로 배너를 띄우는 구조로 바꿨다가, 결국 하루 한 개의 배너를 update 로 돌리는 구조에 도착한 기록이에요.
- 로딩 23번을 2번으로, 기다림을 없앤 게 아니라 옮겼다 온보딩 설문에서 답할 때마다 서버 응답을 기다리던 구조를, 답변을 백그라운드 직렬 큐로 보내고 꼭 필요한 두 곳에서만 기다리도록 바꾼 구현기예요.