바이브코딩 완전정복 — 메이커 에반

01핵심 개요

02핵심 내용 구조

영상은 스타터킷 안에 무엇이 들어 있고 왜 코드보다 먼저 필요한지를 다섯 덩어리로 설명한다. (1) 클로드(Claude)가 짠 코드를 왜 자꾸 갈아엎게 되는지, (2) 그걸 막아주는 규칙 파일이 무엇인지, (3) 백엔드와 프론트가 어떤 모양으로 미리 잡혀 있는지, (4) 함께 들어 있는 에이전트 두 명이 무슨 일을 하는지, (5) 실제로 어떻게 시작하는지를 세 단계로 보여준다. 발표자 메이커 에반은 자신이 실제로 쓰는 규칙과 구조를 통째로 압축해 정리해 두었다고 설명한다.

03기술적 맥락

스타터킷의 심장은 .claude 폴더로, 프론트엔드 가이드라인 10개와 백엔드 가이드라인 10개를 합쳐 총 20개의 규칙 문서가 예시 코드까지 붙어 정리돼 있다. 백엔드는 파이썬으로 되어 있으며 도메인·서비스·API·DB·미들웨어·에러·유틸 등 폴더(서랍)가 미리 나뉘어 있고, DB 마이그레이션·테스트·도커 설정·로깅·에러 처리가 한 곳에 미리 연결돼 있다. 프론트엔드는 Next.js에 TypeScript가 세팅돼 있고 shadcn/ui 컴포넌트 라이브러리(버튼·카드·입력창 등 기본 부품)가 붙어 있다. design.md 파일에 색상·글자 크기·간격 등 디자인 규칙을 명시해 클로드가 매번 다른 파란색을 쓰는 문제를 방지한다.

04전략적 의미

발표자의 핵심 통찰은 코드가 누더기가 되는 원인이 "실력 문제가 아니라 규칙 문제"라는 점이다. 요즘 AI는 파일까지 알아서 만들지만 어떤 규칙으로 짤지는 사람이 정해줘야 하며, 규칙이 없으면 클로드가 매번 스스로 판단해 그날그날 다른 방식으로 짜서 합치면 일관성이 무너진다. 잘하는 사람들은 코드보다 규칙을 먼저 주고, 규칙이 잡힌 코드 베이스에서 AI가 훨씬 잘 짠다는 것이 반복되는 메시지다. 세팅과 규칙 문서가 같은 프로젝트 안에 붙어 있어 클로드가 코드를 짜기 전 규칙을 먼저 읽는다는 조합이 핵심 가치다.

05핵심 워크플로우/방법론

가장 중요한 파일은 CLAUDE.md로, 클로드가 프로젝트에 처음 들어올 때 읽는 안내문 역할을 한다(신입 직원 첫 출근 안내문에 비유). 여기에는 무엇을 만드는지, 프론트·백엔드가 어디 있는지, 어떤 규칙 문서를 언제 펴봐야 하는지가 적혀 있고, skills.json 파일이 언제 어떤 규칙을 꺼낼지 지정한다. 함께 든 에이전트 2명 중 한 명은 계획·검토 담당(공사 전 도면을 검토하는 선배 역할), 다른 한 명은 자료 조사 담당(최신 라이브러리 사용법 등을 인터넷에서 찾아 정리)이다. 발표자의 실제 작업 순서는 "계획 → 검토 → 자료 조사 → 코딩"으로, 바로 코드부터 짜지 않는 이 순서가 갈아엎는 횟수를 크게 줄인다.

06활용 시나리오

• 초보 개발자의 첫 프로젝트 시작: 폴더를 먼저 만들지 화면부터 그릴지 며칠 헤매는 대신, 설치 한 줄을 클로드에게 건네고 곧바로 만들고 싶은 기능만 말하면 정해진 자리에 파일이 생성된다.
• 기능 대량 추가 시 구조 유지: 백엔드 서랍(폴더)이 미리 나뉘어 있어 기능을 100개 붙여도 들어갈 자리가 있어 구조가 무너지지 않는다.
• 디자인 일관성 유지: design.md에 색상·간격 규칙을 미리 지정해 화면 10개를 만든 뒤 색이 미묘하게 달라 전부 다시 손보는 사고를 예방한다.
• 실서비스 개발 베이스: 발표자가 자신의 서비스 "스킬샵"의 거의 모든 기능을 이 스타터킷 코드를 베이스로 만들었다.

07현황 및 전망

스타터킷은 스킬샵에서 49,900원에 판매 중이며, 원가 99만9,000원을 구독자 이벤트로 반값 할인한 가격으로 이미 446명이 구매했다. 발표자는 두 가지 한계를 솔직히 밝힌다. 첫째, 클로드 코드(Claude Code) 환경이 별도로 필요하다. 둘째, 이 킷은 전반적인 뼈대(구조·규칙)를 제공할 뿐 실제 코드를 대신 짜주지는 않으므로 사용자가 이 베이스 위에서 자신만의 코드를 개발해야 한다. 더 깊은 논의는 스킬샵 오픈톡방에서 이어진다.

08용어 사전