# See It First

> Forces reproduction before any fix. When something doesn't work, this skill stops the symptom→guess→patch loop and first reproduces the bug locally on the same branch, data, and inputs the user saw — because an unreproduced bug is an unsolved one. 버그·이상 동작 앞에서 추측 패치의 유혹을 끊고, 먼저 눈앞에 똑같이 재현하게 만드는 엔지니어링 철학 스킬.

- Skill: `kwakseongjae/see-it-first` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kwakseongjae/see-it-first`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kwakseongjae/see-it-first/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kwakseongjae (https://skillmd.com/u/kwakseongjae)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kwakseongjae/see-it-first

---


> **한 줄.** 버그는 *고치기* 전에 *재현*한다. 못 본 버그는 고친 게 아니다.

## Why this mindset

버그 앞에서 가장 큰 유혹은 *증상 → 추측 → 패치*입니다. 그러나 못 본 버그는 고친 게 아닙니다.
일단 내 눈앞에 *똑같이 다시 띄우는 것*에서 시작합니다. 재현이 되면 절반은 풀린 것입니다.
재현 안 되는 버그는 추측으로 사라진 게 아니라, 다음에 더 큰 모습으로 돌아옵니다.

## Instructions

증상을 들으면 코드부터 펴고 싶어진다. 한 번 멈추고, 먼저 본다.

1. **재현 조건을 받아 적는다.**
   *언제·어디서·어떤 입력·어떤 결과·기대한 결과*. 다섯 칸이 채워지면 재현은 거의 자동으로 따라온다. 비개발자에게 묻는 법: "조금 전에 어떤 화면에서 → 뭘 눌렀더니 → 뭐가 떴어요? 원래는 어떻게 돼야 했어요?"

2. **같은 환경을 만든다.**
   같은 브랜치, 같은 데이터, 같은 입력. 다르면 다른 버그를 잡게 된다. 재현 환경 정렬이 안 되면 (a) 정렬을 먼저 하고, (b) 사용자에게 *"내 환경에선 이렇게 보여요 — 같아요?"*로 확인한다.

3. **최소 재현으로 좁힌다.**
   재현되면 그 다음은 *불필요한 단계를 하나씩 빼는 것*. 10단계 → 7 → 4 → 2. 줄어들수록 원인은 분명해진다. "이거 한 줄만 있어도 터진다"까지 좁히면 가설은 거의 다 잡힌 거다.

4. **재현된 다음에 가설을 세운다.**
   재현 *전*에 세운 가설은 추측이고, 재현 *후*에 세운 가설은 관찰이다. 둘은 정확도가 다르다. 추측 패치로 *증상은 사라졌는데 원인은 모르는* 상태는 가장 위험한 마무리다.

5. **고친 뒤, *못 재현됨*을 확인한다.**
   같은 조건으로 다시 돌려서 *이번엔 안 터지는지*를 본 뒤에 "고쳤다"고 말한다. 가능하면 그 재현 조건을 테스트로 남긴다 — 다음에 같은 자리가 또 무너지지 않게.

## Examples

**"가끔 안 돼요"를 좁히기:**
- 사용자: "가끔 로그인이 안 된대요."
- Claude: "*가끔*을 좀 좁혀보자. (a) 특정 시간대인지, (b) 특정 브라우저인지, (c) 특정 계정인지, (d) 새 가입자인지 기존인지. 사용자에게 직전 단계 한 번 더 물어볼 수 있을까? 그거 있어야 재현돼."

**전언으로 끝내지 않기:**
- 사용자: "PM이 메인 페이지 깨졌대요."
- Claude: "내가 지금 메인 페이지 열어봤는데 잘 떠. *어떤 화면에서 깨졌는지·뭘 눌렀는지·스크린샷이나 에러 메시지*가 있어야 같은 걸 보고 시작할 수 있어. PM한테 한 줄만 더 받아줄 수 있을까?"

**재현된 다음:**
- Claude: "재현했어 — 빈 검색어로 엔터 치면 터져. 원인은 `query.trim()` 호출이 빈 문자열일 때 다음 줄에서 `query[0]`을 읽어서 그래. 고쳤고, 같은 입력으로 다시 돌려봤는데 이번엔 안 터져. 빈 검색어 케이스 테스트 한 줄도 같이 넣어둘게."

## Pitfalls

- 추측 → 패치 → 다시 발생 → 추측 → 패치… 무한 루프
- 재현 없이 *"고쳤어요"* 보고 → 며칠 뒤 같은 버그 재등장
- "가끔"·"이상하게" 같은 모호한 증상으로 시작해 안 좁히고 코드부터 뒤지기
- 재현이 어렵다고 *재현을 건너뛰고* 패치 → 보통 더 오래 걸린다
- 고친 뒤 *못 재현됨*을 확인 안 하기 → "맞아 진짜 안 터지는 건가?"

버그는 *적*이 아니다. *증거*다. 잘 보이는 자리에 갖다 놓으면, 그 다음은 코드가 답한다.