KO/EN
← 글 목록으로

기획이 자주 바뀌는 서비스에서 버티는 구조

읽는 시간 14분

중간에 투입된 용병

MyCREAM은 실존 인플루언서를 캐스팅해서 대화와 선택으로 참여하는 AI 인터랙티브 콘텐츠 플랫폼이다. 나는 처음부터 있던 사람이 아니라, 서비스가 한창 개발되던 중에 용병으로 투입됐다. 기간은 2026년 7월 중순부터 10월 말까지.

들어가서 처음 본 코드베이스는 앱 8개, 패키지 12개짜리 모노레포였다. 사람이 처음부터 읽으면서 파악할 수 있는 크기가 아니었다.

그래서 시작이 좀 특이했다. 개발팀장이 들어가자마자 Codex를 세팅해서 프로젝트 전체를 파악하게 했고, 나는 세팅한 첫날부터 바로 필요한 기능 작업에 들어갔다. 코드를 다 이해하고 나서 일하는 게 아니라, 에이전트가 파악한 걸 바탕으로 일하면서 이해해 나가는 방식이었다.

기획이 바뀌는 속도

이 서비스는 매주 3번 회의를 했다. 기획팀과 마케팅팀이 가져온 지표를 보고 서비스 방향을 정하고, 개발은 거기에 맞춰 바로 움직였다.

판단 기준은 꽤 명확했다.

  • 유저 리텐션이 나오는 곳은 어디인가
  • 결제가 일어나는 흐름은 어디인가

그리고 많이 쓰이는 곳의 기능을 더 강화한다. 회의에서 방향이 정해지면 티켓이 나오고, 티켓이 나오면 개발자가 바로 처리한다.

이런 환경에서는 "이번 기획에 딱 맞게" 만든 코드가 다음 주에 걸림돌이 되기 쉽다. 그래서 내가 맡은 영역에서는 다음 기획 변경이 와도 갈아엎지 않고 버틸 수 있는 구조를 만드는 게 핵심이었다.

미디어를 공용 서비스로 떼어내기

내가 가장 크게 손댄 건 미디어(사진·영상)였다. 인플루언서가 나오는 서비스라 미디어가 곧 가장 중요한 콘텐츠다.

문제는 개발 환경이나 스테이징에서 실제 데이터로 테스트하기가 어렵다는 거였다. 로컬과 스테이징에는 실제 미디어가 없거나 일부만 있어서, 화면이 실제로 어떻게 보일지, 추천이나 노출 로직이 제대로 도는지 확인하려면 운영 데이터를 따로 복사해 와야 했다. 환경마다 미디어를 따로 관리하는 셈이다.

그래서 미디어를 아예 독립된 서비스로 떼어냈다.

  • 미디어 서비스는 자기 DB를 따로 가진다.
  • 프로덕션, 스테이징, 로컬이 모두 같은 미디어 서비스를 쓴다.
  • 각 환경은 자기 앱 DB를 그대로 갖고, 자기 환경의 인플루언서 ID를 공용 미디어 쪽 인물에 연결만 한다.
  • 개발자마다 연결 공간이 분리되어 있어서, 여러 명이 로컬에서 각자 연결해도 서로 덮어쓰지 않는다.

이렇게 하니 로컬에서 개발할 때도 운영과 똑같은 사진·영상을 보면서 작업할 수 있게 됐다. 미디어를 복사하거나 환경끼리 맞추는 작업 자체가 사라졌다.

바뀌는 것과 안 바뀌는 것 나누기

미디어를 떼어낼 때 가장 신경 쓴 건 책임의 경계였다.

  • 미디어 서비스: "이 사진이 어떤 사진인가"만 책임진다. 수집, 분류, 라벨, 공개 상태 같은 사실 정보다.
  • 앱: "어떤 사진을 어디에 쓸 것인가"를 책임진다. 창작자가 정한 규칙과, 그 규칙에 맞는 사진을 연결하는 부분이다.

사진이 들어오면 미디어 서비스가 알아서 처리한다. 사람이 주인공인 사진인지 AI가 판별하고, 상황·옷차림·장소 같은 라벨을 붙이고, 조건을 만족하면 채팅에 쓸 수 있는 상태로 공개한다. 앱은 이 라벨을 보고 자기 규칙에 맞는 사진을 고르기만 한다.

이렇게 나눈 이유는 간단하다. 기획이 바뀌면 바뀌는 건 대부분 "어디에 어떻게 쓸까" 쪽이다. "이 사진이 어떤 사진인가"는 기획이 바뀌어도 잘 안 바뀐다. 자주 바뀌는 쪽과 안 바뀌는 쪽을 섞어 두면, 바뀔 때마다 안 바뀌어도 될 부분까지 같이 흔들린다.

실제로 이 구조는 몇 번의 방향 전환을 버텼다.

  • 7월: 사진을 중심으로 미디어 플랫폼을 처음 만들었다.
  • 9월: 인플루언서 사진 도감 기능이 새로 들어왔다. 미디어 쪽은 그대로 두고, 도감 전용 조회 경로만 추가했다.
  • 10월: 영상이 들어오고, 잠긴 영상을 해금하는 결제 흐름이 붙었다. 미디어 서비스에 영상 업로드와 재생을 추가하는 확장으로 끝났고, 해금 정책과 화면은 앱 쪽에서 처리했다.

새 기능이 들어올 때마다 미디어 구조를 다시 짠 적은 없다. 확장만 했다.

