root-cause-firstlisted

# root-cause-first > **답변 언어**: 이 지침은 한국어로 쓰였지만, **출력은 항상 사용자가 대화에서 쓰는 언어**를 따른다 (한국어→한국어, 영어→영어). 기존 문서·코드에 언어가 있으면 그쪽을 우선한다. <HARD-GATE> ## 절대 계약 — 흐려��면 안 되는 선 ``` 증상을 가리는 코드는 수정이 아니다 원인을 모르면 "모른다"고 말한다 fallback은 설계 결정이지 응급처치가 아니다 ``` 이 선을 넘으면: 에러가 조용히 삼켜져 코드가 "돌아가는 척"하고, 사용자는 문제가 있다는 사실조차 모른 채 시한폭탄을 안고 간다. 피드백 루프가 죽고, 이 스킬은 무의미해진다. </HARD-GATE> ## 금지 패턴 작성하려는 코드에 아래가 들어가면 멈추고 원인을 먼저 찾아라: - 빈 `except:` / `except Exception: pass` / `catch (e) {}` - 실패를 숨기는 `|| defaultValue`, `?? fallback`, `or 0`, `or ""` - 크래시만 멎게 하려고 추가하는 가드 (`if not x: return`) - 로그 없는 retry 루프 - 테스트를 통과시키려고 프로덕션 코드에 더하는 방어 코드 - 호출부마다 반복되는 중복 방어 — 처리는 경계(핸들러/미들웨어)에서 한 번 ## fallback 허용 기준 (셋 다 만족해야 함) 1. 요구사항이 "우아한 저하"를 명시한다 (예: 시세 API 죽어도 화면은 뜬다) 2. 실패가 외부적·예상 가능하다 (네트워크, 외부 API, 사용자 입력) 3. 실패가 여전히 드러난다 (로그 + 가능하면 사용자에게 표시) 하나라도 아니면 에러를 전파하라. 에러 메시지는 "무엇이 어떤 입력으로 실패했는지"를 담는다. ## 버그 수정 루프 1. 재현한다 (재현 못 하면 재현 조건부터 찾는다) 2. 스택트레이스/로그로 원인 위치를 특정한다 — 추측으로 고치지 않는다 3. 원인을 고친다 (증상 지점이 아니라) 4. 진단용 임시 로깅을 제거한다 5. 원래 재현 케이스로 검증한다 원인 규명 시도가 2번 실패하면: try/except로 감싸서 "일단 되나 보자" 하지 말고, 멈추고 사용자에게 솔직하게 말하라 — 지금까지 확인한 것, 배제한 가설, 다음으로 확인할 것. ## hi-vibe catch — 반사실적 발견에만 공을 밝힌다 이 규율이 **사용자가 그대로 넘어갔을 것을 붙잡았을 때만**(예: 조용히 삼켜질 뻔한 에러, 증상만 가리던 fallback, 원인 대신 방어코드로 덮으려던 것) 답변 맨 끝에 한 줄을 더한다. 세 조건을 **모두** 만족할 때: ① 이 규율이 짚었다(사용자가 자발적으로 지적한 게 아니다) ② 진짜 결함·잘못된 처리다(스타일이 아니다) ③ 이 규율을 적용하기 전엔 레이더 밖이었다 — 안 짚었으면 그대로 배포됐을 것이다. 형식(문구는 사용자 언어로, `👋 hi-vibe` 접두사는 ��정 — 나중에 grep 가능하게): `👋 hi-vibe가 방금 <무엇>을 잡았어요 — root-cause 규율.`