바이브코딩 디버깅, 어디서부터 틀렸을까 — Superpowers 활용 4편
취소한 주문이 다시 나타날 때 원인을 좁히는 법
AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.

커피를 취소하자 합계에서 빠졌다. 담당자가 안심하고 화면을 새로고침하니 커피가 다시 나타났다. 앞편에서 마감 뒤 주문을 막았는데도, 마감 전에 취소한 주문의 수량이 되살아나는 문제가 남아 있었다. 어디를 고칠지는 취소 버튼을 누른 순간부터 새로고침 뒤 집계가 표시될 때까지, 어느 지점에서 값이 처음 달라지는지를 보고 결정한다.
이 글은 앞편과 같은 가상의 점심 주문 앱을 사용한다. 조사 기록과 테스트 결과도 개발 과정을 설명하기 위해 구성한 예시다.
신고를 누구나 반복할 수 있는 절차로 바꾼다
“취소가 안 돼요”라는 말만으로는 여러 문제가 가능하다. 버튼을 눌러도 반응이 없을 수 있고, 주문 목록에서만 빠질 수도 있고, 다른 기기에서 집계를 열었을 때만 잘못될 수도 있다. 업무를 아는 사람이 먼저 해 줄 일은 무엇이 달라졌는지 순서대로 설명하는 것이다.
예제에서는 마감하지 않은 날에 가짜 주문 두 건을 준비한다. 하나는 샌드위치 두 개, 다른 하나는 커피 한 잔이다. 담당자 화면을 열고 커피 주문을 취소한다. 직후에는 커피 합계가 0잔이다. 같은 날의 집계 화면을 새로고침하면 다시 1잔이다. 주문 규칙상 취소 기록은 남되 집계에는 포함되지 않아야 하므로 기대값은 계속 0잔이다.
이제 같은 순서로 확인하는 다른 사람도 어디에서 문제가 나타나는지 알 수 있다. 주문 두 건을 넣기 전의 빈 집계부터 재현에 필요하지 않은 메뉴와 설정을 빼면, 결과에 영향을 주는 조건이 드러난다. 한 가지 예외는 특정 기기나 주문 상태에서만 발생하는 문제다. 그 조건을 빼고 문제가 사라졌다면, 그 차이가 조사 단서다. 처음 보고한 사람이 틀렸다고 결론 내릴 이유는 없다.
화면에서 거꾸로 따라가며 첫 불일치를 찾는다
취소를 누른 직후 0잔이 보였다는 사실은 화면이 바뀌었다는 증거다. 저장된 주문의 상태도 바뀌었는지는 별도 확인이 필요하다. 새로고침 뒤 화면에 표시된 1잔부터 시작해, 집계 조회가 돌려준 값과 저장된 상태를 비교한다.
저장된 주문과 집계 조회의 값을 비교한다
| 확인 지점 | 가상으로 확인한 값 | 다음 판단 |
|---|---|---|
| 취소 요청 직후 | 서버가 성공을 응답했다 | 실제 저장된 주문 상태를 읽는다 |
| 저장된 커피 주문 | 취소 상태다 | 취소 기능보다 집계 조회에 집중한다 |
| 새로고침 뒤 집계 조회 | 커피 1잔을 응답했다 | 집계를 만드는 경로가 취소 상태를 어떻게 읽는지 확인한다 |
| 화면 표시 | 받은 값과 같은 1잔을 표시했다 | 화면에 별도 보정을 추가할 이유가 없다 |
만약 조회가 0잔을 응답했는데 화면이 1잔을 표시했다면 방향이 달라진다. 예전에 받아 둔 집계가 새 응답을 덮는지 살펴볼 수 있다. 반대로 저장된 주문이 여전히 유효 상태라면 취소 요청의 저장 경로가 먼저다. 똑같이 “커피가 다시 나타났다”고 보이더라도 실제 수정 위치가 달라진다.
프로그램이 어떤 요청을 받았고 무엇을 돌려줬는지 남긴 기록을 로그라고 한다. 위 표를 채우는 데 로그가 도움이 되지만, 개발자가 모든 데이터를 기록할 필요는 없다. 이 경우 가짜 주문의 식별값과 상태, 집계 수량 정도면 비교할 수 있다. 실제 운영에서 비밀번호나 고객 정보까지 기록에 넣으면 조사와 무관한 정보가 남는다. 먼저 무엇을 구분해야 하는지 정하고 필요한 값만 확인한다.
가설 하나를 확인할 수 있는 질문으로 만든다
“저장이나 캐시 문제 같다”는 추측에는 확인할 대상이 여럿이다. 가설을 좁히면 한 번의 확인으로 다음 행동을 결정할 수 있다. 이 예제에서는 “마감 전 집계가 취소된 주문까지 합산하고 있다”로 잡는다. 저장 상태가 취소인 것은 이미 확인했으므로, 가짜 주문 두 건을 집계 계산에 넣어 어떤 주문이 수량 계산에 들어가는지 본다.
정상적으로 주문을 추가하면 집계가 늘어나는 기존 경로와 취소 뒤 다시 조회하는 경로를 비교하는 것도 도움이 된다. 같은 주문 상태를 쓰더라도 두 경로가 집계를 별도로 만든다면, 한쪽에만 취소 제외 조건이 들어갔을 수 있다. 최근 변경 내용은 이런 차이를 찾는 출발점이다. 수정 시점이 가까웠다는 이유만으로 원인으로 확정하지 않고, 그 변경이 문제를 재현하는 경로에 실제로 쓰이는지 본다.
예제의 조사에서는 마감 전 집계 조회가 취소 상태인 주문을 제외하지 않는다는 사실을 확인했다고 가정한다. 여기까지 오면 수정 목표를 한 문장으로 말할 수 있다. 마감 전 집계를 다시 읽을 때 취소된 주문을 합산에서 제외한다. 취소 기록을 지우거나 화면에서 수량을 한 번 더 빼는 방식은 필요하지 않다.
한 곳을 고친 뒤 원래 문제가 돌아오지 않는지 본다
먼저 같은 가짜 주문으로 테스트를 만든다. 커피를 취소한 다음 화면이 사용하는 집계 조회를 다시 실행해 0잔이 되는지 확인한다. 수정 전에는 1잔이라 실패하고, 수정 후에는 0잔이라 통과해야 한다. 저장 오류나 도구 문제로 처음 실패했다면 기대한 동작을 검사할 수 있도록 테스트부터 바로잡는다.
수정 뒤 취소된 커피가 집계에서 빠진다
새 테스트를 통과하면 취소하지 않은 샌드위치 두 개가 여전히 집계되는지도 본다. 취소 기록이 남는지, 이미 확정한 마감 집계가 바뀌지 않는지도 확인한다. 취소 제외 조건을 공유하는 다른 경로가 있다면 그 영향을 살펴보고, 테스트를 통과한 코드 변경을 하나의 기록으로 남긴다. 다음에 같은 일이 생겼을 때 확인한 동작과 이후 변경을 비교할 수 있다.
확인 결과를 전달할 때는 “취소 버그 수정”이라는 제목에 더해, 동일 절차에서 커피가 다시 나타나지 않았고 기존 주문과 마감 기록도 확인했다고 적는다. 직접 확인하지 않은 조건이 있다면 범위를 함께 남긴다. 이 가상의 조사에서 두 기기가 동시에 주문을 바꾸는 조건을 확인하지 않았다면 그 항목까지 통과했다고 보고할 수는 없다.
흔한 실수는 눈앞에서 숫자를 맞추고 끝내는 것이다
화면에서 커피 한 잔을 빼도록 만들면 지금 열린 탭에서는 정상으로 보인다. 하지만 다른 기기나 새로고침 뒤에는 서버가 보낸 1잔을 다시 보여 줄 수 있다. 이 상태에서 화면마다 보정을 추가하면, 나중에 서버에서 실제로 0잔을 보내기 시작했을 때 화면이 한 번 더 빼는 문제까지 생길 수 있다.
화면, 저장, 집계 코드를 동시에 손보는 방법도 원인을 가리기 쉽다. 한 번에 여러 가지를 바꾼 뒤 증상이 사라지면 어느 변경이 효과가 있었는지 알기 어렵다. 새로 만든 문제가 생겼을 때 되돌릴 범위도 커진다. 여러 번 시도했는데 같은 문제가 남으면, 어떤 가설을 어떤 결과로 기각했는지 정리하고 문제가 처음 나타나는 지점부터 다시 확인한다.
문제를 당장 운영에서 피해야 할 때는 우회와 수정을 구분해 기록한다. 담당자가 잠시 취소 내역을 보고 주방 수량을 대조하는 조치는 업무를 이어 가는 데 도움이 될 수 있다. 나중에 앱을 수정했다는 판단은 원래 재현 절차와 기존 기능을 확인한 뒤 내린다.
Superpowers를 쓸 때 AI에게 요구할 조사 결과
Superpowers의 systematic-debugging은 원인 조사, 정상 사례와 비교, 가설 검증, 수정 순서로 진행하도록 한다. 여러 부분이 연결된 문제는 각 부분에 어떤 값이 들어오고 나가는지 확인하게 한다. verification-before-completion은 수정 완료를 말하기 전에 검증을 실행하고 결과를 읽도록 요구한다. systematic-debugging 원문, verification-before-completion 원문
실무에서는 AI에게 가설과 관찰 결과를 구분해 달라고 하면 진행을 검토하기 쉽다. 다음과 같이 자신의 재현 절차를 먼저 붙여 보자.
가짜 주문에서 커피를 취소하면 직후에는 합계가 0잔인데, 같은 날 집계를 새로고침하면 1잔으로 돌아와. systematic-debugging으로 먼저 재현해 줘. 저장된 주문 상태, 집계 조회 결과, 화면 표시 중 어디서 처음 값이 달라지는지 보여 줘. 원인을 확인한 뒤 해당 경로만 고치고, 원래 절차와 기존 주문·마감 동작을 다시 확인해 줘.
도구가 코드를 읽거나 앱을 실행할 수 없는 상황이면, 확인하지 못한 지점을 알려 달라고 한다. 사용자는 화면에서 재현하거나 가짜 주문을 제공할 수 있고, AI는 확인 가능한 부분을 조사할 수 있다. 둘이 같은 기대값과 관찰 결과를 공유하면 추측을 수정과 혼동하는 일이 줄어든다.
더 구체적으로 묻고 답하기
Q1. 오류 메시지가 없는데도 버그라고 할 수 있나요?
기대한 동작과 실제 동작이 다르면 조사할 수 있다. 프로그램이 정상 응답을 보내면서 잘못된 수량을 돌려주는 경우도 있다. “오류 없음”이라는 화면보다 어떤 주문을 넣었고 기대값과 실제값이 각각 얼마였는지가 더 유용하다.
Q2. 제 기기에서만 문제가 나면 무엇을 전달해야 하나요?
문제가 난 화면, 주문 날짜, 마감 상태, 마지막으로 누른 동작을 적는다. 같은 조건으로 새 창이나 다른 기기에서 결과가 달라지는지도 비교한다. 두 환경에서 동시에 여러 설정을 바꾸면 무엇이 차이를 만들었는지 알기 어려우므로, 확인할 조건을 하나씩 바꾼다.
Q3. AI가 데이터베이스 문제라고 하는데 바로 고쳐도 되나요?
저장된 주문을 다시 읽었을 때 상태가 실제로 잘못돼 있는지 먼저 확인한다. 취소 상태가 제대로 남아 있다면 집계가 그 상태를 어떻게 사용하는지 보는 편이 맞다. AI에게 결론을 뒷받침하는 관찰값과, 다른 가능성을 배제한 근거를 요청하자.
Q4. 자꾸 발생하지 않는 문제도 테스트로 남길 수 있나요?
언제 발생하는지부터 좁혀야 한다. 예를 들어 취소 직후 다른 기기에서 조회할 때만 나타난다면, 두 행동의 순서를 일정하게 만들어 재현할 수 있는지 본다. 아직 조건을 찾지 못했다면 발생 시각과 순서를 기록한다. 한 번 재현에 실패한 것을 해결의 증거로 삼지 않는다.
Q5. 수정 후 무엇을 확인하면 다음 작업으로 넘어갈 수 있나요?
원래 신고를 재현한 절차에서 문제가 사라졌는지 확인하고, 그 수정이 닿는 기존 기능을 같이 점검한다. 예제에서는 취소 주문이 다시 집계되지 않고, 정상 주문은 여전히 합산되며, 기존 마감 기록도 유지되어야 한다. 확인 결과와 남은 항목을 기록한다. 다음 편에서는 이런 결과를 모아 실제 사용을 시작할 수 있는지 판단한다.
AI와 함께 작성했습니다. 주문 앱과 조사 결과는 설명을 위한 가상 예시입니다.
AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.
이미지 3장은 설명용 AI 일러스트이며 실제 촬영 사진이나 실험 기록이 아닙니다.
참고 자료
- systematic-debugging (2026.11.05 확인)
- verification-before-completion (2026.11.05 확인)
이 글의 이미지는 AI로 생성했습니다
바이브코딩으로 만든 앱, 언제부터 써도 될까 — Superpowers 활용 5편

