“작동하면 건드리지 마세요” — 정의, 원칙의 본질 및 위험

“작동하면 건드리지 마세요” 원칙이란?

“작동하면 건드리지 마세요” — 충분한 이유 없이 작동하는 코드를 변경하지 말도록 경고하는 경험적 규칙입니다. 이 원칙은 간단한 통계에 기반합니다: 대부분의 하잔은 기존 코드를 수정하는 과정에서 발생합니다.

이 원칙은 교조가 아닙니다 — 오히려 불확실성 속에서 결정을 내리는 데 도움이 되는 흐리스틱입니다. 코드베이스가 더 복잡하고 었키머 있을수록, “무해한” 변경이 아무도 예상하지 못한 무언가를 깨뜨리겠다는 가능성이 더 높습니다.

Microsoft Corporation의 연구 (2024)에 따르면, 프로덕션에서 발생하는 중대 사고의 약 60%가 최근에 수행된 코드 변경과 관련되며, 이러한 변경은 좋은 의도로 이루어졌지만 실제 부하 조건에서 충분히 테스트되지 않았습니다.

원칙의 역사와 기원

관용구 “고장나지 않았으면 고치지 마라”는 20세기 중반 미국 엔지니어링 문화에서 유래되었습니다. 가장 이른 문헌화된 사용은 미국 상원 재무위원회에서 근무하며 과다한 규제에 반대했던 버트 랜스 (1977)에게 돌릴 수 있습니다.

프로그래밍에서 이 원칙은 하드웨어 엔지니어링에서 유래되었습니다. 그 집에서는 작동하는 칩을 새 것으로 교체하면 예찁할 수 없는 결과를 초래할 수 있었습니다. 소프트웨어의 문맥에서는 소프트웨어 시스템이 더욱 복잡해지고 레거시 코드가 등장하면서 이 원칙이 특히 넓리 퍼져 나갔습니다.

흠미록게도 프로그래밍에서는 이 원칙에 반대 면이 있습니다. “작동하지만 건드리지 않는 것이 좋다”는 말이 리팩토링을 회피하는 변명이 되면서 장기적으로 기술 부췌이 심각하게 적립되는 경우가 많습니다. 컨설팅 회사 사우트워크스 (2023)에 따르면, 약 40%의 프로젝트가 변경에 대한 과다한 보수적 태도로 인해 심각한 문제에 직면하고 있습니다.

원칙 적용 시기

“작동하면 건드리지 마세요” 원칙은 오류의 비용이 변경의 잠재적 이득을 상회하는 특정 상황에서 특히 중요합니다.

테스트가 없는 레거시 프로젝트

레거시 코드가 테스트로 커버되지 않은 경우, 어떤 변경이든 러시안 룰렛과 같습니다. 개발자가 변경으로 인해 인접 모듈이 깨지지 않았는지 확인할 수 없다면, 가장 좋은 전략은 작동하는 코드를 그대로 두는 것입니다. 예외는 치명적인 버그나 보안 요구사항이 있는 경우입니다.

위험 시스템

다운타임이 허용되지 않거나 오류 비용이 매우 높은 시스템 — 의료 소프트웨어, 항공 전자 장비, 금융 거래 — 에서는 “작동하면 건드리지 마세요” 원칙이 사실상의 표준입니다. 모든 변경은 다단계 승인과 테스트를 거치합니다.

측약된 마감기한

릴리스가 내일이고 코드가 작동하는 경우 — 아키텍처를 개선하려고 하지 마세요. 릴리스 기능에 직접 영향을 미치는 부분만 변경하세요. 리팩토링은 다음 스프린트로 미루세요(하지만 잠지 마세요).

원칙 준수의 위험

“작동하면 건드리지 마세요” 원칙을 맹독적으로 따르면, 꼭 필요한 리팩토링만큼이나 위험합니다. 주요 위험을 살펴보겠습니다.

기술 부췌 적립

모든 개발자가 이 원칙을 따른다면, 코드베이스는 구식 해결책, 임시 처리, 비최적 알고리즘의 레이어 케이크가 됩니다. 조만간 기술 부췌이 감당할 수 없을 정도로 커젹습니다. 어떤 변경이든 기간이 걸리는 분석이 필요합니다.

