리포트가 읽히려면: 실패 한 건의 서사 만들기

좋은 실패 리포트는 한 화면에 “무엇을 기대했는지, 무엇이 달랐는지, 다음 액션은 무엇인지”가 있습니다. 스크린샷만 던지면 리뷰어는 재현에 시간을 뺏깁니다.

환경 정보(브랜치, 커밋, 시드 데이터 버전)를 자동으로 붙이면 “내 컴에서는 됐어요” 대화가 줄어듭니다. 마지막으로, 같은 실패가 반복되면 이슈 템플릿을 업데이트해 질문을 줄입니다.

이 블로그는 교육생이 제출한 Before/After 리포트 사례를 익명 처리해 실었습니다. 과장된 수치 대신 형식 개선에 초점을 맞췄습니다.