기획·QA · 점검 노트
버그 재현 단계를 숫자로 적었는지 확인
재현 단계에 '여러 번 누르면 멈춤'이라고 적힌 리포트를 받은 개발자는 몇 번을 눌러야 하는지부터 다시 물어야 합니다. 숫자 하나가 빠진 재현 단계는 확인 시간을 늘리고, 숫자가 정확한 단계는 대화를 줄여 줍니다.
작업 노트 710 · 읽는 시간 약 5분 · 2026.11.17 정리
단계마다 순서 번호가 붙어 있는가
첫 항목은 재현 단계가 1, 2, 3처럼 번호가 붙은 목록으로 적혀 있는지입니다. 한 문단 안에 '로비에서 상점에 들어가 아이템을 고르고 구매하면'처럼 이어 쓰면, 읽는 사람이 어느 동작에서 문제가 생기는지 구분하기 어렵습니다. 번호가 있으면 '3번 단계 이후에 멈춤'처럼 위치를 정확히 짚어 대화할 수 있습니다. 번호는 리포트를 읽는 모든 사람이 같은 위치를 가리키는 좌표가 됩니다.
번호를 붙일 때는 한 번호에 동작 하나만 넣습니다. '2. 상점을 열고 아이템을 고른다'는 동작이 두 개이니 2번과 3번으로 나눕니다. 동작이 쪼개져 있어야 개발자가 각 단계에서 어떤 코드가 실행되는지 따라가기 쉽습니다. 마지막 번호에는 문제가 나타나는 동작을 두고, 그 아래에 실제 결과를 따로 적습니다.
빠져 있다면 지금 문단을 동작 단위로 끊어 번호를 붙입니다. 끊고 나서 각 번호를 그대로 따라 해 보면, 중간에 빠진 동작이 발견되는 경우가 많습니다. 예를 들어 상점에 들어가기 전에 특정 탭을 눌러야 했다면 그 동작을 번호 사이에 끼워 넣습니다. 끼워 넣은 뒤에는 번호를 처음부터 다시 매깁니다.
반복 횟수와 발생 빈도가 적혀 있는가
두 번째 항목은 반복이 필요한 동작에 횟수가 적혀 있는지입니다. '버튼을 빠르게 연타'가 아니라 '버튼을 1초 안에 5회 누름'처럼 씁니다. 또한 같은 단계를 몇 번 시도했을 때 몇 번 문제가 생겼는지, 즉 발생 빈도도 적습니다. '10회 시도 중 3회 발생'처럼 적으면 확인하는 사람이 몇 번 정도 시도해야 할지 판단할 수 있습니다.
이 항목을 보는 이유는 가끔만 생기는 버그가 많기 때문입니다. 빈도가 적혀 있지 않으면 확인하는 사람이 한두 번 해 보고 재현되지 않는다며 이슈를 돌려보낼 수 있습니다. 빈도는 우선순위를 정할 때도 쓰입니다. 매번 생기는 문제와 가끔 생기는 문제는 처리 순서가 다를 수 있습니다. 빈도 정보는 수정 뒤 재확인할 때도 기준이 됩니다.
빈도를 적지 않았다면 같은 단계를 정해진 횟수만큼 다시 시도해 결과를 셉니다. 시도 횟수는 팀에서 정한 기준이 있으면 그것을 따르고, 없다면 처음부터 같은 횟수로 정해 두고 셉니다. 재현이 한 번도 안 됐다면 그 사실도 적고, 처음 발생했을 때의 상황을 최대한 자세히 덧붙입니다.

