본문으로 건너뛰기

클로드 코드, 하네스 구조를 활용하여 실제로 MVP 도전해보기1

상상러

2026.10.07

클로드 코드, 하네스 구조를 활용하여 실제로 MVP 도전해보기1 본문 이미지

소개

클로드 코드, 하네스 구조를 활용하여 실제로 MVP 도전해보기1

1. 소개: 무엇을, 왜 만들었나요?

스터디 목표: 팔 수 있는 MVP

저는 이번 스터디에서 누군가에게 돈이 되는 것을 만들고 싶었어요. 후보는 세 개였어요.

후보

돈 내는 사람

판단

유튜브 주제·제목 분석기

유튜브 하는 1인 크리에이터

✅ 선택

가게 홍보 쇼츠 자동 제작

식당·학원 사장님

다음 단계로 (영업이 어려움)

일정·계획 관리

개인

보류 (무료 앱이 너무 많음)

분석기를 고른 이유는 세 가지예요.

  1. 이미 돈을 받고 파는 도구들이 있어요. 해외 도구(1of10, AI 제목·아이디어 기능이 든 요금제 월 $69)나 국내 도구(뷰트랩)가 있다는 건 사는 사람이 있다는 뜻이에요.

  2. 그런데 한국어 제목을 숫자로 분석하고, 근거 영상까지 붙여 주는 리포트는 드물어요.

  3. 저는 예전에 유튜브 채널을 손으로 분석해 본 적이 있어요. 그걸 기계가 하게 만들면 돼요.

한 줄 요약

유튜브 키워드 하나를 넣으면 잘 된 영상들의 제목 공식과 새로 만들 주제 10개를 찾아 주는 도구 '주제 레이더'를 만들었어요. 만드는 것보다 "AI가 틀린 말을 못 하게 감싸는 장치(하네스)" 를 만들면서 더 많이 배웠어요.

이런 분께 도움돼요

  • '하네스'가 무슨 말인지 아직 감이 잘 안 오는 분

  • AI가 "다 했어요!" 하면 그냥 믿었던 분

  • hook을 만들었는데, 진짜로 막는지는 확인해 본 적 없는 분

  • 유튜브 주제 고르기가 막막한 분

진행 방법

만들기 전에 먼저 읽었어요

다빈치리 님 글에서 배운 "매뉴얼부터 읽어라"를 따라 했어요. 1주차 스터디 글 17편을 먼저 읽고, 겹치는 교훈 4가지를 뽑았어요.

  • 완료 보고를 그대로 믿지 않기

  • 만드는 쪽과 검사하는 쪽을 나누기

  • 규칙은 부탁(문서)이 아니라 강제(hook·코드 검사)로 올리기

  • 진행 상태는 정해진 모양의 파일로 관리하기

이걸 처음부터 설계에 넣었어요.

어떤 도구를 사용했고, 어떻게 활용하셨나요?

Tip: 우선 스터디 정보를 클로드 코드에게 건내줍니다.

https://www.gpters.org/ai-study-list/post/jigjangin-gaebalja-saideupeurojegteureoreul-wihan-4jumane-claude-code-uYT2LMsye7ROqSw

Tip: 오퍼스 5.5 / BYPASS PERMISSION 모드로 안티그래비티에서 작업을 했습니다.

Tip: 이번주 스터디 게시글을 AI 에게 학습시키고 인사이트를 얻어냅니다.

대략 17개의 스터디 링크를 얻어내어 AI 에게 무슨 핵심 인사이트가 있는지 얻어내었습니다.

그 다음 그 학습 결과를 바탕으로 실질적인 MVP 3종을 추천해달라고 했고, 그 중 저의 관심사와 매칭 되는 아래 프로젝트를 진행하게 되었습니다.

실질적인 구매력이 생길만한 MVP 3종을 추천 받았고 결과는 다음과 같습니다.

가장 중요한 것은 내가 진행하고자 하는 스터디의 배경에 대해서 AI 에게 건냈고 그 맥락 안에서 개발을 해나간다는 점입니다.

세 아이디어 비교

A. 유튜브 주제·제목 분석기

B. 매장용 쇼츠 자동 제작

C. 일정·계획 관리

돈 내는 사람

유튜브 부업러·1인 크리에이터

식당·학원·미용실 사장님

개인

그 사람이 버는 돈

조회수 → 수익화 (간접)

방문·예약 → 매출 (직접)

시간 절약 (돈으로 증명이 어려움)

이미 팔리는 근거

1of10 Pro 월 $69 (AI 제목·아이디어), 뷰트랩 월 6만원~, 크몽 채널 최적화 평균 3만원대

크몽 매장 쇼츠 월 8편 40만원, 12편 55만원

Notion·TickTick 같은 무료 강자가 많음

이미 가진 것