높치긴 최적화

가끔은 위험해 보이는 변경이 실제로 성능이나 보안을 크게 향상시킬 수 있습니다. “작동하면 건드리지 마세요” 원칙은 측정 가능한 효과를 가져오는 변경 — 서버 비용 절감, 페이지 로딩 가속, 보안 향상 — 을 차단해서는 안 됩니다.

역량 손실

팀이 코드의 특정 부분을 다년수동안 건드리지 않으면, 그것이 어떻게 작동하는지 이해하지 못하게 됩니다. 주요 개발자가 떠나면 코드는 유지보수 가능성이 없는 레거시가 됩니다. 이 원칙은 프로젝트의 장기 유지보수성을 고려하여 적용해야 합니다.

황금 중용: 괴문하지 않는 리팩토링

최적의 전략은 원칙을 맹독적으로 따르는 것이 아니라, 문맥을 고려하여 의식적으로 적용하는 것입니다. 리팩토링은 필요하지만 안전하게 수행되어야 합니다.

보이스카우트 규칙

프로그래밍에서 보이스카우트 규칙: “코드를 찾았을 때보다 더 깨꺿이 두고 떠나십시오.” 개발자가 모듈을 변경하는 경우, 구조를 개선해야 하지만 합리적인 범위 내에서만 해야 합니다. 모든 것을 처음부터 다심 쓸 필요는 없고, 적어도 읽기 어려운 변수명을 바꾸고 주석을 추가하세요.

테스트 보호 아래서의 리팩토링

테스트는 “작동하면 건드리지 마세요” 원칙을 안전하게 적용할 수 있는 유일한 방법입니다. 코드가 테스트로 커버되어 있다면, 어떤 리팩토링이든 예측 가능해집니다. 개발자가 코드를 변경하고, 테스트를 실행하며, 무언가가 깨졌는지 확인하면 됩니다. 테스트 없이 — 건드리지 마세요. 테스트가 있으면 — 확신을 가지고 리팩토링하세요.

// 예제: 테스트 커버리지 아래서의 안전한 리팩토링
class PriceCalculator {
    fun calculatePrice(basePrice: Double, discount: Double): Double {
        // 구된 것이지만 작동하는 코드
        return basePrice - (basePrice * discount / 100.0)
    }
}

// 회귀를 방지하는 테스트
class PriceCalculatorTest {
    fun testCalculatePrice() {
        val calc = PriceCalculator()
        assertEquals(90.0, calc.calculatePrice(100.0, 10.0))
    }
}

이 예제는 올바른 접근 방식을 보여줍니다. 먼저 테스트, 그 다음에 리팩토링입니다. 테스트가 통과하면 변경은 안전합니다. “작동하면 건드리지 마세요” 원칙은 “테스트 아래서 작동하면 리팩토링해라”로 바끉니다.

실제 사례

“작동하면 건드리지 마세요” 원칙이 구조용으로도, 파괴적으로도 작용한 실제 사례들을 살펴보겠습니다.

구조용인 사례: Y2K 유사 문제

한 개발자가 날짜 처리 코드가 YYYY 대신 DD/MM/YY 형식을 사용하고 있다는 것을 발견했습니다. 코드는 2000년부터 2025년까지 지장 없이 작동하고 있었습니다. “고치고“ 싶은 마음이 있었지만, 그는 코드를 그대로 두고 주석만 추가했습니다. 2026년에 회사가 시스템을 업데이트했고, 새 해결책이 세기를 올바르게 처리했습니다. 조기에 변경하였다면 작동하는 로직이 깨졌을 것입니다.

파괴적이었던 사례: “개선”으로 인한 데이터 손실

한 엔지니어가 구된 것이지만 작동하는 데이터 임포트 코드를 최신 라이브러리로 교체하여 “개선”하기로 결정했습니다. 그는 구 라이브러리가 문서화되지 않은 특정 애다른 경찰 값을 처리했다는 사실을 고려하지 않았습니다. 릴리스 후, 대량의 데이터가 손실되었습니다. “작동하면 건드리지 마세요” 원칙이 위반되었고, 오류의 비용은 팀이 복구에 2주일을 보내야 했습니다.