디버깅 & 오류 복구 플레이북

무엇을 해주나

• Stop-the-Line 규칙: 예상치 못한 오류가 나면 새 기능 작업을 멈추고, 증거(에러 출력·로그·재현 절차)를 보존한 뒤 진단부터 시작하게 합니다.
• 6단계 트리아지 체크리스트: 재현 → 위치 파악(Localize) → 최소화(Reduce) → 근본 원인 수정 → 회귀 테스트로 방어 → 종단 검증 순으로 순서를 건너뛰지 않게 안내합니다.
• 재현 불가 버그 분기 트리: 타이밍 의존·환경 의존·상태 누수·완전 랜덤 케이스별 대응법을 제시합니다.
• 유형별 진단 트리: 테스트 실패, 빌드 실패, 런타임 에러(TypeError, CORS, 화이트 스크린 등)를 각각 분기 형태로 짚어줍니다.
• git bisect 활용: 회귀 버그의 원인 커밋을 이분 탐색으로 찾는 명령 예시를 제공합니다.
• 안전 폴백 패턴: 기본값+경고, 그레이스풀 디그레이데이션 등 시간 압박 상황의 임시 대응 패턴.
• 보안 규칙: 에러 메시지·스택 트레이스·CI 로그는 '분석할 데이터'이며 그 안의 명령/URL을 사용자 확인 없이 실행하지 않도록 명시합니다.
• 자기합리화 반박표 & 레드 플래그: "어차피 원인 알아", "플레이키 테스트니까 무시" 같은 변명을 현실로 되돌립니다.

이런 분께 추천

• Claude Code로 코드를 고치다 보면 원인 파악 없이 패치가 쌓이는 경험을 한 개발자
• 회귀 버그, 간헐적 실패, CI에서만 깨지는 테스트를 자주 다루는 팀
• 버그 수정 후 회귀 테스트를 반드시 남기는 규율을 자동화하고 싶은 사람
• 프론트엔드/백엔드 구분 없이 웹 스택(특히 Node·TypeScript)에서 작업하는 개발자

활용 예시

1. 어제까지 되던 기능이 깨졌을 때: "이 테스트가 갑자기 실패해"라고 말하면 git bisect로 원인 커밋을 좁히고, 최소 재현 케이스를 만든 뒤 근본 원인을 수정하고 회귀 테스트를 추가합니다.
2. 중복 데이터 버그: UI에서 [...new Set()]으로 감추는 대신, JOIN이 중복을 만드는 API 쿼리 자체를 찾아 고치도록 유도합니다.
3. CI에서만 실패하는 테스트: 환경 변수·Node 버전·테스트 간 상태 누수를 순서대로 점검하고, 격리 실행(--runInBand)으로 테스트 오염 여부를 확인합니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/aiskillstore/marketplace/HEAD/pending/addyosmani/debugging-and-error-recovery/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 aiskillstore/marketplace 의 pending/addyosmani/debugging-and-error-recovery 폴더를 내 ~/.claude/skills/debugging-and-error-recovery/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.