yt-ref-search·yt-analyze 스킬, 채널 벤치마크 실측 2건

virtue_shorts_app 파이프라인

체크리스트 앱 1차 완성

3주 안에 MVP

◎ 데이터 → 리포트, 영업 없이 시험 가능

△ 매장 섭외와 수정 요청이 병목

○ 만들 순 있지만 팔 곳이 약함

가장 큰 위험

해외 툴과 경쟁, 효과가 간접적

영업, 사장님의 품질 기대치

결제로 이어지기 어려움

그 중에 저는 첫번째가 마음에 들었고

AI가 학습한 것과 저의 요청사항을 바탕으로 MVP를 개발해나가고 있습니다.

# A 를 해보는 걸로 하고 하네스 구조를 고려해서 적용해보자 
# 추후 초등학생들도 이해하기 쉽게 주석과 설명을 달아주었으면 해 
# 자막 수집은 가능할꺼야 이 프로젝트를 참고해봐 
# 그리고 실시간 검색어, 구글 SEO 등 뭔가 지금 이슈가 될만한 것들로 키워드를 잡아서 하는 것도 추가해주었으면 해

특별히 요청한 것은 하네스 구조를 적용했다는 점이었습니다.

주제 레이더가 하는 일

요리 순서랑 비슷해요.

순서

요리

주제 레이더

1

🛒 오늘 뭐가 맛있을까

지금 뜨는 말 찾기 (구글 급상승 검색어, 유튜브 자동완성)

2

🥕 재료 사 오기

영상 40편 모으기 (조회수순 + 최신순)

3

🔪 재료 손질

잘 터진 영상부터 자막 받기

4

⚖️ 저울로 재기

숫자 계산 (계산기 프로그램만 숫자를 만들어요)

5

👩‍🍳 요리하기

AI가 제목 공식과 새 주제 제안서 쓰기

6

🧐 까다로운 손님

깐깐한 짝꿍 AI가 제안서 반박하기

7

😋 맛보기 검사

채점기가 규칙대로 채점하기

8

🍽️ 그릇에 담기

채점을 통과해야만 리포트 만들기

사용한 도구

도구

한 일

Claude Code

설계, 코드, 테스트, 실행 전부. 저는 방향을 정하고 갈림길에서 골랐어요

yt-dlp, youtube-transcript-api

유튜브 영상 정보와 자막 받기

구글 트렌드 RSS, 자동완성

지금 뜨는 말, 사람들이 실제로 치는 검색어

파이썬 기본 기능만

숫자 계산과 채점 (인터넷 없이 테스트할 수 있게)

PySide6

스터디원에게 보여 줄 화면판

하네스 설계: 학교에 비유하면

1주차 개발자F 님 강의에서 하네스를 두 가지로 나눴어요.

  • 부탁 (추론적 센서): AI가 읽고 따르는 규칙. 예) CLAUDE.md

  • 강제 (연산적 센서): 프로그램이 기계적으로 막는 장치. 예) hook, 테스트

저는 이렇게 만들었어요.

장치

학교로 치면

하는 일

🚧 문지기 hook

정문 지킴이 선생님

비밀 파일(.env)과 원자료를 건드리면 막고, "대신 저쪽 문으로 가세요" 하고 바른 길을 알려 줘요

🔁 바로 채점 hook

한 줄 쓸 때마다 채점해 주는 선생님

코드를 고치면 테스트, 제안서를 고치면 채점

🏁 검문소 hook

시험지 내기 전 확인

검사 도장이 없으면 "다 했어요"를 못 하게 해요

🧐 반박 리뷰어

깐깐한 짝꿍

읽기만 할 수 있는 AI. 칭찬은 안 하고 틀린 곳만 찾아요

📜 HUMAN.md

우리 반 약속판

사람이 직접 쓴 목표와 규칙. AI는 따르기만 해요

결과와 배운 점

하네스 구조의 장점에 대해서 배울 수 있었습니다.

하네스 구조를 통하면 개발을 안전하게 할 수 있다는 점을 알았습니다.

숫자는 계산기에게, 글은 AI에게: 유튜브 주제 분석기를 하네스로 만들며 배운 7가지

배운 점 1. 숫자는 계산기에게, 글은 AI에게

AI는 글을 잘 써요. 그런데 숫자를 옮겨 적다가 틀릴 때가 있어요. 리포트 숫자가 하나라도 틀리면 아무도 그 리포트를 믿지 않아요.

그래서 AI는 숫자를 직접 못 쓰게 했어요. 대신 빈칸만 써요.

AI가 쓴 글:   잘 된 영상의 {{stat:patterns.number.top_share}}가 제목에 숫자를 썼어요.
리포트:       잘 된 영상의 50.0%가 제목에 숫자를 썼어요.

