topic★★★★★난이도 · 약 15분

에러와 소통하는 법 — 좋은 에러 보고의 기술

에러 메시지 해독법, 좋은 버그 리포트 작성법, AI에게 에러를 효과적으로 설명하는 요령.

#에러#디버깅#버그리포트#소통#GitHub

왜 배우는가

에러는 적이 아니라 대화 상대다. 에러 메시지를 읽고 구조화해서 전달하는 능력은 바이브코더가 AI와 협업할 때, 그리고 팀에서 일할 때 모두 핵심이 되는 소통 역량이다.

초보 바이브코더가 가장 당황하는 순간은 빨간 에러 메시지를 만났을 때다. 하지만 에러 메시지는 사실 컴퓨터가 보내는 도움 요청이다. 무엇이 잘못되었고, 어디서 발생했는지 알려주고 있다. 이것을 읽는 법을 배우면 에러가 더 이상 두렵지 않다.

에러 구성 요소	설명	예시
에러 타입	어떤 종류의 문제인지	TypeError, SyntaxError, 404 Not Found
에러 메시지	무엇이 잘못되었는지	"Cannot read properties of undefined"
스택 트레이스	어디서 발생했는지 (파일명 + 줄 번호)	at UserProfile.tsx:42
컨텍스트	어떤 상황에서 발생했는지	로그인 후 프로필 페이지 접속 시

markdown

## 좋은 버그 리포트 템플릿

### 제목
[페이지/기능] 어떤 문제가 발생하는가 (한 줄)

### 재현 절차
1. OO 페이지에 접속한다
2. OO 버튼을 클릭한다
3. OO을 입력하고 엔터를 누른다

### 기대 결과
OO이 표시되어야 한다

### 실제 결과
OO 에러가 발생하며 화면이 멈춘다

### 에러 메시지
`TypeError: Cannot read properties of undefined (reading 'name')`

### 환경
- 브라우저: Chrome 125
- OS: Windows 11
- 시간: 2026-04-12 14:30

이 템플릿을 습관적으로 사용하면 AI에게 에러를 설명할 때도, 팀원에게 이슈를 보고할 때도 훨씬 빠르게 해결된다.

bash

# AI에게 에러를 효과적으로 전달하는 프롬프트 패턴
claude "다음 에러를 해결해줘:

에러: TypeError: Cannot read properties of undefined (reading 'name')
파일: src/components/UserProfile.tsx:42
상황: 로그인하지 않은 사용자가 프로필 페이지 접속 시 발생
시도한 것: optional chaining(?.) 추가했으나 동일 에러

원인 분석과 해결책을 알려줘."

에러 타입 + 파일 위치 + 재현 상황 + 이미 시도한 것을 함께 전달하면, AI가 불필요한 추측 없이 정확한 해결책을 제시한다.

Stack Overflow와 GitHub Issues도 훌륭한 학습 자원이다. 검색할 때는 에러 메시지를 큰따옴표로 감싸서 정확히 검색하면 동일 에러를 겪은 사례를 빠르게 찾을 수 있다. 예: `"Cannot read properties of undefined" React`. 다른 사람의 질문과 답변을 읽는 것 자체가 디버깅 역량을 키우는 훈련이다.

에러 소통의 황금률: "안 돼요"는 최악의 보고, "OO을 했더니 OO 에러가 나오고, OO을 시도했지만 안 됐습니다"는 최고의 보고다. 이 구조만 지키면 AI든 사람이든 10배 빠르게 도와줄 수 있다.