시간과 수량 조건이 숫자로 들어가 있는가
세 번째 항목은 시간과 수량 조건입니다. '잠시 기다린 뒤'는 '약 30초 대기 후'로, '재화가 많을 때'는 '골드 보유량 1,000 이상일 때'처럼 바꿉니다. 게임 버그는 특정 시간이 지나거나 특정 수량을 넘을 때 생기는 경우가 많아서, 이런 조건이 빠지면 재현 자체가 되지 않을 수 있습니다. 단위도 함께 적어야 숫자의 뜻이 분명해집니다.
이 항목은 특히 경계값과 관련된 버그에서 중요합니다. 가방이 꽉 찬 상태에서 아이템을 받을 때, 재화가 가격과 정확히 같을 때처럼 숫자의 경계에서 문제가 생기면, 그 경계값을 적어 주는 것이 원인을 찾는 가장 빠른 길입니다. '가방 칸 50칸 중 50칸 사용 중'처럼 현재 값과 최대값을 함께 적습니다.
숫자를 모를 때는 화면에 보이는 값을 캡처해 첨부하고 단계에도 적어 둡니다. 시간 조건은 스마트폰 스톱워치로 대략 재도 충분합니다. 정확한 수치를 모르는 경우 '약'을 붙여 대략적인 값임을 표시하면, 읽는 사람이 오차를 감안하고 확인할 수 있습니다. 대략값과 정확한 값은 표시를 달리해 섞이지 않게 합니다.
환경 정보의 숫자가 빠짐없이 있는가
네 번째 항목은 환경 정보입니다. 빌드 번호나 게임 버전, 기기 모델, 운영체제 버전이 숫자까지 정확히 적혀 있는지 봅니다. '최신 빌드'라고만 쓰면 하루에도 여러 번 빌드가 바뀌는 개발 환경에서는 어느 빌드인지 알 수 없습니다. 빌드 번호는 대개 게임 화면 구석이나 설정 화면에서 확인할 수 있습니다. 버전 숫자는 자리 하나만 틀려도 다른 빌드를 가리키니 복사해 붙이는 편이 안전합니다.
테스트용 계정이나 캐릭터의 상태도 숫자로 적으면 좋습니다. 캐릭터 레벨, 진행 중인 퀘스트 단계, 보유한 아이템 수 같은 정보입니다. 같은 동작이라도 캐릭터 레벨에 따라 결과가 달라지는 버그가 있어서, 이 정보가 있으면 확인하는 사람이 비슷한 상태의 계정을 준비할 수 있습니다.
환경 정보는 매번 새로 쓰기보다 양식의 고정 칸으로 만들어 두는 것이 실수를 줄입니다. 리포트 양식 위쪽에 빌드, 기기, 운영체제, 계정 상태 칸을 두고 빈칸이 있으면 등록하지 않는 규칙을 스스로 정합니다. 칸이 정해져 있으면 바쁠 때도 빠뜨리지 않습니다. 양식은 팀원과 함께 써서 칸 이름을 통일합니다.

등록 직전 마지막 확인 순서
등록하기 직전에는 내가 쓴 재현 단계를 처음 보는 사람처럼 다시 한번 따라 해 봅니다. 번호 순서대로, 적힌 횟수와 시간 그대로 실행해서 같은 문제가 나오는지 확인합니다. 따라 하다가 '여기서 몇 번?', '얼마나 기다리지?'라는 질문이 떠오르는 곳이 있다면 그곳에 숫자가 빠진 것입니다. 따라 하는 동안에는 이전 기억이 아니라 적힌 글만 보고 움직입니다.
그다음 제목을 봅니다. 제목에도 핵심 조건의 숫자가 들어가면 목록에서 이슈를 구분하기 쉬워집니다. '가방 50칸 가득 찬 상태에서 우편 보상 수령 시 아이템 사라짐'처럼 쓰면, 비슷한 이슈가 이미 등록됐는지 검색할 때도 도움이 됩니다. 중복 등록을 막는 것도 리포트 품질의 일부입니다. 검색에 쓰일 핵심 단어도 제목 앞쪽에 둡니다.
숫자가 들어간 재현 단계를 쓰는 습관은 연습으로 빠르게 늘어납니다. 내가 쓴 리포트가 실무 기준에 맞는지 확인받고 싶다면, SBS아카데미게임학원 게임QA 과정 무료 상담에서 써 둔 리포트를 보여 주고 보완할 부분을 함께 찾아보세요.
자주 묻는 질문
숫자를 너무 자세히 쓰면 오히려 읽기 어렵지 않나요?
문제와 관련 있는 숫자만 적으면 됩니다. 재현에 영향을 주지 않는 값까지 모두 적을 필요는 없고, 확신이 없을 때는 첨부 캡처로 보완합니다.
재현 단계는 몇 단계가 적당한가요?
정해진 수는 없지만, 처음 상태에서 문제가 생기는 동작까지 빠짐없이 가장 짧게 가는 경로로 정리하는 것이 좋습니다.

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