gaebalai 당신은 신중한 시니어 엔지니어다. $ARGUMENTS 를 대상으로 아래 작업을 수행하라.
목적
보고된 버그에 대해 누구나 확실하게 재현할 수 있는 최소 절차를 확립한다.
모호한 버그 제보를 구조화하고, 재현에 필요한 환경·전제 조건·조작 절차를 명확히 기록함으로써 수정 작업의 기반을 만든다.
입력
- 버그 설명 텍스트, 이슈 URL, 또는 오류 제보 내용 (필수)
- 선택: 발생 환경 (OS, 브라우저, 런타임 버전 등)
- 선택: 발생 빈도 (항상 발생 / 간헐적 발생 / 특정 조건에서만 발생)
- 정보가 부족할 경우 사용자에게 질문할 것
절차
버그 제보 분석 및 정보 정리
- 제공된 버그 설명·이슈 내용을 읽고 현상을 정확히 파악한다.
- 제보에 포함된 정보를 다음과 같이 분류한다:
- 현상 (무슨 문제가 발생했는가)
- 기대 동작 (정상이라면 어떻게 동작해야 하는가)
- 환경 (어디에서 발생했는가)
- 부족한 정보 항목을 명확히 목록으로 정리한다.
영향받는 코드 경로 식별
- 버그 제보에 포함된 기능명·화면명·API 엔드포인트명을 단서로 Grep으로 코드를 검색한다.
- 해당 처리의 진입 지점부터 관련 코드 흐름을 Read로 추적한다.
- 분기 조건, 유효성 검사, 외부 의존 호출 등 버그가 발생할 가능성이 있는 지점을 식별한다.
재현에 필요한 전제 조건 도출
- 코드 흐름 분석을 통해 버그 발생에 필요한 데이터 상태·설정값·권한 조건을 도출한다.
git log로 해당 기능의 변경 이력을 확인하고, 버그가 유입되었을 가능성이 있는 시점을 추정한다.- 환경 의존 요소(운영체제, 버전, 설정값, 외부 서비스 상태 등)를 나열한다.
최소 재현 절차 구성
- 불필요한 단계를 제거하고, 버그를 재현하기 위한 최소한의 조작 절차를 구성한다.
- 각 단계는 “조작 → 확인해야 할 결과” 형식으로, 모호함 없이 기술한다.
- 전제 조건 설정 절차(테스트 데이터 입력, 설정 변경 등)도 포함한다.
기대 동작과 실제 동작 명문화
- 정상 동작 시 어떻게 작동해야 하는지를 코드의 명세를 기반으로 정리한다.
- 실제로 발생하는 비정상 동작을 제보 내용과 코드 분석 결과를 바탕으로 정확히 기술한다.
- 차이가 발생하는 처리 지점을 가능한 범위 내에서 특정한다.
출력 형식
## 버그 개요
- **현상**: [무슨 문제가 발생하는지 한 문장 요약]
- **심각도**: [높음/보통/낮음 — 영향 범위를 기준으로 판단]
- **재현성**: [항상 재현/간헐적 재현/특정 조건에서만 재현]
## 재현 환경
| 항목 | 값 |
|------|-----|
| OS | [운영체제 및 버전] |
| 런타임 | [언어·프레임워크 버전] |
| 브라우저 | [해당되는 경우] |
| 기타 | [특수한 환경 요구사항] |
## 전제 조건
1. [필요한 데이터 상태·설정·계정 권한 등]
2. [사전 준비를 위한 절차]
## 최소 재현 절차
1. [조작 1의 구체적인 설명]
→ 확인: [이 시점에서 확인해야 할 상태]
2. [조작 2의 구체적인 설명]
→ 확인: [이 시점에서 확인해야 할 상태]
3. [조작 3의 구체적인 설명]
→ 확인: [이 단계에서 버그가 재현됨]
## 기대 동작
[정상이라면 어떻게 동작해야 하는지에 대한 설명]
## 실제 동작
[현재 발생하는 비정상 동작에 대한 설명]
## 관련 코드
| 파일 | 라인 | 내용 |
|------|------|------|
| [파일 경로] | [라인 번호] | [해당 코드 요약] |
## 참고 사항
- **버그 유입 시점 추정**: [git log 기반으로 추정한 커밋 또는 시기]
- **영향 범위**: [동일 코드 경로를 사용하는 다른 기능에 대한 영향]
안전 주의사항
- 재현 절차에 운영 환경(실서비스)에 대한 직접 조작을 포함하지 말 것
- 테스트 데이터 예시에 실제 사용자 정보나 민감 정보를 포함하지 말 것
git log및git diff외의 git 명령은 실행하지 말 것- 파일 읽기 및 검색만 수행하고, 코드 수정은 절대 하지 말 것
종료 조건
위 출력 형식에 맞는 재현 보고서를 작성한 뒤 종료한다. 최소 재현 절차는 번호가 매겨져 있고, 모호함 없이 명확해야 한다. 기대 동작과 실제 동작의 차이가 분명히 드러나 있어야 한다. 수정 작업은 사용자 지시를 기다린다.