---
name: bug-report-ko
description: "버그를 보고하거나, 이슈를 쓰거나, 에이전트나 동료에게 버그 수정을 넘길 때 쓴다. 사용자가 \"버그 리포트\", \"이슈 작성\", \"이거 안 돼\"라고 할 때 쓴다."
---

# 버그 재현과 보고서

## 먼저 재현한다

1. 사용자가 말한 증상을 한 문장으로 정리한다.
2. 가장 짧은 재현 단계를 찾는다. 재현되지 않으면 그 사실과 시도한 단계를 적는다.
3. 늘 생기는지, 가끔 생기는지, 어떤 조건에서만 생기는지 적는다.

## 보고서 꼴

- 제목: 어디서 무엇이 어떻게 잘못되는지 한 줄
- 재현 단계: 번호 목록
- 기대한 동작과 실제 동작
- 환경: 운영체제, 브라우저, 버전, 계정 종류
- 오류 메시지와 로그: 자르지 않고, 비밀 값은 가리고
- 화면 캡처나 영상 자리
- 원인 후보: 확인한 것과 추측을 나눠서
- 영향: 누가, 얼마나 자주, 우회 방법이 있는지

## 지킬 것

- 추측을 사실처럼 쓰지 않는다.
- 개인정보와 비밀 값은 가린다.
- 하나의 보고서에 버그 하나.
