기획·QA · 작업물 뜯어보기
좋은 버그 리포트와 나쁜 버그 리포트 비교
같은 버그를 두 사람이 리포트했습니다. 한 리포트는 '보상 안 들어옴, 확인 바람' 한 줄이고, 다른 리포트는 환경과 절차, 재현율, 화면 녹화가 정리되어 있습니다. 앞의 리포트는 개발자와 질문을 몇 번 주고받은 뒤에야 작업이 시작되고, 뒤의 리포트는 읽자마자 원인을 찾기 시작합니다. 두 리포트를 칸별로 나란히 놓고 차이를 뜯어봅니다.
작업 노트 595 · 읽는 시간 약 5분 · 2026.11.17 정리
비교에 쓸 가상의 버그
가상의 상황을 하나 정합니다. 일일 퀘스트를 완료하고 보상 받기 버튼을 누르는 순간 앱을 내렸다가 다시 열면, 퀘스트는 완료 상태로 바뀌었는데 보상은 지급되지 않은 버그입니다. 열 번 시도하면 네 번 정도 나타나고, 와이파이에서 모바일 데이터로 바뀌는 순간에 특히 잘 나타난다고 가정합니다. 이용자 입장에서는 보상을 잃는 문제라 가볍지 않습니다.
이 버그는 리포트로 전달하기가 꽤 까다로운 편입니다. 매번 나타나지 않고, 앱을 내리는 타이밍이라는 조건이 붙어 있으며, 네트워크 상태가 관련되어 있기 때문입니다. 이런 버그일수록 리포트의 품질 차이가 개발 시간의 차이로 크게 이어집니다. 그래서 좋은 리포트와 나쁜 리포트를 비교하기에 알맞은 예입니다.
비교의 기준은 '개발자가 이 리포트만 보고 버그를 다시 만들 수 있는가'입니다. 리포트를 읽는 개발자는 버그를 처음 보는 사람이고, 발견한 사람의 머릿속에 있던 맥락을 전혀 모릅니다. 따라서 리포트는 그 맥락을 빠짐없이 옮겨 담는 그릇이어야 합니다. 이 기준으로 칸 하나하나를 살펴봅니다.
칸별로 나란히 놓아 보기
| 칸 | 나쁜 리포트 | 좋은 리포트 |
|---|---|---|
| 제목 | 보상 안 들어옴 | [일일 퀘스트] 보상 수령 직후 앱 백그라운드 전환 시 퀘스트만 완료되고 보상 미지급 |
| 환경 | 없음 | 기기 모델, 운영체제 버전, 게임 빌드 번호, 와이파이에서 모바일 데이터로 전환 |
| 재현 절차 | 퀘스트 깨고 보상 받으면 안 됨 | 1) 일일 퀘스트 완료 2) 보상 받기 누름 3) 1초 안에 앱을 내림 4) 다시 열어 우편함 확인 |
| 결과 | 보상이 없음 | 기대: 보상 지급, 퀘스트 완료 / 실제: 퀘스트 완료, 보상 없음, 재수령 불가 |
| 재현율·심각도 | 없음 | 4/10, 높음(보상 손실, 복구 수단 없음) |
| 첨부 | 없음 | 화면 녹화 1개, 우편함 캡처에 표시 |
표로 놓고 보면 나쁜 리포트는 버그가 있다는 사실만 알려 주고, 좋은 리포트는 버그를 다시 만드는 방법까지 알려 준다는 차이가 분명합니다. 나쁜 리포트를 받은 개발자는 어떤 퀘스트인지, 어떤 기기인지, 언제 앱을 내렸는지를 묻는 데서 일을 시작해야 합니다. 그 질문과 답이 오가는 사이에 하루가 지나기도 합니다. 결국 리포트의 품질은 팀 전체의 시간과 바로 연결됩니다.

