Kjerr복사해서 쓸 수 있는
버그 리포트 템플릿.
좋은 버그 리포트 템플릿은 개발자가 한 번 읽고 바로 재현하게 합니다. 무슨 일이 있었고, 무슨 일이 있어야 했고, 어떤 단계였고, 어디서였는지. 아래 템플릿을 문서, 폼, 작업 트래커에 복사하거나, 파일도 받는 보드에 같은 필드를 설정하세요.
버그 리포트 템플릿
일곱 가지 질문. 제목과 단계는 필수로, 나머지는 선택으로.
제목
무엇이 어디서 안 되는지. 한 문장.
예: CSV 내보내기가 빈 파일을 내려받음
무슨 일이 있었나요?
보이는 것을, 한두 문장으로.
무슨 일이 있어야 했나요?
대신 일어나야 했던 일.
재현 단계
1.
2.
3.
얼마나 자주?
매번, 가끔, 한 번.
어디서?
브라우저나 앱 버전, 운영 체제, 계정이나 워크스페이스.
보여줄 것이 있나요?
스크린샷, 화면 녹화, 로그, HAR 파일.
버그 리포트 예시
같은 템플릿을 채운 것. 제품과 숫자는 가상입니다.
제목
CSV 내보내기가 빈 파일을 내려받음
무슨 일이 있었나요?
리포트 페이지에서 내보내기를 클릭하면 파일이 내려받히지만
헤더 행만 있습니다.
무슨 일이 있어야 했나요?
화면의 표에 보이는 214개 행이 든 파일.
재현 단계
1. 리포트를 열고 최근 30일을 선택합니다.
2. 요금제 “Scale”로 필터링합니다.
3. 내보내기, 그다음 CSV를 클릭합니다.
얼마나 자주?
필터를 켠 채로는 매번. 필터 없이는 내보내기가 됩니다.
어디서?
macOS 15의 Chrome 141. 워크스페이스: northwind.
보여줄 것이 있나요?
export.csv (빈 파일), reports.har
각 필드가 있는 이유
- 제목. 무엇이 어디서 안 되는지. 나중에 찾을 수 있고 중복이 만나게 하기 위해.
- 무슨 일이 있었나요? 누가 해석하기 전의, 신고한 사람의 말로 된 증상.
- 무슨 일이 있어야 했나요? 리포트의 절반은 오해이고, 이 줄이 어느 쪽인지 보여줍니다.
- 재현 단계. 개발자가 추측할 수 없는 부분. 번호를 붙여, 한 단계에 한 동작.
- 얼마나 자주? “매번”은 로직을, “가끔”은 타이밍이나 데이터를 가리킵니다.
- 어디서? 브라우저, 버전, 계정이 어떤 설명보다 범위를 좁힙니다.
- 보여줄 것이 있나요? 녹화나 로그 하나가 세 문단을 대신합니다.
템플릿을 버그 신고 폼으로 만드는 방법
버그 신고 폼은 템플릿보다 적게 물어야 합니다. 필수 필드 하나마다 리포트 몇 개가 사라지고, 빠진 리포트는 빠진 세부 사항보다 비쌉니다.
- 제목과 재현 단계만 필수로 하세요.
- 각 필드에 예시를 안내 문구로 보여줘서 기대하는 상세 수준이 보이게 하세요.
- 폼을 제출하기 전에 비슷한 리포트를 보여줘서 중복 대신 투표를 추가할 수 있게 하세요.
- 파일을 폼에 끌어다 놓아 추가할 수 있게 하세요.
- 다음에 무슨 일이 있는지 말하세요. 리포트가 어디에 나타나고 답은 어떻게 오는지.
버그 리포트에 무엇을 첨부할까
증거가 대화를 짧게 합니다. 요청할 가치가 있는 파일들이고, 각각 다른 것을 판가름합니다.
- 스크린샷, 눈에 보이는 모든 것에.
- MP4 화면 녹화, 단계를 말로 설명하기 어려울 때.
- HAR 파일, 페이지가 로드되지 않거나 저장되지 않거나 내보내지지 않을 때.
- 콘솔이나 서버 로그, TXT나 LOG로.
- 이메일 자체를 EML로, 전송과 서식 문제일 때.
- 가져올 수 없었던 CSV, XLSX, JSON 파일, 또는 잘못 나온 파일.
Kjerr 보드에서 버그 리포트 모으기
Kjerr 보드는 템플릿의 질문을 묻고 증거를 보관할 수 있습니다. 무엇이 새로운지는 팀이 피드백 관리가 이루어지는 곳에서 봅니다.
- 폼은 편집할 수 있습니다. “재현 단계”, “무슨 일이 있어야 했나요”, “어디서” 필드를 직접 추가하세요. 모두 합쳐 최대 10개, 각각 필수 또는 선택, 자기 안내 문구와 함께.
- 리포트와 댓글마다 10 MB 파일 최대 5개: 이미지, PDF, EML, TXT, LOG, CSV, JSON, HAR, ZIP, DOCX, XLSX, PPTX, MP4.
- 제목을 입력하는 동안 비슷한 리포트가 투표 버튼과 함께 나타납니다.
- QA 보드라면 멤버 전용으로 설정하고 로그인을 회사 이메일 도메인으로 제한하세요. 온라인 건의함과 같은 설정입니다.
- 상태가 Shipped로 바뀌면 신고한 사람과 모든 투표자가 이메일을 받습니다.
- 작업 트래커가 아닙니다. 담당자, 심각도, 스프린트는 없습니다.
자주 묻는 질문과 간단한 답.
버그 리포트 템플릿이란 무엇인가요?
버그 리포트 템플릿은 모든 리포트에서 같은 사실을 끌어내는 고정된 질문 모음입니다. 무슨 일이 있었고, 무슨 일이 있어야 했고, 어떻게 재현하고, 어디서 일어났는지. 덕분에 개발자는 추가 질문 한 바퀴 없이 읽기에서 재현으로 넘어갑니다.
버그 리포트에는 무엇이 들어가야 하나요?
한 문장의 제목, 무슨 일이 있었고 무슨 일이 있어야 했는지, 번호가 붙은 재현 단계, 얼마나 자주 일어나는지, 환경, 그리고 스크린샷이나 로그 같은 증거. 필수를 둘만 둘 수 있다면 제목과 단계로 하세요.
버그 리포트와 기능 요청은 무엇이 다른가요?
버그 리포트는 제품이 약속한 것을 하지 않는다고 말합니다. 기능 요청은 제품이 약속한 적 없는 것을 요청합니다. 다른 질문이 필요하고, 후자에는 기능 요청 템플릿을 쓰세요.
재현 단계는 어떻게 잘 쓰나요?
누구나 도달할 수 있는 상태에서 시작하고, 한 줄에 한 동작을 쓰고, 입력하거나 선택한 정확한 값을 적으세요. 문제가 나타나는 단계에서 멈추세요. 어떤 단계가 가끔만 필요하다면 그렇다고 쓰세요.
HAR 파일이란 무엇이고 첨부할 가치가 있나요?
HAR 파일은 웹페이지가 보낸 요청의 기록으로, 브라우저 개발자 도구에서 저장합니다. 페이지가 로드되지 않거나 저장되지 않거나 내보내지지 않을 때 첨부하세요. 먼저 확인하세요. 세션 쿠키와 개인 정보가 들어 있을 수 있습니다.
Kjerr가 버그 트래커를 대신하나요?
아니요. Kjerr는 리포트를 모으고, 중복을 없애고, 상태가 바뀌면 신고한 사람에게 알립니다. 담당자, 심각도, 스프린트가 없고 Jira, Linear 동기화도 없습니다. 팀은 Kjerr를 현관으로 쓰고 작업 트래커는 그 뒤에 둡니다.
관련 페이지
사용자에게 답을 돌려주세요.
얼리 액세스 기간 동안 Kjerr는 무료입니다. 모든 기능이 포함되고 신용카드는 필요 없습니다. 유료 요금제가 나오면 워크스페이스 단위로 책정되며, 관리자 시트당 과금은 하지 않습니다.