공용이라서 생기는 문제 — 버전이 엇갈릴 때

물론 공용 서비스라서 생기는 대가도 있었다. 스테이징과 프로덕션은 같은 미디어 서비스를 부르는데, 두 환경의 앱 버전이 항상 같지는 않다. 스테이징에는 새 기능이 먼저 올라가 있고, 프로덕션은 아직 이전 버전인 기간이 늘 생긴다.

이때 미디어 서비스를 새 기능에 맞춰 바꿔버리면, 스테이징은 잘 되는데 프로덕션의 미디어 호출이 터진다. 실제로 버전이 엇갈리는 타이밍에 미디어 API 호출에서 문제가 나는 일이 종종 있었다.

그래서 미디어를 확장할 때는 프로덕션에 영향이 없는지를 가장 먼저 봤다. 기존 호출 방식은 그대로 두고, 새 기능에 필요한 건 새 경로나 새 필드로 덧붙이는 식이다. 사진 도감 때 기존 조회를 고치지 않고 도감 전용 조회 경로를 따로 만든 것도 같은 이유다. 공용 서비스는 "내가 지금 보는 환경"이 아니라 지금 이 서비스를 부르고 있는 모든 버전을 기준으로 바꿔야 한다.

AI 코딩 에이전트 중심 개발

구현은 거의 Codex로 했다. 사람이 다 읽을 수 없는 크기의 코드베이스에, 일주일에 세 번씩 방향이 바뀌는 속도. 이 조건에서는 에이전트가 코드를 파악하고 짜고, 사람은 방향과 경계를 잡는 방식이 가장 잘 맞았다. 사람이 전부 읽고 짜는 방식이었다면 코드를 파악하는 사이에 기획이 이미 바뀌어 있었을 거다.

대신 에이전트가 아무렇게나 짜지 않도록 규칙을 문서로 박아뒀다. 저장소 루트에 AGENTS.md라는 에이전트용 가이드가 있고, 팀이 같이 썼다. 기억에 남는 원칙 몇 개를 옮기면 이렇다.

  • 임시 패치보다 구조적으로 완결된 해결을 우선한다.
  • 근본 원인을 고치고, 문제를 가리는 방어 코드는 함부로 넣지 않는다.
  • 새로 만들기 전에 기존 코드, 패턴, 헬퍼부터 재사용한다.
  • 중복이 보이면 공통 모듈로 뽑되, 섣부른 추상화는 하지 않는다.
  • 문서와 코드가 다르면 코드를 확인하고 문서를 고친다.

작업 흐름도 규칙으로 정해져 있었다. 티켓 하나마다 짧게 사는 브랜치를 따고, 작업이 끝나면 PR을 올리고, CI 검증을 통과해야 머지한다. 머지되면 스테이징에 자동 배포되고, 프로덕션은 승인을 거쳐서 나간다.

이 구조 안에서 내 역할은 코드를 한 줄 한 줄 짜는 것보다 어디에 무엇을 둘지 정하고, 에이전트가 그 경계를 지켰는지 확인하는 것에 가까웠다. 그리고 이 확인이 제일 중요했다.

Codex도 가끔 멍청해질 때가 있다. 기획 의도와 다르게 기능을 만들거나, 이번 작업과 상관없는 엉뚱한 곳을 건드리는 경우가 간혹 있었다. 코드만 보면 그럴듯하고 테스트도 통과하니까, 의도와 범위를 아는 사람이 보지 않으면 그대로 들어간다. 그래서 PR을 볼 때는 "코드가 맞나"보다 기획 의도대로 만들었나, 건드리면 안 되는 곳을 건드리지 않았나를 먼저 봤다.

그렇게 3개월 반 동안 150개가 넘는 PR을 냈다.

잘된 점과 아쉬운 점

잘된 점

  • 미디어 경계를 먼저 그은 것. 사진 도감, 영상, 해금 결제까지 큰 기능이 연달아 들어왔지만 미디어 쪽은 확장만으로 버텼다.
  • 실제 데이터로 개발할 수 있게 된 것. 운영과 같은 미디어로 로컬에서 바로 확인하니까, "스테이징에선 됐는데 운영에선 이상하다" 같은 일이 줄었다.
  • 첫날부터 기여할 수 있었던 것. 코드 파악을 에이전트에 맡기고 규칙을 문서로 정해두니, 중간 투입인데도 적응 기간 없이 바로 기능을 낼 수 있었다.

아쉬운 점

  • 빠른 만큼 기존 동작이 깨지는 일도 있었다. 새 기능을 붙이다가 하단 시트 드래그나 잠긴 영상 카드 표시처럼 원래 잘 되던 게 깨져서, 나중에 "복구" 작업을 따로 해야 했던 적이 몇 번 있다. 에이전트가 빠르게 짤수록 회귀 테스트가 더 중요해진다.
  • 공용 미디어의 버전 문제를 더 일찍 막았으면. 스테이징과 프로덕션 버전이 엇갈릴 때 미디어 호출이 터지는 일을 몇 번 겪고 나서야 "프로덕션 영향 먼저 확인"이 습관이 됐다. 처음부터 하위 호환을 확인하는 장치를 두었다면 덜 고생했을 거다.

기획이 자주 바뀌는 서비스에서 버티는 방법은 결국 두 가지였다. 자주 바뀌는 것과 안 바뀌는 것을 떼어놓고, 빠르게 짜되 규칙 안에서 짜게 하는 것.