안드레 카파시 바이브 코딩, 이해 범위, 코드 성장 | 읽으면 알겠는데 지금은 안 읽으면?
안드레 카파시 바이브 코딩은 코드가 평소 이해 범위를 넘고 읽으려면 한참 걸리는 상태다. 버릴 주말 앱의 패딩에만 맞고, 카카오 콜백이나 토스 웹훅은 한 파일을 한 문장으로 말할 수 있을 때만 수락한다. 커서, 클로드 코드, Next.js, LLM, 1인 개발자 기준. 2026년 9월 원문과 파울러, MIT 테크놀로지 리뷰, 깃 blame 문서.
읽으면 알겠는데 지금은 안 읽는 상태는 안드레 카파시 바이브 코딩의 이해 범위가 넘은 칸입니다. 남을 코드면 한 파일을 한 문장으로 말할 수 있을 때만 수락합니다.
주말에 카카오 로그인을 말로 붙이다가 한 달이 지나면, 콜백 파일이 어디 있는지도 기억이 안 납니다. 원문은 코드가 평소 이해 범위를 넘고, 읽으려면 한참 걸린다고 했죠. 패딩 실험에는 맞습니다. 버셀에 올린 로그인에는 안 맞아요.
정의와 배포, 사전, 붙여 넣기, 우회는 이미 나눠 둔 글이 있어요. 여기는 이해 범위가 넘은 파일 한 칸만 봅니다. 근거는 카파시 원문과 파울러, MIT 테크놀로지 리뷰에 있습니다. 저는 12개 사이트를 올릴 때 한 문장으로 못 말하는 콜백은 수락하지 않습니다.
원문이 말한 이해 범위는 안 읽기로 한 상태다
이해 범위가 넘었다는 말은 읽으면 알 수 있는데 지금은 안 읽는 상태입니다. 안드레 카파시 바이브 코딩은 그 상태를 재미로 둔 주말 루프입니다.
2025년 2월 2일 원문은 코드가 평소 이해 범위를 넘고, 제대로 보려면 한참 읽어야 한다고 적었습니다. 바로 앞 문장이 항상 전체 수락하고, 이제 diff를 안 읽는다는 말이죠. 두 문장은 한 칸입니다. 수락을 눌러 파일을 키우고, 그 파일을 안 읽으니 이해 범위가 밀립니다.
MIT 테크놀로지 리뷰는 2025년 4월 16일 글에서, 바이브 코딩이려면 모델이 짠 줄을 확인하거나 직접 고치지 않고 흐름에 맡겨야 한다고 봤습니다. 마틴 파울러는 2026년 5월 21일 글에서 코드가 존재한다는 사실조차 잊는 데 쓸모와 한계가 같이 있다고 적었습니다. 이해 범위를 넘긴 파일은 그 잊음의 결과입니다.
The code grows beyond my usual comprehension, I'd have to really read through it for a while.
코드가 평소 이해 범위를 넘는다. 제대로 보려면 한참 읽어야 한다. 안드레 카파시, 2025년 2월 2일.
원문 다섯 행동의 목록은 정의와 원문 글에 있고, 여기는 그중 이해 범위 한 칸만 봅니다. 주말 프로토를 배포 브랜치에 넣을지는 에이전틱과 배포 비교가 가릅니다.
먼저 기억할 것 | 안드레 카파시 바이브 코딩의 이해 범위가 넘은 코드는 버릴 주말 앱용입니다. 인증과 결제는 한 문장으로 못 말하면 수락하지 않습니다.
읽으면 알겠는데 지금은 안 읽는 파일이 이해 범위가 넘은 칸이다
버릴 앱과 남을 앱에서 이해 범위가 갈린다
버릴 앱은 이해 범위가 넘어도 주말에 지웁니다. 남을 앱은 한 달 뒤에도 그 파일을 고칠 사람이 저입니다.
파울러는 바이브로 짠 소프트웨어가 줄을 빠르게 많이 만들고, 품질이 낮아 나중에는 모델조차 고치기 어려워진다고 적었습니다. 주말 패딩은 그 위험을 감수합니다. 카카오 콜백과 토스 웹훅은 감수할 자리가 아닙니다. 사이먼 윌리슨은 2025년 3월 19일에, 나온 코드를 검토하지 않을 때만 바이브라고 좁혔습니다. 이해 범위를 넘긴 채로 두면 그 정의 안에 있습니다.
지금 창
이해 범위가 넘어도
남을 코드
패딩, 키 없는 레이아웃
허용. 주말에 지워도 됨
허용. 파일이 커져도 됨
한 달 뒤 같은 저장소
원문대로면 또 말로 시킴
한 파일을 한 문장으로
카카오 콜백
원문이 막은 자리
리다이렉트 한 파일을 설명할 수 있을 때만
토스 웹훅 서명
원문이 막은 자리
서명 검증 줄을 가리킬 수 있을 때만
말로 지시했다고 바이브인지는 사전과 원문 글이 가릅니다. 여기는 그 파일이 내 머리에 남아 있는지만 봅니다.
갈림선은 한 문장이다 | 이 파일이 무슨 일을 하냐고 물었을 때 바로 답이 나오면 이해 범위 안입니다. 창을 다시 열어 찾아보면 이미 넘었습니다.
한 달 뒤 콜백을 한 문장으로 못 말하면
한 달 뒤 그 파일을 못 찾으면 고치는 사람이 없습니다. 한국에서 혼자 올리는 서비스는 이 칸에서 자주 막힙니다.
카카오 로그인 REST는 인가 코드를 받을 리다이렉트 URI를 콘솔에 등록합니다. 로컬과 버셀 프리뷰, 운영 도메인이 다르면 등록에 없는 주소로 돌아옵니다. 공식 문서도 리다이렉트 URI가 일치해야 한다고 적습니다. 주말에 에이전트에게 로그인만 붙여 달라고 하고 전체 수락하면, 콜백 라우트와 환경 값과 토스트가 한 번에 늘어납니다. 화면은 됩니다. 한 달 뒤 프리뷰만 400이 나면, 어느 파일이 주소를 들고 있는지부터 다시 찾습니다.
토스 웹훅 서명도 같습니다. 서명 검증 줄이 어느 함수에 있는지를 한 문장으로 못 말하면, 다음 지시는 검증을 건너뛰라는 쪽으로 흐릅니다. 화면 결제는 통과하고, 위조 콜백도 통과합니다. 제가 12개 사이트에 카카오 콜백을 붙일 때도, 주말에 만든 파일을 월요일에 한 문장으로 못 말하면 수락을 되돌렸습니다.
에러를 창에 넣을 때 키가 새는 칸은 붙여 넣기와 시크릿 글이 다룹니다. 화면만 고쳐 원인을 가리는 칸은 우회와 랜덤 변경 글이 다룹니다. 여기는 그 파일을 내가 설명할 수 있는지만 봅니다.
한 달 뒤에도 콜백 파일을 한 문장으로 말할 수 있어야 남을 코드다
한 파일로 이해를 되돌리는 순서
새 기능을 시키지 말고, 한 파일의 이력부터 엽니다. 이력이 보이면 이해 범위가 다시 들어옵니다.
깃 문서는 blame이 각 줄이 마지막으로 바뀐 커밋과 저자를 보여 준다고 적습니다. 로그는 파일 경로를 따라 커밋을 나열합니다. 두 명령은 에이전트에게 설명을 또 시키지 않고, 저장소가 들고 있는 답을 꺼냅니다. 커서나 클로드 코드 창을 닫고 터미널에서 먼저 봅니다.
통계에 스타일 파일과 로그인 라우트가 같이 있으면 이해 범위가 넘은 턴입니다. 콜백 한 파일만 열리고 주석이나 테스트가 추가되면 이해가 돌아온 턴입니다. 파울러가 말한, 모델조차 고치기 어려운 낮은 품질 코드는 대개 파일이 여러 개로 흩어진 뒤에 옵니다. 한 파일로 되돌린 뒤에만 창을 다시 엽니다.
에이전트에게 새 기능을 시키지 말고 이 파일만 설명하게 한다
# CLAUDE.md 또는 커서 규칙 파일 예시
새 기능을 추가하지 말 것.
pages/api/kakao-callback.js 가 하는 일을 한 문장으로 적을 것.
리다이렉트 URI 를 읽는 줄을 가리킬 것.
한 문장으로 못 말하면 수락하지 말 것.
버릴 주말 앱의 패딩만 이해 범위를 넘긴 채 둬도 됨.
설명부터, 기능은 나중 | 이해 범위가 넘은 파일에 기능을 또 시키면 범위가 더 밀립니다. 한 문장이 나온 뒤에만 다음 지시를 엽니다.
한 문장으로 못 말하면 수락하지 않는다
수락 버튼 앞에서 한 문장만 말합니다. 말이 안 나오면 그 턴은 버릴 앱이거나, 아직 남을 코드가 아닙니다.
윌리슨은 2026년 5월에 바이브와 에이전틱이 자기 작업에서 가까워진다고 적었습니다. 그래도 구분 기준은 코드를 보느냐였습니다. 이해 범위를 되돌리는 일은 그 보기입니다. 커서가 만든 diff 통계만 봐도 이번 턴이 패딩인지 콜백인지 갈립니다.
