고수가 말하는 디버깅 지옥 탈출법(feat. 깃허브)

 

오늘도 커서(Cursor) 깎는 노인처럼 프롬프트 창만 바라보고 있는 여러분을 위해 깃허브를 뒤지다가 발견한 보물 같은 글 하나를 가져왔다. 바이브 코딩으로 앱 30개를 출시하고 실제 돈을 벌고 있는 고수의 노하우다. 이 사람은 콜롬비아 대학에서 ML(머신러닝)을 전공한 찐 개발자 출신인데도 처음 바이브 코딩을 할 때는 우리처럼 디버깅 지옥을 맛봤다고 한다. 코딩이 마법 같다가도 몇시간 동안 에러만 잡고 있는 그 허무함 모두 겪어봤을 것이다. 이 고수가 30번 넘게 앱을 찍어내면서 정립한 AI가 내 코드를 망치지 않게 관리하는 5가지 원칙을 풀어서 정리했다. 이건 진짜 꿀팁이니 꼭 적용해 보자.

1. 직원 교육 매뉴얼을 실시간으로 업데이트하라 (Self-updating rules)

우리가 직원을 채용하면 수습 기간에 일을 가르친다. 그런데 매번 똑같은 실수를 하면 화가 난다. AI도 똑같다. 이 고수는 클로드(Claude)에게 스스로 .cursorrules나 CLAUDE.md 파일을 업데이트하게 시킨다. 어려운 버그를 하나 해결하거나, 우리 프로젝트만의 규칙(예: 변수명은 이렇게 지어라, 디자인은 이걸 써라)이 생길 때마다 AI에게 방금 해결한 내용이랑 규칙을 네가 볼 수 있는 룰 파일에 추가해 놓으라고 시키자. 이렇게 며칠만 지나면 이 파일은 AI가 내 프로젝트를 완벽하게 이해하는 살아있는 직원 매뉴얼이 된다. 맨땅에 헤딩하지 말고 AI를 학습시켜라.

2. 눈을 가리고 일하게 하지 마라 (MCP 활용)

이건 좀 기술적인 이야기지만 핵심은 간단하다. MCP(Model Context Protocol)를 써서 AI에게 '눈'을 달아주라는 거다. 그냥 채팅창에 코드 복사해서 붙여넣지 말고, AI를 내 깃허브(GitHub), 데이터베이스, 파일 시스템이랑 직접 연결해 주라는 뜻이다. AI가 내 코드를 직접 읽고(Read), 문서를 참고하게 하면 뇌피셜로 헛소리하는 환각(Hallucination)이 확 줄어든다. 없는 함수 좀 만들어내지 말라고 화내기 전에 AI가 내 코드를 훤히 들여다볼 수 있게 환경을 세팅해 주자. 초기 세팅 20분이면 삽질 시간 4시간을 아낄 수 있다.

3. 금방 고치겠네 싶을 때가 바로 세이브 타이밍 (Checkpoint)

게임을 하다가 보스 방 앞에 가면 본능적으로 세이브를 한다. 코딩도 똑같다. 이 고수는 이거 간단하네, 금방 고치겠네라는 생각이 드는 순간 멈추고 깃(Git) 커밋(저장)을 하라고 조언한다. 지옥은 항상 그냥 한 줄만 고치면 될 것 같은데? 에서 시작된다. 그 한 줄이 나비효과가 되어 전체 코드를 망가뜨리기 때문이다. 깨끗한 세이브 파일(체크포인트)을 만들어두면 AI가 코드를 걸레짝으로 만들어놔도 언제든 돌아갈 수 있다. 나는 과하다 싶을 정도로 저장을 많이 한다. 되돌려도 채팅으로는 완벽하게 복원되지 않는 경우가 있다.

4. 코딩하기 전에 보고서부터 받아라 (Force explicit reasoning)

사장님 마인드셋의 핵심이다. 직원한테 일 시킬 때 바로 작업부터 하라고 하면 사고 친다. AI에게 코드를 짜라고 하기 전에 반드시 어떻게 짤 건지 계획을 먼저 말해보고 뭐가 문제 될 수 있는지 설명해보라고 명령해라. 커서나 클로드에는 생각 모드(Thinking mode)가 있다. 이걸 켜고 AI가 논리적으로 접근하게 강제해야 한다. 이 과정 없이 바로 코드를 짜게 하면 겉보기에만 멀쩡하고 속은 썩어있는 코드가 나온다. 

5. 딴 건 건드리지 마 라고 딱 잘라 말해라 (Scope lock)

이게 진짜 바이브 코딩의 킬러 팁이다. AI는 지나치게 친절하다. 버그 하나 고쳐달라고 하면 편하시라고 제가 파일 12개를 싹 리팩토링 했다고 해맑게 말한다. 명령할 때 항상 범위를 잠가라(Lock). 이 파일의 이 함수만 수정해. 다른 건 절대 건드리지 말고 필요하면 나한테 먼저 물어봐. 이렇게 정확한 명령어를 줘야한다. 범위를 좁게 잡을수록 결과는 예측 가능해지고 버그는 줄어든다. 

 

이 깃허브 글의 핵심은 결국 하나로 통한다. AI를 믿지 말고 관리하라는 것.

1. 매뉴얼(룰 파일)을 만들고,
2. 작업 환경(MCP)을 연결해 주고,
3. 중간 보고(계획 설명)를 받고,
4. 권한(작업 범위)을 제한해라.

앱 30개를 만든 고수의 비결은 코딩 실력이 아니라 AI 관리 능력이다. 우리도 오늘부터 무지성으로 이거 해줘 라고 하지 말고 깐깐한 사장님이 되어보자. 그래야 원하는 결과를 얻어낼 수 있다.