2nd/01_Archive/2026-04-20/Debugging-Methodology-Checklist.md

🐛 개발 프로세스 진단 체크리스트 (Troubleshooting Checklist)

🔍 단계별 문제 해결 순서 (The Diagnostic Flowchart)

Step 1: 환경/파일 시스템 무결성 검증 (L1 - Low Level Check)

• 확인 대상: 브라우저 Console의 빨간색 에러 메시지 (404 Not Found, SyntaxError).
• 진단 목표: 코드가 아니라, **'실행 가능한 파일 자체가 존재하는가?'**를 확인합니다.
• 조치: 캐시 문제 의심 \rightarrow 강제 새로고침 (Ctrl + F5) 후, 서버 재시작(Ctrl + C 후 npm start)을 필수로 수행한다.

Step 2: 통신 프로토콜 검증 (L2 - Communication Check)

• 확인 대상: onmessage 핸들러의 동작 여부.
• 진단 목표: '메시지 A'가 발생했을 때, '예상된 메시지 B'로 변환되는 과정이 정상적인지 확인한다.
• 조치: 로그(console.log)를 통해 데이터 흐름 자체에 문제가 없는지 추적한다.

Step 3: 로직 및 시스템 검증 (L3 - High Level Logic Check)

• 확인 대상: 핵심 비즈니스 규칙(충돌 판정, 점수 계산 등).
• 진단 목표: 코드가 논리적으로 완벽한지 확인한다.
• 조치: 가장 단순화된 **최소 실행 예제(Minimum Reproducible Example)**를 만들어 테스트하며 로직을 검증한다.