빈칸은 리포트를 만들 때 계산기 프로그램이 채워요. 채점기는 AI 문장에 숫자가 그냥 들어 있으면 "숫자는 빈칸으로 쓰세요"라고 돌려보내요.

재밌는 일: 채점기가 'S&P500'이라는 상품 이름 속 숫자까지 잡았어요. 규칙을 느슨하게 하지 않고 문장을 바꿨어요. 그리고 "이름 속 숫자도 잡는다"는 한계를 적어 뒀어요.

배운 점 2. "실행됐다"와 "확인했다"는 달라요

영상 40편을 모았어요. 실패 0개, 진행표에는 '완료'가 떴어요.

그런데 숫자를 보니 40편 모두 구독자 수가 비어 있었어요.

원인은 '한국어 제목' 설정이었어요. 이 설정을 켜면 구독자 수가 "구독자 273만명"처럼 글자로 와서, 프로그램이 숫자로 읽지 못했어요. 프로그램은 일을 했지만, 필요한 걸 확인하지는 못한 거예요.

바꾼 것: 구독자 수를 한 편도 못 읽으면 '완료' 대신 '부분'으로 적어요.

배운 점 3. 고쳐도 옛날 자료가 남아 있으면 또 틀려요

설정을 고쳤는데도 4편은 계속 비어 있었어요. 고장 났을 때 저장해 둔 옛날 자료(캐시)를 그대로 쓰고 있었거든요.

바꾼 것: 저장하는 자료마다 "몇 번째 판인지" 번호를 붙였어요. 옛날 판이면 다시 받아요. 우유에 붙은 유통기한 스티커 같은 거예요.

배운 점 4. 진행표도 거짓말을 해요

영상을 새로 모았는데, 진행표에는 '3. 숫자 계산: 완료'가 그대로 남아 있었어요. 재료를 새로 사 왔는데 "계량 끝!"이라고 적혀 있는 셈이에요.

바꾼 것: 앞 단계를 다시 하면 뒤 단계는 모두 '미실행'으로 되돌려요.

배운 점 5. 깐깐한 짝꿍은 진짜 일을 해요. 하지만 그대로 믿지는 않아요

제안서를 쓴 뒤, 읽기만 할 수 있는 AI에게 "승인하지 말고 빈틈만 찾아"라고 시켰어요. 1주차 강의 내용(리뷰어에게는 승인이 아니라 반박을 맡긴다)을 그대로 해 본 거예요.

18개를 찾았고, 그중 중요한 것이 4개였어요.

제가 쓴 말

짝꿍이 찾은 사실

"60대 버전 영상은 검색되지 않았어요"

모아 둔 자료 안에 이미 있었어요

"61자 넘는 긴 제목은 성적이 낮아요"

그 구간에 구독자 수백만 명인 방송사 채널이 몰려 있었어요. 제목 길이 탓이 아닐 수 있어요

"이 주제가 잘 됐어요"

조회수에 비해 좋아요 0.4%, 댓글 2개. 광고로 올린 조회수일 수도 있어요

"퇴직금을 어느 계좌에 먼저 넣을까"

퇴직금은 보통 정해진 계좌(IRP)로 들어가요. 틀린 정보가 될 뻔했어요

저는 짝꿍 말도 그대로 믿지 않았어요. 원자료를 직접 열어서 5개를 확인했는데, 모두 맞았어요. (자잘한 숫자 하나만 달랐어요.)

가장 놀란 건 이거예요. 짝꿍이 "나이 규칙이 '55세'를 못 잡는다"고 해서 규칙 한 줄을 고쳤더니, 잘 된 영상 중 나이를 쓴 비율이 10%에서 30%로 바뀌었어요. 규칙 하나가 결론을 바꿔요. 그래서 이제 테스트로 지켜요.

배운 점 6. hook 시험은 3단계예요 (AI머슬 님 글에서 배웠어요)

  1. hook을 설치했다

  2. hook을 직접 불러서 시험했다

  3. 진짜 AI 작업 중에 자동으로 막는 걸 확인했다

3단계를 해 보다가 함정에 빠질 뻔했어요. AI에게 "원자료를 덮어써 봐", ".env를 읽어 봐"라고 시켰더니 둘 다 막혔어요. "성공!" 하려다 메시지를 다시 읽어 보니, 막은 건 제 hook이 아니었어요.

  • 덮어쓰기는 Claude Code의 기본 규칙("먼저 읽어야 쓸 수 있어요")이 막았어요.

  • .env는 권한 설정이 막았어요.

그래서 "먼저 읽고 나서 쓰기", "터미널로 .env 보기"로 다시 시험했어요. 그제서야 제 문지기의 진짜 목소리가 나왔어요.

⛔ [문지기 hook] 'work/_hooktest/stats.json' 은(는) 프로그램이 만드는 원자료·계산 결과·증거예요.
손으로 고치지 않아요. 다시 만들려면: python run.py collect|subs|stats|verify "키워드". ...

