복잡한 AI 코딩 세션을 GitHub 이슈용 버그 리포트로 바꾸는 예시

AI 코딩 세션은 디버깅 과정이고, GitHub 이슈는 재현 가능한 보고서입니다. 둘을 같은 순서로 쓰면 리뷰어가 핵심을 찾기 어렵습니다.

먼저 결론부터

AI 코딩 세션은 탐색 기록이라 그대로 보내면 GitHub 이슈가 흐려집니다. 리뷰어에게는 재현 절차, 로그, 기대 결과가 먼저 필요합니다.

그래픽 다운로드

상황

Codex와 긴 세션으로 로그인 오류를 조사했습니다. 원본에는 실패한 명령, 임시 가설, 로그 일부, 최종 재현 조건이 섞여 있습니다.

개발팀이 보는 곳이 GitHub issue나 Jira라면 최종 재현 조건, 관련 로그, 아직 확인하지 않은 가설만 필요합니다. 실패한 시도는 “이미 제외한 것”으로 짧게 남기고, 내부 토큰이나 로컬 경로는 공유 전에 지웁니다.

변환 전: 원본 상태

• 실패한 접근이 너무 많음
• 최종 재현 조건이 아래쪽에 묻힘
• 환경 정보와 기대 결과가 분리되지 않음

원본에는 실패한 명령, 임시 가설, 중간 로그, 최종 재현 조건이 시간순으로 섞여 있습니다.
정리본에서는 실패 기록을 줄이고 다시 실행 가능한 정보만 남깁니다.

변환 후: 공유 가능한 결과물

# 버그 리포트

## 증상
로그인 후 대시보드가 빈 화면으로 남습니다.

## 재현 절차
1. 테스트 계정으로 로그인
2. /dashboard 이동
3. 첫 로드에서 목록이 비어 있는지 확인

## 확인한 로그
| 로그 | 의미 |
| --- | --- |
| 401 on /api/highlights | 세션 전달 실패 가능성 |
| 재시도 후 200 | 초기 요청 경합 의심 |

## 다음 행동
- 세션 쿠키 전달 테스트 추가
- 로딩 상태와 빈 상태 분리

변환에서 바뀐 것

AI와 주고받은 모든 명령을 남기지 않고, 재현 절차와 확인한 로그만 GitHub 이슈 형식으로 재배치했습니다. PR 코멘트에는 최종 판단만 붙이면 됩니다.

목적지별 변형

Highlight Reel을 쓸 자리

Highlight Reel은 코딩 세션에서 최종 판단에 영향을 준 메시지만 공유하는 데 맞습니다. GitHub 이슈에는 재현 가능한 보고서를 쓰고, 링크에는 필요한 대화 근거만 붙이세요.