제목과 환경: 읽기 전에 판단하게 하기
개발자와 일정 담당자는 버그 목록을 제목으로 먼저 훑습니다. '보상 안 들어옴'은 수십 개의 비슷한 제목 사이에서 구분되지 않고, 어느 기능인지도 알 수 없습니다. 좋은 제목은 머리말로 기능 위치를 밝히고, 조건과 현상을 한 문장에 담습니다. 그래서 목록에서 클릭하기 전에도 담당자를 정하고 우선순위를 가늠할 수 있습니다.
환경 칸이 비어 있으면 개발자는 자기 기기에서 재현을 시도하다 실패하기 쉽습니다. 이 버그처럼 네트워크 전환이 관련되어 있다면, 환경 정보 없이는 재현 자체가 거의 불가능합니다. 빌드 번호도 중요합니다. 이미 고쳐진 버전에서 테스트하는 헛수고를 막고, 어느 업데이트에서 문제가 생겼는지 추적하는 단서가 됩니다.
좋은 리포트는 '버그와 관련 있어 보이는 환경'을 강조합니다. 모든 정보를 같은 무게로 나열하기보다, 네트워크 전환처럼 발견자가 의심하는 조건에 표시를 해 두는 것입니다. 이렇게 하면 개발자는 원인을 추적할 출발점을 얻습니다. 단, 의심은 의심으로 표시하고 확정된 사실처럼 쓰지 않습니다.
절차와 결과: 다시 만들 수 있게 하기
나쁜 리포트의 절차인 '퀘스트 깨고 보상 받으면 안 됨'에는 이 버그의 핵심 조건인 앱을 내리는 동작이 빠져 있습니다. 발견자에게는 너무 당연해서 적지 않았지만, 그 한 동작 없이는 버그가 나타나지 않습니다. 좋은 리포트는 '1초 안에'처럼 타이밍까지 적어서, 개발자가 같은 조건을 만들 수 있게 합니다.
결과 칸에서 좋은 리포트는 기대 결과와 실제 결과를 나란히 씁니다. 그리고 '재수령 불가'처럼 이용자가 입는 피해까지 적습니다. 이 한 마디가 심각도 판단의 근거가 됩니다. 나쁜 리포트의 '보상이 없음'은 우편함에 없는 것인지, 인벤토리에 없는 것인지, 다시 받을 수 있는지조차 알려 주지 않습니다.
재현율 4/10은 이 버그가 가끔 나타난다는 사실을 미리 알려 줍니다. 개발자가 두세 번 시도해 재현에 실패하더라도 버그가 없다고 결론 내리지 않고, 여러 번 반복해 볼 이유가 생깁니다. 재현율이 없으면 '재현 안 됨'으로 닫히는 리포트가 늘어납니다. 화면 녹화는 이 모든 설명을 한 번에 확인시켜 주는 증거입니다.

내 리포트를 비교표로 점검하기
자신이 쓴 리포트를 이 비교표의 왼쪽 칸과 오른쪽 칸에 대어 보세요. 빈칸이 있는지, 절차에 당연하게 여긴 동작이 빠지지 않았는지, 결과에 피해 범위가 적혔는지를 확인합니다. 특히 제목만 읽고 기능 위치와 현상을 말할 수 있는지가 가장 빠른 점검 방법입니다. 다른 사람이 쓴 리포트로도 같은 점검을 해 보면 눈이 빨리 길러집니다.
좋은 리포트가 항상 긴 리포트는 아닙니다. 필요한 정보가 빠짐없이 있으면서 불필요한 감상이나 추측은 없는 리포트가 좋은 리포트입니다. '정말 짜증 나는 버그'나 '서버가 이상한 듯' 같은 말은 개발자의 판단을 돕지 않습니다. 관찰한 사실을 정확하게 쓰는 것만으로 리포트의 품질은 크게 올라갑니다.
SBS아카데미게임학원 게임QA 과정은 버그 리포트와 파트별 리포트 작성을 실습하고, 실제 게임 빌드로 테스트한 결과를 QA 포트폴리오로 정리합니다. 내가 쓴 리포트가 비교표의 어느 쪽에 가까운지 판단이 어렵다면 무료 상담에서 함께 살펴보세요.
자주 묻는 질문
버그 하나에 리포트 하나가 원칙인가요?
대부분의 팀이 그렇게 합니다. 여러 버그를 한 리포트에 묶으면 하나만 고쳐지고 나머지가 묻히기 쉽기 때문입니다.
원인을 알 것 같으면 적어도 되나요?
적어도 됩니다. 다만 관찰한 사실과 구분해 비고 칸에 '추정'이라고 밝혀 두어야 개발자가 판단을 그르치지 않습니다.

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.
과정 보기 →