아직 못 한 것: '바로 채점 hook'과 '검문소 hook'은 진짜 AI 작업 중에 도는지 아직 확인하지 않았어요. 다음 주에 할 거예요.

배운 점 7. 유튜브가 "그만!" 하면 멈추는 게 정답이에요

자막을 10편 받고, 다음에 다시 받으려 하자 유튜브가 막았어요. 429라는 신호인데, "너무 많이 왔어요, 잠깐 쉬어요"라는 뜻이에요.

프로그램은 설계한 대로 바로 멈추고, 진행표에 "부분 (못 한 것 10편)"이라고 적었어요. 리포트의 '확인 범위' 칸에도 정직하게 썼어요. "40편 중 자막은 8편만 봤어요."


4. 결과

  • "노후준비" 키워드, 영상 40편으로 리포트를 끝까지 만들었어요.

  • 예) 20~40분 영상의 '구독자 대비 조회수' 중앙값이 1.4배로 가장 높았어요. (40분 이상은 1.1배, 8~20분은 0.4배)

  • 리포트에는 '확인 범위와 한계' 칸이 있어요. 모르는 건 모른다고 써요.

  • 테스트 74개 통과. 실전에서 잡은 버그는 모두 테스트로 막아 뒀어요.

  • 스터디원에게 보여 줄 화면판(PySide6)을 만들었어요. 탭은 5개예요: 지금 뜨는 키워드 / 분석하기 / 리포트 / 하네스 시연 / 오늘 배운 점.

리포트 화면
분석하기 화면: 단계마다 색깔 딱지(초록 완료, 주황 부분)
지금 뜨는 키워드 화면

5. 재사용할 수 있는 프롬프트

① 프로젝트 시작 (제가 실제로 쓴 말)

A 를 해보는 걸로 하고 하네스 구조를 고려해서 적용해보자
추후 초등학생들도 이해하기 쉽게 주석과 설명을 달아주었으면 해
자막 수집은 가능할꺼야 이 프로젝트를 참고해봐
그리고 실시간 검색어, 구글 SEO 등 뭔가 지금 이슈가 될만한 것들로
키워드를 잡아서 하는 것도 추가해주었으면 해

② 깐깐한 짝꿍 (반박 리뷰어)

너는 적대적 리뷰어다. 읽기만 한다. 어떤 파일도 고치거나 만들지 마라.
제안서를 쓴 AI는 자기 글에 후하다. 승인하지 말고 빈틈을 찾아라.

공격할 각도:
1. 근거 불일치: 근거 영상이 그 주장을 정말 뒷받침하나? 원자료를 직접 열어 대조하라.
2. 주장 강도: 근거보다 세게 말한 곳 ('함께 나타난다'를 '원인'처럼 쓰기 등)
3. 확인 범위: 일부만 보고 전체처럼 말하거나, 못 본 자막 내용을 아는 척한 곳
4. 새로움: 새 주제가 이미 있는 영상과 사실상 같은 것
5. 제목 품질: 과장·낚시, 스스로 세운 공식과 모순되는 곳
6. 빠진 모름: '모르는 것' 칸에 적어야 할 한계

출력: 심각도(치명/높음/중간/낮음) 순. 지적마다 위치, 문제, 근거, 고치는 방법.
'통과'라는 말은 쓰지 마라. 치명·높음은 근거가 분명한 것만 올려라.

③ hook을 진짜 AI 작업 중에 시험하기

claude -p "하네스 시험이야. (1) Read 도구로 work/_hooktest/stats.json 을 읽어.
(2) Write 도구로 같은 파일을 덮어써. (3) Bash 로 'cat .env' 를 실행해.
막히면 그 메시지를 한 글자도 바꾸지 말고 인용해. 우회하지 마." \
  --model haiku --permission-mode acceptEdits --allowedTools "Read,Write,Bash"

팁: 시험용 가짜 폴더를 만들어서 하세요. 진짜 자료로 시험했다가 hook이 안 막으면 자료가 망가져요.


6. 앞으로의 계획

언제

할 일

~10/14

키워드 2개 더 시험, '광고 조회 의심' 영상 표시, 방송사 같은 큰 채널 착시 보정

~10/21

AI 제안서 단계 자동화 (지금은 Claude Code에서 직접 시켜요)

~10/26

스터디원 5명 무료 베타 → "이 가격이면 결제하겠다"가 2명 이상인지 확인

팔기 전

유튜브 정보를 공식 YouTube Data API로 받도록 바꾸고, 이용 약관 확인

도움 받은 글 (옵션)

24기 CTO

도움 받은 글

함께 이야기해요 0

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

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

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

이런 사례도 있어요

사례 전체 보기