1.3 KiB
1.3 KiB
description
| description |
|---|
| 에러/버그 발생 시 체계적 디버깅 워크플로우 (에러, 안돼요, 왜 안돼, 버그, 디버그, 수정) |
Debug Workflow
Important
추측으로 코드를 수정하지 마세요. 반드시 이 순서를 따릅니다.
1단계: 정보 수집 (추측 금지)
- 에러 메시지 전문 확인 (절대 잘라내지 않기)
- 관련 로그 파일 확인
- 환경 정보 확인 (OS, Python 버전, 의존성 버전 등)
- 에러가 발생하는 정확한 입력/조건 파악
2단계: Known Issues 확인
.agents/references/known-issues.md를 읽고 동일하거나 유사한 문제가 있는지 확인합니다.
Caution
known-issues 확인 없이 해결 시도를 시작하지 마세요.
3단계: 근본 원인 분석
- 에러가 발생하는 정확한 코드 위치 확인
- 가설을 세우고, 가설을 검증할 수 있는 최소한의 테스트 수행
- 가설이 틀렸다면 즉시 다른 가설로 전환
Warning
동일한 접근을 2회 초과 시도하지 마세요.
4단계: 수정 및 검증
- 수정 적용
- 동일 에러가 재현되지 않는지 확인
- 사이드 이펙트 없는지 확인
5단계: 기록
known-issues.md에 새 항목 추가