AI로 3만 줄을 썼는데 무슨 언어인지도 몰랐다
Rockpile, Spottt, odds 세 프로그램을 거친 뒤 돌아본 Vibe Coding의 실제 함정, 검증 루프, 그리고 7단계 출시 절차.

이 글의 목차
근거와 한계
Vibe Coding은 엔지니어링을 없애지 않았다. 가장 부족한 작업을 코드 생성에서 검증과 책임으로 옮겼을 뿐이다.
공개 출처
공개 출처
판단이 달라질 수 있는 조건
문제의 주된 원인은 AI 개발 방식보다 초보자의 경험 부족일 수 있다.
모델이 발전하면 테스트와 보안도 자동화되어 장기적인 병목으로 남지 않을 수 있다.
다음 관찰 지점
프로세스 도입 전후의 재작업 횟수, 보안 문제, 출시 성공률, 프로젝트 생존 기간.
지난 글에서는 AI로 생애 첫 프로그램을 만든 흥분을 썼다. 코드 12800줄, 48시간, 노치에 사는 작은 가재. 그 글의 속뜻은 문턱이 사라졌으니 누구나 할 수 있다는 것이었다.
이번 글은 그 글의 반대편이다.
Rockpile을 만든 뒤 곧바로 두 프로그램을 더 만들었다. Spottt은 Spotify 앨범 커버를 ASCII 그림으로 바꿔 복고풍 휴대용 게임기 모양의 데스크톱 위젯에 넣는다. odds는 메뉴 막대에 살면서 Polymarket 예측 시장의 배당률을 실시간 추적한다. 프로그램 세 개, 20일, 코드 3만 줄. 기록한 버그가 60개를 넘었다.
코드도 개발 과정도 “끝났다”는 뜻도 전혀 모르는 순수 Vibe Coding은 벽에 부딪힌다.
Vibe Coding이 안 된다는 말은 아니다. 된다. 다만 동화는 아니다. 이 글은 첫 성공에 취해 끝까지 vibe로 가려는 나 같은 사람에게 주는 함정 목록이다. 마지막에는 7단계 개발 절차를 붙였다. 오픈소스 AI 안내 스킬 vibe-ship으로도 만들어, 코드를 몰라도 문답을 통해 아이디어부터 출시까지 따라갈 수 있다.
무슨 차를 모는지도 모른다
Spottt 개발 둘째 날, AI와 수십 번 대화하고 버그를 열몇 개 고치고 외형 디자인을 9개 만들었다. 앱도 돌아가고 데스크톱 위젯도 있었다.
그때 질문했다.

