바이브 코딩 오류 해결: AI에게 다시 묻기 전에 확인할 5가지

code-fix.dev ·

AI가 만든 앱이 원하는 대로 동작하지 않을 때, 재현 조건부터 오류 로그와 변경 범위까지 정리하는 순서입니다.

1. 기대한 결과와 실제 결과를 분리하세요

“로그인이 안 돼요” 대신 “이메일로 로그인하면 대시보드로 이동해야 하는데 로그인 화면으로 돌아옵니다”처럼 적습니다. 페이지 주소, 사용한 계정 종류, 누른 버튼, 발생 시점을 함께 남기면 조사 범위가 좁아집니다.

2. 같은 조건에서 다시 발생하는지 확인하세요

새로고침 전후, 로그인 전후, 다른 브라우저에서 결과를 비교합니다. 매번 발생하는지 가끔 발생하는지도 기록하세요. 실패 직전의 클릭 순서를 번호로 적으면 개발자와 AI 모두 같은 현상을 확인하기 쉬워집니다.

3. 화면의 오류와 서버의 오류를 구분하세요

브라우저 개발자 도구의 Console과 Network에서 실패한 요청의 상태 코드와 메시지를 확인합니다. 요청 자체가 없다면 화면 이벤트부터, 요청이 실패했다면 응답 내용과 서버 로그부터 살펴봅니다. 상태 코드 하나만으로 원인을 단정하지 마세요. 공유할 때 쿠키, 토큰과 개인정보는 지웁니다.

4. 마지막으로 정상 동작했던 변경을 찾으세요

Git 기록에서 문제가 시작된 시점의 변경 파일을 비교합니다. 기능을 여러 개 동시에 고치지 말고 의심되는 변경 하나씩 검증하세요. 배포 환경에서만 실패한다면 환경 변수의 이름, 실행 명령, 의존성 버전 차이도 확인합니다. 운영 데이터를 지우거나 비밀키를 공개하는 방식으로 시험하지 않습니다.

5. 수정 후 원래 기능도 확인하세요

오류가 사라졌는지만 보지 말고 정상 입력, 잘못된 입력, 새로고침, 재로그인을 확인합니다. AI에게는 재현 순서와 관련 코드, 가려진 로그를 주고 수정 이유와 확인 방법까지 요청하세요. 같은 문제가 반복되거나 데이터 변경이 걸려 있다면 저장소 사전 분석을 신청해 수정 범위를 먼저 정할 수 있습니다.