증상으로 찾기
이 사이트의 나머지 섹션은 주제별로 정리돼 있습니다. 이 섹션은 지금 겪고 있는 증상에서 출발합니다. 무엇이 왜 이렇게 보이는지, 어떻게 확인하는지, 어떻게 고치는지를 간단히 정리하고, 메커니즘을 자세히 다루는 주제 페이지로 연결합니다.
원인을 이미 알고 있다면 주제별 섹션(Verification, Tools, Context)을 바로 보십시오. 지금 막힌 증상만 있고 원인을 모른다면 아래에서 가장 가까운 문장을 찾으십시오.
- 검사는 통과하는데 실제로는 깨져 있습니다. 테스트도, lint도, 빌드도 초록인데 결과물은 그렇지 않습니다.
- 측정값을 믿을 수 없습니다. 다른 입력을 넣었는데 같은 숫자가 나오거나, 값 자체가 이상합니다.
- 브라우저 자동화가 어긋납니다. 스크린샷,
타이밍 측정,
page.evaluate실행이 예상과 다르게 동작합니다. - 병렬 작업이 막힙니다. worktree, 테스트 수집, 머지 과정에서 막혔습니다.
- 설정한 대로 동작하지 않습니다. CLAUDE.md에 썼는데, 훅을 걸었는데, MCP를 등록했는데 반영되지 않습니다.