개념 이미지 | 시스템의 경계를 모르면 수정할 때마다 위험이 커질 수 있습니다.
“이 앱 Python으로 만든 거야?”
그렇다. 내 프로그램이 무슨 언어인지 아는 데 이틀이 걸렸다.
답을 듣자마자 바꾸자고 했다.
Python + PyWebView의 macOS 창 관리는 엉망이었다. 다른 앱을 자꾸 덮고, 전체 화면도 제대로 되지 않았다. 패키지는 45MB였고 Dock에 뜬 로켓 아이콘은 정식 앱 같지 않았다. 열몇 개를 고쳤는데 하나 고치면 둘이 새로 나왔다.
Tauri, 즉 Rust + WebView로 옮기자 크기가 45MB에서 5.3MB로 줄었고 창 관리 문제도 대부분 사라졌다. 대신 PyWebView 디버깅에 쓴 시간은 전부 헛수고였다.
AI는 지금 먼 길로 돌아가고 있다는 사실을 먼저 알려 주지 않는다. 실행자이지 조언자가 아니다. 하라면 하고, 묻지 않으면 말하지 않는다.
실행됨 ≠ 사용 가능 ≠ 완료
이 세 단계의 거리는 예상보다 훨씬 멀었다.
실행됨
컴파일이 통과하고 앱이 켜지고 화면에서 뭔가 움직이면 거의 됐다고 느낀다. 한참 멀었다.
Spottt 터미널 버전이 처음 돌아갔을 때 5분쯤 신났다. 그러고는 로고 글자가 화면 아래로 끝없이 내려갔다. AI가 터미널 UI의 기본인 alternate screen buffer를 잊었다. 더 우스운 건 AI가 복제하라고 한 참고 프로젝트에는 이미 있었는데, 자기 코드를 쓸 때는 참고하지 않았다는 점이다.
odds에는 더 황당한 일이 있었다. AI가 IBM Plex Mono 폰트 파일을 “생성”해 프로젝트에 넣었다. 컴파일도 되고 앱도 돌았지만 자간과 굵기가 이상했다. 한참 조사한 끝에 진짜 폰트가 아니라 가짜 바이너리 데이터임을 알았다. AI가 TTF를 위조했고, 시스템은 불러오기에 실패하자 조용히 기본 폰트로 fallback했다.
AI는 코드를 쓸 수 있지만 바이너리 파일을 “생성”할 수는 없다. 폰트, 이미지, 오디오는 진짜를 써야 한다.
사용 가능
앱이 돌고 기능도 있고 사용자 조작에도 반응한다. 이제 끝났을까?
아니다.
odds에서 오래 막힌 버그가 있었다. “팔로우”를 눌러도 아무 일도 없었다. 오류도 안내도 없고, 버튼도 목록도 바뀌지 않았다. 침묵이었다.
원인은 데이터를 배열과 집합 두 곳에 저장하면서 초기화할 때 배열만 채운 것이었다. 팔로우 여부는 빈 집합을 읽어 “+ 팔로우”를 표시했다. 클릭 후 추가 로직은 배열을 읽고 이미 있다고 바로 return했다. 양쪽은 각자 맞았지만 합치면 아무 일도 없었다.
조용한 실패는 가장 무서운 버그다. 사용자는 제품이 고장 났다고 느끼는데 로그는 깨끗하다. AI에게 뭘 보여 줘야 할지조차 모른다.
완료
코드를 다 짜면 끝이라고 생각한 것이 가장 깊은 함정이었다.
macOS 앱을 남에게 배포하려면 Code Signing, Apple Notarization, DMG 패키징, Hardened Runtime, Staple 티켓 삽입이 필요했다. 하나도 들어 본 적 없는 용어였다.
더 기초적인 문제도 있었다. `.app` 번들은 shell 환경변수를 물려받지 않는다. 터미널에서 설정한 API key도 앱으로 패키징하면 읽지 못한다. Spottt Python 버전에서 한 번, Tauri로 옮긴 뒤 다시 한 번 겪었다. 똑같은 버그를 서로 다른 기술 스택에서 두 번 겪은 셈이다.
Rockpile은 더 웃겼다. Day 2에 Apple 공증을 마쳤는데, 돌아보면 전혀 필요 없었다. 사용자도 한 명 없는데 누구 보라고 공증을 받았을까?
odds의 버전 번호는 파일 다섯 곳에 흩어져 있었고 전부 달랐다. CHANGELOG는 v0.2.1, README는 v0.1.0, 설정은 v0.2.2, 안내 화면은 v0.1.2였다. Git tag는 하나도 없었다. 최신 버전이 무엇이냐는 질문에 나조차 답하지 못했다.
실행되는 코드는 절반만 온 것이다.
디자인은 가장 달콤한 함정이다
세 프로젝트에서 디자인에 허비한 시간은 전체 개발 시간의 3분의 1을 넘을지도 모른다.
Spottt은 Walkman, Tamagotchi, Discman, Teenage Engineering 등 외형 콘셉트 9개를 만들었다. 방향을 바꿀 때마다 앞선 작업이 버려졌다. 9개 중 고른 최종안도 구현 과정에서 완전히 다른 모습이 됐다.
odds는 더 심했다. 디자인 방향 11개의 HTML 미리보기, 로고 탐색 3차례, shader풍 아이콘, 디자인 투표 페이지까지 만들었다. HTML 시안이 총 21개였는데 대부분 쓰지 않았다.
무엇이 문제였을까? 다른 방향을 달라고 하면 주고, 복고풍을 해 보라고 하면 만들어 준다. 말리는 사람이 없다.
Rockpile 스프라이트도 마찬가지였다. 픽셀, 평면, 3D, 손그림, 벡터의 5가지 스타일을 시도하면서 각각 30세트를 전부 생성하게 했다. 결국 Pixar 3D를 고르고 나머지 4묶음의 120장을 버렸다.
처음부터 스타일별로 한두 장만 시험해 방향을 정했다면 디자인 시간의 80%를 아꼈을 것이다.
저장소 이력을 갈아엎다
개발 과정 전체에서 가장 아찔한 날이었다.
Rockpile의 코드를 전면 리뷰했더니 테스트 스크립트에 실제 Gateway Token이 하드코딩돼 있었다. 공개 저장소의 소스 코드에 그대로 노출돼 누구나 내 서버에 연결할 수 있었다. 디버깅을 편하게 하려고 기본값을 넣어 두고 GitHub에 올릴 때 확인하는 것을 완전히 잊었다. AI도 코드를 작성하면서 이 token을 소스에 넣으면 안 된다고 알려 주지 않았다.

