본문으로 건너뛰기

Claude SDK로 만든 개발 시스템 첫 mvpgen

이지영

2026.10.14

Claude SDK로 만든 개발 시스템 첫 mvpgen 본문 이미지

지난주에는 Claude 플러그인으로 MVP를 만들며 하네스와 루프의 감을 잡았습니다.

2주차로 시스템(mvpgen)은 Claude Agent SDK로 1차로 만들고, 첫 앱 mvp 를 만들어봤습니다. 한번에 될리 당연히 없으나 데이터를 가져와 보여주는 것은 잘 구성이 되었습니다. 그 과정을 앞으로 조금더 상세히 들여다 볼 예정입니다. 데이터의 정기 수집·적재 등은 아직 과정에 있습니다.

과정에 대한 사례글은 간단히 3가지만 보겠습니다.
① MVP를 자동으로 만드는 시스템 mvpgen
② 그 시스템으로 만든 첫 '전시 추천' 앱
③ 그 앱의 데이터 가져오기

1. 순서는 코드가 정하고, 검증은 세 겹으로

mvpgen은 아이디어 한 줄에서 Plan, Plan critic, Build, Build critic, 최종 검증을 거쳐 MVP 폴더까지 만듭니다. 핵심 결정은 하나입니다. 단계 순서를 LLM이 아니라 파이썬 코드가 정합니다. 그래서 어느 단계에서 무엇이 실패했는지 추적할 수 있습니다.

mvpgen 은 Claude Agent SDK로 만들었어요. 아주 간단합니다. 이미 설계된 템플릿을 따라 만들어지기 때문에 LLM에게 단계를 자세히 말하지 않아도 됩니다. mvpgen의 핵심은 Python 코드가 오케스트레이터로 Plan·Build·Critic 단계의 순서와 검증을 결정합니다.

검증은 세 겹

세션 안의 Stop hook은 종료하려 할 때 설치·테스트·실행 검사를 돌려 실패하면 못 끝나게 막습니다.
별도 세션의 독립 critic은 맥락 없이 루브릭으로 채점,
lessons.md는 지적을 다음 실행 프롬프트로 전달합니다.

한국어 웹사이트 스크린샷


실제로 GitHub Actions에서 다섯 번 돌려 네 번 끝까지 성공 (한 번은 크레딧 부족으로 중단, 비용 0).
다만, 역시나 critic 불합격 0회, Stop hook 차단도 0회

제품 가격을 보여주는 한국 웹사이트의 스크린샷


즉 스스로 고치는 개정 루프는 오프라인 테스트로만 작동(너 그럴 줄 알았어) 실제 실행에서 작동안함, 하네스가 엉성한거죠 ^^

2부. test 앱 전시추천 '오늘 뭐하지' — 테스트는 통과했지만 실제는 뻥인듯

한국어 숫자가 적힌 화면

실제 시스템 작동 확인은 '오늘 서울 전시를 추천하는 앱' 으로 시도했어요.
외부에서 데이터를 가져와야 해서 참고 자료(수집 CSV 샘플, MMCA API 문서, 기타 크롤러)를 제공, 그러자 기획이 실제 CSV 컬럼과 API 필드를 그대로 따랐고, 앱 실행 중에는 크롤링하지 않도록 설계됐습니다.

마지막으로 사람이 안봐도 화면이 잘못된걸 알아낸다
설치·테스트·실행·critic 평가까지 자동 검사는 모두 통과, BUT
휴대폰 폭을 넘어가는 에서 상단 설명·새로고침 버튼·리뷰 표등이 넘어갔는데 이걸 알아서 발견하고 수정시도해야 한다고 하더군요. 저는 그렇다길래 그제서야 무슨 상황인지 들야다 봤습니다.

그래서 이게 어느 과정에서 그렇게 된건지 따져보니 제가 "끝나면 스크린샷 찍어서 보여줘' 라고 했는데 그래서 스크린샷을 찍었는데 그걸 claude 가 확인한 거였습니다.

3부. 데이터 가져오기

외부 데이터 확보를 어떻게 할 것인가가 가장 중요한데,

전시 추천 앱의 데이터는 1차로 공공 API(국립현대미술관 전시, 문화데이터광장), 2차로 공공 API가 제공하지 않는 미술관과 상업갤러리 전시(사이트 19곳을 직접 읽어야 함)입니다.

테스트모드에서는 우선 1차가 잘 되는지 보고 싶어 2차는 따로 크롤링해서 CSV파일을 제공했습니다.

과정에서 데이터전처리 규칙을 정하기 위한 과정은 참 귀찮은데, 간단히 진행했습니다.

분류 필드가 어떻고 ~
가져와 보니 제목이 조금씩 다르고~
기타 등등

정기 수집은 Mac이 잠들면 회차를 건너뛰는 문제를 피해 GitHub Actions로 권장하는대로 진행했지만, Supabase 의 기능을 이용할 생각입니다.

결론적으로

  • mvpgen 은 폐기합니다.

기타로 새로 알게 된것은 인증에서 Workload Identity Federation(API 키 없음)라는게 있다는것, 이걸 또 해보겠다고 여기서 1시간

추가로 ,, claude code, claude sdk 가 각각 어떤 역할 분담을 하는지 알고자

한국어 페이지 스크린샷

하나씩 까보는 재미, 한글로 작성된 prompts.py 맘에 듭니다.

컴퓨터에 있는 한국어 스크린샷
2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

댕댕이멍멍 프로필 이미지
댕댕이멍멍2026.10.14

mvpgen은 폐기인가요? 😭
이번 경험을 바탕으로 더 완성도 높은 하네스로 발전하는 모습 기대하겠습니다.

이지영 프로필 이미지
이지영2026.10.14

아...그래야겠죠 ^^::::

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기