코드 비대 진단은(는) 무엇을 하나요?
목표
정확성, 필수 오류 처리, 접근성, 보안, 근거 및 유지보수성을 희생하지 않고 불필요한 복잡성을 줄입니다.
진단 워크플로우
- 실제 사용자 대면 또는 연구 요구사항과 이를 지원하는 테스트를 식별합니다. 기능과 안전성을 제약 조건으로 취급합니다.
- 비대 후보 목록을 작성합니다: 중복 논리, 데드 브랜치, 미사용 의존성, 불필요한 계층, 예측적 설정, 중복 래퍼, 과도하게 생성된 파일.
- 의미 있는 것만 측정합니다: 인지적 복잡도, 도입된 의존성, 코드 변동량, 중복 커버리지, 검토 부담, 안정성. 코드 라인 수만으로 품질을 측정하지 않습니다.
- 각 후보에 대해 묻습니다: 이것이 어떤 요구사항 또는 실패를 지원하는가? 근거로 추적합니다. 장황하더라도 필요하면 유지합니다.
- 변경 순서: 미사용 삭제, 중복 통합, 추상화 단순화, 핫 경로 최적화. 하나의 국소적 수정으로 충분할 때 전면 재작성을 피합니다.
- 테스트 아래에서 가장 작은 가역적 변경을 수행합니다; 긍정 및 회귀 검사를 실행합니다. 동작과 외부에서 관찰되는 계약을 보존합니다.
- 이점과 트레이드오프를 보고합니다. 제거로 인해 커버리지가 약화되거나 동작이 모호해지면 단순화를 병합하지 않습니다.
보호 장치
파일 수를 줄이기 위해 연구 출처, 검증, 승인 경계, 보안 검사 또는 알려진 실패 예제를 삭제하지 않습니다. 작은 기능을 위해 부당하게 새 라이브러리를 도입하지 않습니다. 리팩터링이라는 레이블 아래 고정된 벤치마크 의미를 변경하지 않습니다.
출력
후보, 이유, 증명, 변경 위험 및 유지된 보호 장치를 포함한 의사 결정 등록부.
성공 기준
검토자가 각 제거를 정당화하고 지원되는 동작과 신뢰 경계가 변경되지 않았음을 확인할 수 있어야 합니다.