개념 이미지 | 재구축은 아키텍처 이해와 보안 검토를 대신하지 못합니다.
수습하는 것은 코드 작성보다 열 배는 어려웠다. 현재 파일만 고쳐서는 해결되지 않는다. Git에는 이력이 남기 때문에 해당 줄을 지워도 과거 commit에서 token을 찾을 수 있다. 결국 `git-filter-repo`로 Git 이력 전체를 지우고 force push로 원격 저장소를 덮어썼다. 저장소의 역사를 통째로 다시 쓴 것이다.
같은 리뷰에서 문제가 더 나왔다. TCP Socket이 모든 네트워크 인터페이스를 수신해 같은 WiFi에 있는 모든 기기가 가짜 이벤트를 보낼 수 있었다. JSON은 직렬화 라이브러리 대신 문자열 연결로 만들어 주입 취약점이 있었고, API Key는 Keychain 대신 UserDefaults 평문 plist에 저장돼 있었으며, HTTP 요청 본문의 크기 제한이 없어 DoS 공격이 가능했다.
전문 개발자에게는 상식이다. 하지만 순수 Vibe Coder는 이런 위험이 있다는 사실조차 모른다. AI가 짠 코드에 보안 구멍이 있어도 전혀 알아볼 수 없다.
odds를 만들 때는 조금 배웠다. 코드를 올리기 전에 AI에게 비밀키, 개인 이메일, 로컬 컴퓨터 경로가 들어갔는지 보안 점검을 부탁했다. 이 역시 함정에 빠진 뒤에야 배운 요령이었다.
기억할 것은 하나다. GitHub에 올리기 전 매번 공개하면 안 되는 정보가 있는지 AI에게 검사하게 하라. 이미 올렸다면 파일만 지워서는 부족하다. Git은 모든 이력을 기억하므로 이력 전체를 지워야 한다.
같은 함정에 두 번 빠진다
Spottt을 설치 파일로 묶자 앱이 실행되자마자 꺼졌다. 개발 환경에서 잘 읽던 설정을 패키징 뒤에는 읽지 못했다. 이를 고친 뒤 기술 스택을 바꾸자 같은 문제가 다시 나타났다.
AI에게는 기억이 없다. 새 대화, 새 문맥마다 처음부터 시작한다. 겪었던 함정을 직접 기억해 미리 일러 주지 않으면 또 빠지게 만든다.
Rockpile도 비슷했다. 가재가 체력이 떨어져 배를 뒤집는 상태에 들어가면 AI가 다시 정상적으로 작동해도 영원히 원래대로 돌아오지 않았다. 회복 로직을 빠뜨린 것이다. 프로젝트 이름을 바꾼 뒤에도 여러 곳에 옛 이름이 남아 연결이 되지 않았다. 이름은 바꾸고 참조는 바꾸지 않는 오류를 코드를 모르는 사람이 미리 예측할 수는 없다.
그래서 나는 함정 문서를 만들어 겪은 문제마다 기록하고, 새 프로젝트를 시작할 때 AI에게 붙여 넣어 보여 주기 시작했다.
AI는 “아니오”라고 하지 않는다
세 프로젝트를 돌아보면 가장 큰 시간 낭비는 버그가 아니라 만들지 말았어야 할 기능이었다.
세 프로젝트 모두 3개 언어를 지원했다. odds에는 스크롤 시세 표시와 터미널 시작 애니메이션을, Rockpile에는 AI 제공업체 다섯 곳을 한꺼번에 넣었다. 만들 때는 전부 있으면 좋겠다고 생각했다. 돌아보니 일본어 사용자는 없었고, 시세 표시는 주 목록과 완전히 겹쳤으며, 제공업체 대부분은 필요 없었다. 시작 애니메이션은 한 번 볼 뿐인데 건너뛰기 기능조차 없었다.
왜 만들었나? AI가 너무 고분고분했기 때문이다. 일본어를 추가하라고 하면 추가하고, 시작 애니메이션을 만들라고 하면 만든다. 정말 필요한지는 되묻지 않는다.
AI가 몇 분 만에 구현해 주니 나중에 떠오른 아이디어도 모두 공짜처럼 보인다. 하지만 유지보수는 공짜가 아니다. 언어가 3개면 문구를 매번 세 번 고쳐야 하고, 제공업체가 다섯 곳이면 새 기능을 다섯 번 맞춰야 한다.
odds 팀 리뷰에서 가상 CEO가 했던 말이 아직도 기억난다.
"有三种语言但在那些市场没有分发渠道,也没有需求证据。这是伪装成完整性的 scope creep。"
그 뒤로는 기능을 추가하고 싶을 때 먼저 자문했다. 이게 없어도 제품을 쓸 수 있나? 그렇다면 일단 만들지 않는다.
마치며
지난 글의 끝에서 아이디어와 제품 사이의 문턱은 이제 사라졌다고 했다.
지금도 동의한다. 다만 각주가 필요하다.
문턱은 사라졌지만 바닥에는 구덩이가 있다. 개발 절차를 모르면 기술 선택에 며칠을 허비한다. 코드의 차이를 모르면 자기 프로그램이 어떤 언어로 쓰였는지도 모른다. 완료의 기준을 모르면 실행 이후 서명, 패키징, 출시라는 마지막 구간에서 막힌다. 보안 검사를 하지 않으면 API key가 GitHub 공개 저장소에 그대로 노출된다.
코드를 배울 필요는 없다. 나도 아직 한 줄 못 쓴다. 하지만 무엇으로 만들었는지, 실행과 배포 사이가 얼마나 먼지, GitHub에 올리기 전에 무엇을 확인해야 하는지, 어떤 기능을 만들고 어떤 기능을 덜어내야 하는지는 알아야 한다.
이것은 프로그래밍 지식이 아니라 제품 상식이다.
Vibe Coding에서 알아야 할 것은 코드 작성법에서 제품을 만드는 법으로 바뀌었다. 예전에는 기술력이 발목을 잡았다면 지금은 판단력이 발목을 잡는다. 이것은 발전이다.
하지만 AI를 켜고 몇 마디만 건네면 출시까지 갈 거라 생각한다면, 이 글에 나온 모든 함정을 직접 겪게 될 것이다.
마지막——순수 Vibe Coder를 위한 개발 절차
이 함정들을 겪은 뒤 나만의 절차를 정리했다. 거창한 방법론이 아니라 무엇을 먼저 하고 다음에 무엇을 할지 정한 순서다. 첫 프로젝트부터 따랐다면 아마 절반의 시간을 아꼈을 것이다.

