증상 말고 원인부터 찾는 디버깅

상황

리포트는 증상만 알려줍니다. 그 자리만 고치면 같은 원인을 공유하는 다른 호출부가 그대로 남아요. 원인이 있는 한 곳을 찾아 거기서 고치는 게 결국 더 작은 diff가 됩니다.

단계별 설명

1. 01 systematic-debuggingskill

   고치기 전에 재현부터

   재현 안 되는 버그를 고치면 고쳐졌는지도 알 수 없습니다. 실패하는 조건을 먼저 문장으로 적고 시작합니다.

2. 02 Serenamcp

   고칠 함수의 호출부를 전부 센다

   심볼 참조를 훑어 이 함수를 부르는 곳이 몇 군데인지 봅니다. 여러 곳이면 각 호출부가 아니라 공용 함수 한 곳에 가드를 넣는 쪽이 맞습니다.

3. 03 chrome-devtools-mcpmcp

   추측 대신 콘솔·네트워크를 본다

   브라우저에서 실제로 무엇이 요청되고 무엇이 실패했는지 확인합니다. 코드만 읽고 세운 가설은 절반이 틀립니다.

4. 04 Claude Codeagent

   원인 한 곳만 고친다

   수정 후 처음에 적어둔 재현 조건을 다시 돌려 확인합니다. 통과하면 그 조건을 테스트로 남겨 재발을 막습니다.