Claude Code와 BMAD 방법론으로 2개월 만에 모바일 앱, 마케팅 사이트, 홍보 영상까지 혼자서 출시한 후기

나는 클라우드 엔지니어임. 모바일 앱을 출시해본 적도, React Native를 써본 적도, Astro나 Remotion을 써본 적도 없었음. 2개월 후, 나는 Veil이라는 프라이버시 중심의 생리 주기 추적 앱을 프로덕션 환경에서 운영하게 되었음. 이 앱은 건강 데이터가 기기에만 머무는(계정이나 클라우드 없음) 프라이버시 중심의 앱임. 사람들이 자신의 가장 내밀한 건강 기록을 기본적으로 앱과 기업에 넘겨주는 경우가 너무 많아서 이 앱을 만들었음. 오늘날의 스마트폰은 그 데이터를 로컬에서, 비공개로, 기기 내에서 처리할 수 있음. iOS는 출시되었고, 안드로이드는 진행 중임. 9개 언어를 지원함.

레버리지는 단순히 프롬프팅이 아니라 Claude Code를 어떻게 사용했느냐에서 나왔음. 대부분의 "AI로 X를 만들었다"는 글들은 워크플로우를 생략하기 때문에 공유할 가치가 있다고 생각함.

내가 실제로 한 일

1. 기획을 위한 BMAD 방법론

Breakthrough Method of Agile AI-Driven Development(애자일 AI 주도 개발을 위한 돌파구 방법론). 적절한 PRD, 스프린트 계획, 스토리 생성 및 회고를 위한 구조화된 워크플로우임. "앱을 만들어줘"라는 요청보다는 "우리가 무엇을 만드는지 실제로 생각해보자"는 방식에 훨씬 가까움. 또한 스파게티 코드를 피하는 데 획기적인 변화를 가져왔음.

_bmad-output/에 출력되는 결과물: 제품 브리프, PRD, 아키텍처 문서, 에픽, 스토리 파일. 새로운 세션은 항상 이것들로부터 시작함.

2. CLAUDE.md + 리포지토리 문서를 통한 영구적인 기억

CLAUDE.md는 항상 켜져 있는 레이어임. 리포지토리 루트에 있는 단일 파일로, 모든 새로운 세션이 이를 로드함. 내 파일은 약 1500줄이며 유기적으로 성장했음. 각 섹션은 내가 두 번 이상 다시 설명해야 했던 것들로 시작함.

구조화 방식(코드베이스의 덤프가 아니라 미래 세션을 위한 계약서임):

• 프로젝트 개요 + 스택: 콜드 스타트 시 Expo/RN 버전을 환각하지 않도록 함
• 아키텍처: "여기서 가져오고 절대 중복하지 말 것" 규칙이 포함된 데이터 흐름, 스토어, 예측 파이프라인
• 컨벤션: 무시하면 문제가 되는 규칙들(Zustand 셀렉터, useTheme() 색상, 9개 로케일 i18n, ISO 날짜 + DST 안전한 addDays)
• 사용자가 틀렸을 때 반박하기: 나쁜 아이디어를 구현하기 전에 한 번 논쟁하고, 그 후 내가 선택한 대로 하라는 명시적 지시
• 의학적 정확성: 코딩 전 연구: 전체 워크플로우: 1차 출처 우선(ACOG/FIGO/WHO/DSM-5-TR), 코드 문서 블록에 인용, HEALTH_FEATURES_PLAN.md에 기록, 임계값을 선택하기 전에 의견 불일치 플래그 지정, 그럴듯한 숫자를 절대 지어내지 않음
• 더 깊은 문서로의 포인터: Claude가 로드 베어링 코드를 건드리기 전에 올바른 파일을 읽도록 함
• 체크리스트: "새 기능 추가"에 연결됨(내보내기, 복원, PDF, 게이팅 문서, 웹사이트)

CLAUDE.md는 인덱스임. 3개의 docs/ 파일은 중복되거나 오래될 수 있는 세부 정보를 담고 있음:

• docs/algorithm-decisions.md - 예측/파괴적 로직이 작동하는 이유: 영향을 받는 표면, 거부된 대안, "이것을 건드리면 안 됨" 등. 변경 로그가 아님. 예시 항목: 버퍼링된 예측 창 끝 vs 실제 예측된 생리 시작(사용자에게 보이는 버그로 "수정"하기 쉬움).