개념 이미지 | 안정적인 납품은 한 번의 생성이 아니라 단계별 검증에서 나옵니다.
첫째: 말하기 전에 생각하기
AI를 열자마자 무엇을 만들어 달라고 하지 말자. 10분 동안 세 가지를 생각하자. 누가 쓸 것인가? 핵심 기능 단 하나는 무엇인가? 가장 비슷하게 본 제품은 무엇인가? 세 가지 답을 적고 시작하자.
둘째: 기술 구성 묻기
원하는 것을 설명한 뒤 AI에게 가장 적합한 기술 방안과 이유, 다른 선택지와 각각의 장단점을 물어라. 이해할 수 있게 설명하도록 하고, 모르겠으면 다시 물어라. 여기서 10분을 쓰면 며칠을 아낄 수 있다.
셋째: 최소 버전부터 실행하기
핵심 기능만 만들자. 디자인, 다국어, 애니메이션, 있으면 좋은 부가 기능은 빼자. 아무리 투박해도 핵심이 돌아가는 버전이 목표다. 작동하면 화면을 저장하자. 이것이 v0.1이다. 이후 AI 코드 리뷰로 숨은 문제를 확인하는 것을 권한다.
넷째: 보안 검사를 포함해 출시하기
많은 사람이 이 과정을 건너뛰었다가 마지막 날 당황한다. 먼저 AI에게 비밀키, 비밀번호, 개인 이메일, 로컬 경로 등 공개하면 안 될 정보가 없는지 검사하게 하라. 통과하면 배포에 필요한 작업을 묻고, 전체 단계를 적어 한 번 밟아 보자. 배포 경로를 일찍 뚫어 둘수록 덜 당황한다.
다섯째: 이제 디자인하기
핵심이 안정되고, 출시 절차가 통하고, 보안 검사가 끝났다. 이제 디자인할 때다. 마음에 드는 참고 이미지 두세 장을 주고 한 방향을 정하자. 시안은 세 개를 넘기지 말고 하나를 골라 진행하자.
여섯째: 기능 추가 전 자문하기
기능을 추가하고 싶을 때는 이것 없이도 제품을 쓸 수 있는지 자문해 보자. 쓸 수 있다면 나중 목록에 넣자. 핵심 경험을 다듬은 뒤 돌아와 한 번에 최대 세 개만 고르자.
일곱째: 모두 기록하기
개발 중 문제가 생기면 적어 두자. 자세할 필요는 없다. 패키징 후 설정을 읽지 못한다는 한 문장으로 충분하다. 다음 프로젝트에서 AI에게 붙여 넣어라. 스스로는 기억하지 못해도 대신 기억해 줄 수 있다.
일곱 단계 어디에도 코드 작성 능력은 필요 없다. 하지만 이 순서를 지키면 내가 겪은 시행착오 대부분은 피할 수 있다.
이 절차를 오픈소스 AI 개발 안내 스킬 vibe-ship으로 만들었다. 문답으로 전체 과정을 이끈다. 누구나 설치해서 쓸 수 있다.
Rockpile: github.com/ar-gen-tin/rockpile
Spottt: github.com/ar-gen-tin/spottt
odds: github.com/ar-gen-tin/odds
Don't Panic. Accelerate.