같은 가지의 다른 글
- AI 소개팅, 전 애인과 나눈 대화까지 넘기시겠습니까?
- [가상 미래] 2029년, 자율주행 택시 동시 정지로 도심 마비
- [가상 미래] 2031년, 배송 드론 연쇄 추락으로 광장 통제
- [가상 미래] 2033년, 수직농장 화재에 인근 주거지 정전
- AI 회의 대리 참석, “그 약속 제가 한 게 아닌데요”
- [가상 미래] 부산행 침대가 대전에서 멈췄다
- 챗GPT·제미나이·클로드, 내 일에 맞는 AI 고르는 법
- AI한테 광고를 맡겨 봤더니… 깃허브 인기 광고 스킬과 실제 사례
- 2023년 2월 이후 생성형 AI가 줄인 직업들, 숫자로 보니
- 구글이 학교에게 던진 최후통첩: AI 거부하면 검색도 끊는다
- 바이브코딩 개발 계획, 어디까지 정해야 할까 — Superpowers 활용 2편
- 바이브코딩 구현, 한 기능을 어디까지 확인할까 — Superpowers 활용 3편
- 대선을 준비하는 AI, 캠프와 선거기관은 어떻게 쓰나
- 신규창업 공약 지키미. AI가 상상하는 살기 좋은 세상 1부
- 신규창업 공약 지키미. AI가 상상하는 살기 좋은 세상 2부
- 신규창업 공약 지키미. AI가 상상하는 살기 좋은 세상 3부
- AI 주식 매매 프로그램 1편|공시로 후보 종목 찾기
- AI 주식 매매 프로그램 2편|공시 후보표 자동화
- AI 주식 매매 프로그램 3편|백테스트의 착시 줄이기
- AI 주식 매매 프로그램 4편|모의주문과 체결 확인
- AI 주식 매매 프로그램 5편|손실을 키우지 않는 주문·중단 기준
- AI 에이전트
- 로봇
- 개인 AI
- 바이브코딩 첫 개발, 무엇부터 정해야 할까 — Superpowers 활용법
이미지: Cloudflare (@cf/black-forest-labs/flux-2-klein-9b)