Big Ball of Mud에서 어떻게 벗어날 수 있을까요?
Martin Fowler의 _Refactoring_은 외부에서 보이는 동작을 유지하는 작은 변경으로 기존 코드의 구조를 개선하는 방법을 보여 줍니다. Michael Feathers의 _Working Effectively with Legacy Code_는 테스트, 문제 있는 의존성의 분리, 변경할 수 있는 이음점인 Seam을 통해 변경하기 어려운 코드를 다시 통제하는 방법을 보여 줍니다. 둘 다 오래된 시스템을 다루는 데 여전히 가장 중요한 도구에 속합니다.
하지만 충분히 커진 빅 볼 오브 머드(Big Ball of Mud)에는 다른 한계가 더해집니다.
한 사람이 혼자 Big Ball of Mud를 구하도록 해서는 안 됩니다.
경험적 자연법칙이 아닙니다. 아키텍처를 대하는 태도입니다.
어느 순간 구조적 침식은 개별 클래스, 서비스, 모듈만의 문제가 아니기 때문입니다. 도메인 동작, 과거 요구사항, 기술적 의존성, 조직 경계, 책임, 테스트, 지식, 릴리스와 운영 절차에 동시에 영향을 줍니다.
보통 한 사람이 모든 지식과 도메인 의사결정권, 조직적 정당성, 시간을 갖고 이 모든 차원을 혼자 다시 정리할 수는 없습니다.
Big Ball of Mud는 혼자 구할 수 없습니다. 하던 일 틈틈이 구할 수는 더더욱 없습니다.
개발자 개인이 아무것도 못 한다는 뜻은 아닙니다. 오히려 누군가 문제 있는 구조를 알아보고 더 나은 경계를 제안하거나 통제할 수 있는 첫 진입점을 만들며 변화가 시작되는 경우가 많습니다.
하지만 개인의 관찰은 어느 순간 공동의 결정이 되어야 합니다.
시스템 차원의 문제에는 어느 순간 공동의 결정이 필요합니다.
Big Ball of Mud에서는 특히 중요합니다. 뛰어난 아키텍트가 시스템 전체를 이해하고, 모든 핵심 결정을 내리고, 아무도 새 길에서 벗어나지 않게 직접 챙겨야만 벗어날 수 있다면 다음 지식 독점을 이미 만들고 있습니다.
아키텍처는 더 나아져도 구조적 의존 문제는 그대로일 수 있습니다.
영웅 한 명 대신 세 가지 책임
섹션 제목: “영웅 한 명 대신 세 가지 책임”‘함께’는 개발자를 더 투입한다는 뜻만이 아닙니다. 공동 방향이 없는 열 명은 두 명보다 더 빨리 일관성 없는 구조를 만들 수 있습니다.
지속 가능한 재구성에는 적어도 기술, 도메인, 조직의 책임이라는 세 관점이 필요합니다.
기술적 책임
섹션 제목: “기술적 책임”기술 관점은 재구성의 방향을 정합니다. 예를 들어 다음에 답합니다.
- 앞으로 도메인 책임은 어디에 있어야 합니까?
- 어떤 의존성을 허용합니까?
- 도메인 슬라이스를 어떻게 나눕니까?
- 어떤 통합 메커니즘을 사용합니까?
- 도메인 상태는 어디에 둡니까?
- 어떤 반복 패턴이 새 구조를 만들어야 합니까?
- 지금 문제인 어떤 패턴을 더는 만들지 않아야 합니까?
모든 구현 결정을 중앙에서 지정하려는 것은 아닙니다. 서로 다른 개발자가 독립적으로 호환되는 해법에 이르도록 규칙을 만드는 것이 목표입니다.
도메인 책임
섹션 제목: “도메인 책임”기술적 분석은 시스템이 오늘 무엇을 하는지 복원하는 데 도움이 됩니다. 하지만 앞으로 무엇을 해야 하는지까지 믿을 만하게 도출할 수는 없습니다.
도메인 결정을 내릴 사람이 필요합니다.
다음과 같은 질문에 답해야 합니다.
- 어떤 비즈니스 규칙이 계속 유효합니까?
- 어떤 예외가 도메인상 필요합니까?
- 과거의 어떤 특성은 사라져도 됩니까?
- 오늘 관찰되는 어떤 결과는 반드시 유지해야 합니까?
- 어떤 동작은 오래된 기술적 제약의 결과일 뿐입니까?
오래된 시스템에서는 코드와 도메인 의미가 깔끔하게 나뉘지 않을 수 있으므로 특히 중요한 책임입니다.
조직적 책임
섹션 제목: “조직적 책임”마지막으로 재구성에는 조직 안에서 행동할 여지가 필요합니다.
시간을 투자하고 결정을 내리며 기존 담당 경계를 넘어 협력할 수 있게 해 주는 사람이 있어야 합니다.
반드시 별도의 현대화 프로그램이 필요하다는 뜻은 아닙니다. 하지만 작은 전술적 재구성도 실제로 수행할 정당성은 필요합니다.
세 관점을 꼭 서로 다른 세 사람이나 역할이 맡을 필요는 없습니다. 작은 조직에서는 책임이 겹칠 수 있습니다.
그래도 책임 자체는 있어야 합니다.
Big Ball of Mud는 공동의 문제가 되었습니다. 그러므로 재구성도 한 개발자의 사적인 시도로 남을 수 없습니다.
Big Ball of Mud의 재구성에는 기술, 도메인, 조직의 책임이 필요합니다. 어느 관점도 나머지를 영구히 대신할 수 없습니다.
Big Ball of Mud는 청소하는 대상이 아닙니다
섹션 제목: “Big Ball of Mud는 청소하는 대상이 아닙니다”국소적인 리팩터링은 Big Ball of Mud에서도 유용합니다. Fowler는 리팩터링을 외부에서 관찰할 수 있는 동작을 유지하면서 내부 구조를 규율 있게 바꾸는 것으로 설명합니다. 작은 단계와 그때마다 얻는 피드백이 이 기법을 소중하게 만듭니다.
Feathers의 기법도 여전히 중요합니다. 문제의 서비스를 분리하고, 클래스에 테스트를 붙이고, 통제하기 어려운 의존성에 Seam을 만들 수 있습니다. 국소적인 영역을 더 이해하기 쉽게 만들 수 있습니다.
하지만 충분히 커진 Big Ball of Mud에는 다른 차원이 있습니다. 전체 구조가 실제 책임과 의존성을 충분히 설명하지 못합니다.
기존 코드가 ‘보기 싫다’는 것만이 문제가 아닙니다.
시스템의 어느 부분이 무엇을 책임져야 하는지에 대한 믿을 만한 답이 없습니다.
그래서 ‘정리’라는 말은 필요한 작업을 설명하기에 너무 약합니다.
Big Ball of Mud는 청소하지 않습니다. 단계적으로 재구성합니다.
시스템 전체를 완전히 교체한다는 뜻은 아닙니다.
이런 구상도 아닙니다.
옛것 제거 → 새로 구축 → 전환.
훨씬 덜 극적이고 그래서 더 현실적인 경우가 많은 일입니다.
계속 운영 중인 시스템에 도메인 경계와 기술 경계를 단계적으로 되돌려 줍니다.
구체적인 방법은 팀이 가진 행동 가능성에 크게 달려 있습니다.
서로 다른 두 출발점
섹션 제목: “서로 다른 두 출발점”Big Ball of Mud를 다룰 때는 두 상황을 분명히 나누는 것이 좋습니다.
첫 번째에는 포괄적인 재구성의 명시적 권한이 없습니다. 팀은 기능을 계속 제공해야 합니다. 구조 개선은 진행 중인 제품 개발과 경제적으로 양립하는 곳에서만 할 수 있습니다.
두 번째에는 조직이 구조적 문제를 의식적으로 인정하고 재구성을 계획된 제품 작업으로 보고 예산을 배정할 준비가 되어 있습니다.
기술적 가능성도 크게 달라집니다.
상황 1: 명시적인 현대화 권한이 없습니다
섹션 제목: “상황 1: 명시적인 현대화 권한이 없습니다”많은 조직에서는 더 흔한 상황일 것입니다.
제품은 필요합니다. 고객은 기능을 기다리고 예산은 한정되어 있습니다. 시스템을 얼마나 오래 운영할지 불분명할 수 있습니다. 기대 이익이 더 큰 다른 전략적 투자도 있을 수 있습니다.
이해관계자가 독립된 현대화 프로그램에 투자하지 않는 것이 자동으로 비합리적이지는 않습니다.
다만 개발팀은 숨겨진 두 번째 프로젝트를 시작해서는 안 됩니다.
기능 예산을 체계적으로 돌려 시스템 전체를 몰래 재구성하는 것은 투명하지도 지속 가능하지도 않습니다. 큰 작업량이 처음 드러나면 조직적 기반이 없다는 사실도 드러납니다.
더 흥미로운 질문은 이렇습니다.
어차피 필요한 제품 변경이 전술적 재구성의 의미 있는 접점이 될 수 있습니까?
새 도메인 요구가 특히 문제 있는 영역을 건드린다고 해 보겠습니다. 실제 기술적 경로가 두 개 있을 수 있습니다.
안 A: 기존 구조를 따라 기능을 구현합니다.
안 B: 해당 도메인 부분을 충분히 나누거나 재구성한 뒤 더 믿을 만한 구조 안에 기능을 구현합니다.
두 안 모두 정직하게 추정해야 합니다.
기존 확장에 20인일, 타당한 재구성에 60인일이 든다면 경제적 답은 많은 상황에서 충분히 이해할 만합니다. 우선 기존 시스템에 기능을 구현합니다.
아키텍처가 다른 모든 제품 우선순위를 누를 권리를 갖는 것은 아닙니다.
두 안의 작업량이 비슷한 범위에 있으면 다릅니다. 직접 확장에는 25일, 통제된 분리 뒤 구현에는 30일이나 35일이 들 수 있습니다.
그러면 실제 선택이 있습니다.
이해관계자의 주요 목표는 같습니다. 필요한 기능을 합당한 기간 안에 안정적으로 제공하는 것입니다. 하지만 비슷한 작업량으로 믿을 만한 도메인 경계도 만들 수 있다면 의식적으로 검토해야 합니다.
개발자 한 명의 책상에서만 결정할 일은 아닙니다.
확장과 재구성의 경제적 차이가 작다면 책임 있는 사람들이 어느 안을 택할지 매우 의식적으로 결정해야 합니다.
경험 있는 개발자와 기술 책임자가 함께할 지점입니다. 코드 한 줄마다 위원회를 세우기 위해서가 아닙니다. 그런 개별 결정이 쌓여 시스템의 미래 구조가 되기 때문입니다.
어차피 변경이 필요하다면 확장과 전술적 재구성을 실제 구현 경로 두 가지로 비교하는 것이 타당할 수 있습니다.
기회를 따라 재구성하기 전에 공동 아키텍처 지침부터
섹션 제목: “기회를 따라 재구성하기 전에 공동 아키텍처 지침부터”전술적 재구성에는 분명한 위험이 있습니다. 국소적인 개선이 많다고 전체 아키텍처가 자동으로 좋아지지는 않습니다.
개발자 A는 새 도메인 Store를 만들고, B는 서비스를 쓰고, C는 Event Bus를 세우고, D는 Facade 레이어를 더할 수 있습니다. 각각은 그 자리에서 타당해도 함께 놓으면 누구도 규칙을 정확히 설명하지 못하는 다음 시스템이 됩니다.
개발자가 각자 좋은 아키텍처를 넣는다고 Big Ball of Mud가 건강해지지는 않습니다.
그래서 가능한 한 일찍 작고 공동으로 지지하는 목표상이 있어야 합니다.
100쪽짜리 엔터프라이즈 아키텍처 문서를 뜻하지 않습니다. 변화가 잦은 시스템에서는 그런 문서도 금방 과거의 산물이 될 것입니다.
구체적인 결정에 실제로 도움이 되는 소수의 규칙이 필요합니다.
- 도메인 책임은 어디에 있습니까?
- 의존성은 어느 방향으로 갈 수 있습니까?
- 도메인 슬라이스는 어떻게 소통합니까?
- 도메인 상태는 어디에 둡니까?
- 어떤 통합 메커니즘을 우선합니까?
- 새 영역에서 어떤 패턴은 더 만들지 않아야 합니까?
- 외부 시스템은 어떻게 연결합니까?
- 개발자가 달라도 재현할 수 있어야 하는 규칙은 무엇입니까?
지침은 발전할 수 있습니다. 처음부터 모든 예외를 다룰 필요도 없습니다.
중요한 것은 기능입니다.
전술적 재구성에는 공동 방향이 필요합니다. 그렇지 않으면 하나의 Big Ball of Mud에서 새 섬 몇 개만 생깁니다.
모든 Pull Request를 직접 확인해야 하는 새 아키텍처 영웅을 만드는 것이 목표여서는 안 됩니다.
믿을 만한 아키텍처 규칙은 여러 사람이 이해하고 재현할 수 있는 규칙입니다.
새 구조가 왜 작동하는지 한 사람만 안다면 기술적으로 더 깔끔해졌어도 조직적으로는 계속 취약합니다.
실제 경계를 만들 수 있다면 새 기능은 목표상을 따라 만듭니다
섹션 제목: “실제 경계를 만들 수 있다면 새 기능은 목표상을 따라 만듭니다”새 기능을 자동으로 같은 오래된 구조 안에 계속 자라게 해서는 안 됩니다.
경제적·기술적으로 믿을 만한 도메인 경계를 만들 수 있다면 새 기능은 실제로 그 경계를 세울 좋은 기회입니다.
하지만 이 조언은 쉽게 오해됩니다.
“레거시는 손대지 말고 새 코드를 옆에 깔끔하게 만들자”는 말은 매력적입니다. 충분히 커진 Big Ball of Mud에서는 바로 그것이 불가능할 수 있습니다.
도메인 상태가 여러 서비스에 전역으로 흩어질 수 있습니다. 우회 방법이 영역을 가로지를 수 있습니다. 독립적으로 보이는 기능들이 같은 데이터 구조를 공유할 수 있습니다. 암묵적 이벤트가 다른 세 곳에서 문서에 없는 동작을 일으킬 수 있습니다.
그러면 다음 이름의 새 폴더는,
features/new-feature
실제로 새 경계를 만들지 않고도 좋은 구조처럼 보이게 할 수 있습니다.
새로운 쪽은 깔끔해 보여도 모든 도메인 작업마다 Big Ball of Mud 깊숙이 접근해야 한다면 아직 믿을 만한 경계는 아닙니다.
그런 경우 첫 재구성의 의미 있는 결과는 완전한 새 슬라이스 구현이 아닐 수 있습니다.
먼저 통제할 수 있는 통합 지점 하나만 필요할 수 있습니다.
Feathers의 Seam 개념이 흥미로워집니다. 주변 코드를 한꺼번에 다 바꾸지 않고 동작에 영향을 주거나 의존성을 끊을 수 있는 지점입니다. 레거시 코드와 테스트 가능성의 맥락에서 나왔지만 통제 가능한 전환을 위한 생각의 틀로도 유용합니다.
재구성의 첫 결과가 새 기능 슬라이스는 아닐 수 있습니다. 나중에 슬라이스가 생길 첫 믿을 만한 경계일 뿐일 수 있습니다.
새 디렉터리 구조를 만드는 것보다 덜 극적이지만 그것도 진전입니다.
상황 2: 이해관계자가 재구성을 의식적으로 함께 책임집니다
섹션 제목: “상황 2: 이해관계자가 재구성을 의식적으로 함께 책임집니다”두 번째 상황은 행동 가능성을 근본적으로 바꿉니다.
경영진, 제품 관리, 다른 책임 있는 이해관계자가 시스템의 구조적 문제를 인정했고 그래도 앞으로 변경이 필요하다는 사실을 받아들였습니다. 재구성을 의식적으로 계획하고 우선순위를 정하며 예산을 배정할 수 있습니다.
그렇다면 ‘리팩터링을 더 많이’ 하는 것으로는 부족합니다.
재구성을 제품 개발처럼 다루십시오.
특히 기술 파일이나 레이어가 아니라 도메인 관점에서 이해할 수 있는 부분에서 시작한다는 뜻입니다.
그 부분의 요구사항을 확인하고 관련 기존 동작을 이해하며 검증으로 보호합니다. 목표 경계를 정한 뒤 책임을 새 구현으로 통제하며 옮깁니다.
새 경로가 제 역할을 할 때에야 옛 경로를 없애고 다음 부분으로 갑니다. 옛 시스템 옆에 큰 새 시스템을 구축하는 구상보다 느려 보입니다. 하지만 바로 그 범위 제한이 결정적인 장점입니다.
Strangler Fig: 모든 불확실성을 한 번에 떠안지 않습니다
섹션 제목: “Strangler Fig: 모든 불확실성을 한 번에 떠안지 않습니다”Martin Fowler는 2004년 _Strangler Fig Application_을 한 번의 전환으로 전부 교체하는 방식의 대안으로 설명했습니다. 기존 나무를 감싸 자라며 역할을 단계적으로 넘겨받는 교살무화과에서 온 비유입니다. 원래 설명에서도 작은 단계와 자주 얻는 운영 가능한 중간 결과로 위험을 줄이는 가능성을 강조했습니다. 2024년 개정 설명은 이를 점진적인 레거시 현대화라는 더 큰 맥락에 명시적으로 둡니다.
Big Ball of Mud에서 Strangler Fig는 구체적인 구현 레시피보다 기본 사고방식으로 흥미롭습니다.
한 번에 거는 판돈의 범위를 줄이십시오.
팀이 도메인상 중요한 동작을 이해할 수 있을 만큼 작아야 합니다. 요구사항을 확인할 수 있어야 합니다. 결과를 테스트하고 책임 이전을 검증할 수 있어야 합니다. 오류 하나가 현대화 전체를 자동으로 위협해서는 안 됩니다.
Strangler Fig는 성공을 보장하지 않습니다. 하지만 팀이 동시에 떠안아야 할 불확실성의 범위를 제한합니다.
옛것과 새것을 수년 동안 완전한 두 세계로 나란히 두는 접근과 중요한 차이입니다.
언젠가 새 시스템 전체가 완성되기를 기다리지 않습니다.
책임을 슬라이스별로 옮깁니다.
예를 들어 먼저 새 인터페이스를 통해 한 도메인 프로세스를 새 구현으로 보낼 수 있습니다. 인수가 성공하면 그 프로세스의 책임은 레거시에 더 없습니다. 옛 경로를 제거하고 다음 슬라이스로 갑니다. 다만 자체 비용도 있습니다.
구조 두 개가 일시적으로 공존합니다. 라우팅 등 통합 메커니즘이 필요합니다. 데이터를 동기화하거나 점진적으로 옮겨야 할 수 있습니다. 전환 상태가 단기적으로는 전보다 더 복잡할 수도 있습니다.
방법에 이름이 붙었다고 비용이 없어지지는 않습니다.
보편적인 최적 해법은 아닙니다. 기술적·도메인상 나누기 어려운 시스템이 있습니다. 강한 일관성 요건을 가진 데이터 이전도 있습니다. 수명 종료가 가까워 큰 구조적 투자가 경제적으로 의미 없는 제품도 있습니다.
그래도 시스템 전체를 먼저 이해한 뒤 한 번에 다시 정리해야 한다는 문제 있는 가정을 피하므로 Big Ball of Mud에서 특히 소중합니다.
Strangler Fig는 책임을 단계적으로 옮깁니다. 성공적으로 넘겨받은 슬라이스마다 남은 레거시의 비중이 줄어듭니다.
대규모 일괄 전환에 제가 매우 신중한 이유
섹션 제목: “대규모 일괄 전환에 제가 매우 신중한 이유”한 번의 큰 전환으로 완전히 교체하는 일이 불가능하지는 않습니다. 기술적·조직적으로 정당화할 수 있는 상황도 있습니다.
하지만 Big Ball of Mud에서는 의식적으로 근거를 세운 예외여야 합니다. 기본 절차가 되어서는 안 됩니다.
가장 강한 이유는 우선 통계가 아닙니다.
완전한 교체는 운영 중인 구 시스템이 계속 살아 있는 동안 기능 범위를 복원해야 합니다.
대체로 작업 중 기존 제품을 동결하지는 않습니다.
보안 수정과 버그 수정은 계속 필요합니다. 규제 변화와 긴급한 고객 조정도 생기고 새 기능까지 나올 수 있습니다. 각각 동기화 문제를 만듭니다.
새 요구를 레거시에만 구현하면 옛것과 새것이 멀어집니다. 둘 다 구현하면 적어도 일부는 이중 작업입니다. 미래 시스템에만 구현하면 오늘의 운영 시스템은 혜택을 못 받습니다.
빅뱅 교체는 알려진 시스템 상태를 복원하는 데 그치지 않습니다. 그동안 계속 살아가는 시스템을 따라잡아야 합니다.
완전한 교체가 길어질수록 도메인 목표 상태가 더 달라질 수 있습니다.
최근의 경험적 연구는 흥미롭지만 좁게 해석해야 할 자료를 제공합니다. Jørgensen, Nereng, Torrissen은 노르웨이 소프트웨어 실무자 76명에게 가장 최근의 시스템 폐기 작업을 물었습니다. 조사한 교체·폐기 작업은 평균 5.5년 걸렸습니다. 기존 시스템을 완전히 교체하려던 작업 중 보고된 사례의 44%에서는 실제로 구 시스템을 종료하지 못하고 이후 두 시스템을 병행 운영했습니다. 저자들은 20년 넘은 COBOL 시스템을 빅뱅 방식으로 교체한 경우와 실패가 밀접하게 관련되었다고도 보고합니다. 조사 표본에서 단계적으로 교체하는 폐기 과정 역시 더 높은 성공률과 관련되었습니다.
44%는 빅뱅 프로젝트의 일반적인 실패율이 아닙니다. 특정 표본, 한 국가, 매우 다른 맥락의 폐기 작업을 다룬 연구입니다. 하지만 구조적 문제와는 맞습니다. 동시에 옮길 책임이 많을수록 프로그램이 한꺼번에 다뤄야 할 불확실성도 많아집니다.
그래서 제 권고는 신중하지만 분명합니다.
Big Ball of Mud에서 빅뱅은 의식적으로 근거를 세운 예외여야 합니다. 기본 절차여서는 안 됩니다.
요구공학은 부차적인 일이 아닙니다
섹션 제목: “요구공학은 부차적인 일이 아닙니다”재구성의 가장 어려운 질문은 이것이 아닐 수 있습니다.
새 슬라이스를 어떻게 구현합니까?
이 질문일 수 있습니다.
무엇을 해야 합니까?
Big Ball of Mud에 단순히 ‘요구사항’이 들어 있는 것은 아닙니다.
기존 코드에는 현재 비즈니스 규칙, 과거 규칙, 폐기된 규칙, 버그, 우회 방법, 기술적 제약, 우연한 동작이 함께 들어 있을 수 있습니다.
불편한 범주도 더해집니다. 처음에는 의도하지 않았을 동작인데 고객, 다른 시스템, 운영 절차가 지금은 의존하는 경우입니다.
그래서 재구성에서 이 요구만으로는 부족합니다.
“그냥 똑같이 만드세요.”
옛 코드는 소중한 자료이지만 주로 다음에 답합니다.
시스템은 오늘 무엇을 합니까?
이 질문에는 믿을 만하게 답하지 못합니다.
시스템은 내일 무엇을 해야 합니까?
요구사항 복원(Requirements Recovery) 연구에서 새로운 구분은 아닙니다. Liu, Alderson, Qureshi는 이미 레거시 요구사항 복원을 여러 이해관계자와 사업 맥락을 포함해 관찰 가능한 시스템 동작을 조사하는 일로 설명했습니다. 오래된 연구이고 보편적인 현대화 절차는 아니지만 여전히 중요한 점을 강조합니다. 레거시의 도메인 의미를 기술적 산출물만으로 도출할 수는 없습니다.
재구성에서는 이런 뜻입니다.
도메인 담당자가 도메인에서 무엇이 옳은지 다시 책임져야 합니다.
계속 유효한 규칙, 실제로 필요한 예외, 없애도 될 특성, 반드시 유지할 결과를 결정해야 합니다.
코드는 근거 자료가 될 수 있습니다.
자동으로 명세가 되어서는 안 됩니다.
레거시를 재구성하려면 두 가지 진실이 필요합니다. 오늘 시스템이 하는 일에 대한 기술적 진실과 앞으로 해야 할 일에 대한 도메인의 진실입니다.
일치할 수도, 다를 수도 있습니다.
그래서 요구공학은 주변의 문서 작업이 아니라 아키텍처 작업 자체의 일부입니다.
새 경계가 책임을 지속적으로 넘겨받기 전에 어떤 책임을 받을지 분명해야 하기 때문입니다.
옛 구현 대신 도메인 동작을 지킵니다
섹션 제목: “옛 구현 대신 도메인 동작을 지킵니다”테스트 전략도 중요해집니다.
이 절은 단위 테스트에 반대하는 주장이 아닙니다.
새로 재구성한 코드는 적절한 곳에서 단위·통합·컴포넌트 테스트로 보호해야 합니다. 깔끔한 새 도메인 로직도 작은 규칙을 빠르고 정확하게 테스트하면 좋습니다.
하지만 레거시 슬라이스를 교체할 때 전략적으로 더 가치 있는 테스트는 구체적인 내부 구조와 무관하게 중요한 도메인 동작을 지키는 테스트인 경우가 많습니다.
바로 그 내부 구조를 없애려는 것일 수 있기 때문입니다.
클래스를 없애고, 서비스를 다시 나누며, 상태 관리와 모듈 경계를 바꾸고, 알고리즘을 교체합니다.
구현 세부사항에 강하게 묶인 테스트는 함께 사라져도 됩니다.
실수로 사라져서는 안 되는 것은 확인된 도메인 동작입니다.
그래서 재구성 준비에는 도메인 관점의 E2E 테스트 또는 인수 테스트가 특히 소중합니다.
여기서 E2E는 반드시 모든 마우스 움직임을 자동화하는 거대한 Selenium, Playwright, Cypress 스위트를 뜻하지 않습니다.
다음 뜻입니다.
도메인상 중요한 시나리오를 안정된 입력 경계에서 관찰 가능한 도메인 결과까지 검증합니다.
계약을 처리하는 시스템을 생각해 보겠습니다.
도메인 초기 상태 X가 있습니다.
작업 Y를 수행하면 상태 Z가 되어야 하고, 결과가 저장되며, 필요한 경우 중요한 외부 효과 A를 관찰할 수 있어야 합니다.
프론트엔드 기능의 입력 경계는 실제로 브라우저일 수 있습니다. 도메인 백엔드 프로세스에서는 다음과 같은 테스트가 더 적절할 수 있습니다.
API → 도메인 처리 → 영속화 / 관찰 가능한 결과
즉 API에서 도메인 처리를 거쳐 영속화 또는 관찰 가능한 결과에 이르는 흐름입니다. 중요한 것은 도구가 아니라 경계입니다.
테스트는 기능 슬라이스를 지켜야 합니다. 기존 구현을 지키는 것이 아닙니다.
현재 동작의 기록이 곧 인수 기준은 아닙니다
섹션 제목: “현재 동작의 기록이 곧 인수 기준은 아닙니다”레거시 작업의 또 다른 구분이 도움이 됩니다.
Feathers의 **특성화 테스트(Characterization Tests)**는 기존 시스템의 실제 동작을 기록합니다. 원래 요구사항이 없거나 어떤 경계 사례가 나타나는지 확실히 아는 사람이 없을 때 특히 소중합니다. 책에서는 더 위험한 변경에 앞서 기존 시스템을 먼저 통제하는 큰 맥락 안에서 다룹니다.
하지만 재구성에서는 특성화가 자동으로 인수가 되어서는 안 됩니다.
특성화는 다음에 답합니다.
기존 시스템은 실제로 무엇을 합니까?
인수는 다음에 답합니다.
재구성 뒤에도 도메인상 어떤 동작이 유효해야 합니까?
사이에는 도메인 결정이 있습니다.
과거의 버그가 12년 동안 운영되었다는 이유만으로 비즈니스 규칙이 되지는 않으므로 중요합니다.
반면 특이한 동작도 이제는 외부 계약의 일부일 수 있습니다. 고객, 연결된 시스템, 운영 절차가 의존할 수 있습니다.
따라서 레거시 코드에서 새 구현으로 바로 가는 것이 좋은 경로는 아닙니다.
오히려 다음에 가깝습니다.
레거시 코드 → 관찰한 동작 → 특성화 → 도메인 평가 → 확인된 요구사항 → 인수/E2E 테스트 → 새 구현
E2E 테스트는 요구공학을 대신하지 않습니다. 확인된 요구사항을 실행 가능하게 만듭니다.
바로 그래서 재구성의 바깥 경계를 잡아 줄 수 있습니다.
재구성은 옛 구현이 아니라 도메인에서 확인한 동작을 유지해야 합니다.
보호 장치는 재구성 전에 만듭니다
섹션 제목: “보호 장치는 재구성 전에 만듭니다”시점이 중요합니다.
도메인 인수 테스트의 가장 큰 가치는 새 구현을 완성한 다음에야 생기는 것이 아닙니다.
그때 남는 질문은 이것뿐입니다.
대략 같은 것을 만들었습니까?
통제된 재구성에서는 관련 시나리오를 가능하면 실제로 슬라이스를 떼어 내기 전에 정해야 합니다.
옛 구조를 바꾸기 전에 보호 울타리가 생깁니다.
마지막 규칙 하나까지 미리 완전히 알아야 한다는 뜻은 아닙니다. Big Ball of Mud에서는 작업 중 새 예외가 드러날 것입니다.
그래도 책임을 넘겨받기 전에 지켜야 할 동작은 가능한 한 명확해야 합니다.
도메인 담당자가 시나리오를 확인해야 합니다.
그래야 옛 구현과 새 구현 사이의 실제 계약이 될 수 있습니다.
슬라이스를 재구성하기 전에 새 구현이 어떤 도메인 동작을 지켜야 하는지 가능한 한 분명해야 합니다.
팀은 두 극단을 함께 피합니다.
모든 과거의 특성을 맹목적으로 보존하지 않습니다.
동시에 기술적으로 더 우아한 해석으로 중요한 도메인 동작을 실수로 바꾸지도 않습니다.
폴더를 따라 나누지 않습니다
섹션 제목: “폴더를 따라 나누지 않습니다”다음 슬라이스를 리포지터리에서 어느 폴더가 유난히 보기 싫은지로 고르지 않아야 합니다.
Big Ball of Mud에서는 기술 구조가 도메인 경계를 알려 주는 믿을 만한 단서가 아니기 때문입니다.
좋은 후보는 가능하면 이해할 수 있는 사업 목적, 알아볼 수 있는 입력 경계, 관찰 가능한 도메인 결과를 갖습니다.
팀이 실제로 이해하고 통제하며 넘겨받을 만큼 작아야 합니다.
선택에는 여러 요인이 작용할 수 있습니다.
- 현재 기능 개발
- 경제적 이익
- 변경 빈도
- 알려진 문제 지점
- 기술적으로 이용 가능한 Seam
- 위험
- 다른 영역과의 의존성
보편적 점수 모델을 만들 필요는 없습니다.
어느 슬라이스가 먼저 적절한지는 구체적인 시스템에 크게 달려 있습니다.
처음에는 충분히 믿을 만한 도메인 경계가 전혀 없는 Big Ball of Mud도 있습니다.
그렇다면 나중에 나눌 수 있도록 영역을 통제 가능하게 만드는 것부터가 첫 과제입니다.
작은 제품 결정이 이어지는 재구성
섹션 제목: “작은 제품 결정이 이어지는 재구성”명시적인 권한이 있으면 반복 가능한 작업 모델로 이어질 수 있습니다.
보편적 방법이 아니라 사고의 틀입니다.
- 도메인 부분을 찾습니다. 파일이 아니라 의미 있게 넘겨받을 도메인 책임에서 시작합니다.
- 도메인 담당자와 요구사항을 확인합니다. 앞으로 유효해야 할 규칙, 결과, 예외를 분명히 합니다.
- 관련된 현재 동작을 이해합니다. 코드, 로그, 기존 테스트, 문서, 사용자 지식, 관찰 가능한 운영 동작이 함께 필요할 수 있습니다.
- 도메인 인수/E2E 테스트를 준비합니다. 확인한 목표 동작을 교체할 내부 구조와 가능한 한 독립적으로 실행 가능하게 만듭니다.
- 공동 아키텍처 지침에 따라 목표 경계를 정합니다. 새 슬라이스는 그 자리에서 깔끔할 뿐 아니라 다른 재구성 영역과 같은 미래 아키텍처의 일부여야 합니다.
- 필요한 Seam과 통합 지점을 만듭니다. 책임을 통제하며 옮기는 데 필요한 만큼만 레거시 구조를 바꿉니다.
- 새 구현을 재구성합니다. 새 경계 안에서 적절한 기술 패턴과 테스트를 사용할 수 있습니다.
- 통제하며 새 경로로 보냅니다. 전환은 관찰 가능하고 가능하면 되돌릴 수 있거나 범위가 제한되어야 합니다.
- 동작을 관찰하고 검증합니다. 자동 테스트는 중요하지만 실제 시스템 관찰을 대신하지는 않습니다.
- 옛 경로를 제거합니다. 옛 책임이 두 번째 진실로 영구히 살아남아서는 안 됩니다.
- 다음 슬라이스를 고릅니다. 그때에야 다음 판돈을 겁니다.
프로젝트에 따라 순서는 바뀔 수 있습니다. 일부 단계는 겹칩니다. 특성화 중 처음 계획한 슬라이스가 너무 크다는 사실을 알거나 기술적 의존성 때문에 다른 경계부터 만들 수 있습니다. 정확한 절차 순서보다 각 단계가 이해하고 검증할 수 있는 중간 상태를 만드는 것이 중요합니다.
옛 경로는 언젠가 사라져야 합니다
섹션 제목: “옛 경로는 언젠가 사라져야 합니다”스트랭글러 방식에서는 실제로 옛 구현을 제거하는 불편한 단계를 쉽게 미룰 수 있습니다.
새 기능과 서비스가 작동하고 새 슬라이스도 운영 중입니다. 왜 다시 위험을 감수하며 옛 코드를 지워야 할까요?
그렇지 않으면 책임을 옮긴 것이 아니기 때문입니다.
책임을 복제했을 뿐입니다.
두 경로가 영구히 남으면 새 질문이 생깁니다.
- 어느 구현이 이제 기준입니까?
- 둘 다 바꿔야 합니까?
- 데이터는 계속 동기화되어 있습니까?
- 각 버전은 누가 책임집니까?
- 어느 테스트가 어느 경로에 적용됩니까?
- 옛 경로는 언제 정말 사라져도 됩니까?
현대화가 역설적으로 레거시를 크게 줄이지 않은 채 시스템의 양만 늘릴 수 있습니다.
옛 책임이 실제로 사라져야 재구성이 끝납니다.
모든 임시 연결을 즉시 없앨 수는 없습니다. 여러 릴리스 동안 필요한 전환 구조도 있습니다.
하지만 제거도 작업 범위에 들어가야 합니다.
그렇지 않으면 ‘나중에’는 ‘아마 영원히 안 함’의 다른 이름일 뿐입니다.
‘틈틈이 할 수 없다’는 말의 실제 뜻
섹션 제목: “‘틈틈이 할 수 없다’는 말의 실제 뜻”여기서 모순처럼 보일 수 있습니다.
한편으로 핵심 주장은 이렇습니다.
Big Ball of Mud는 혼자 구할 수 없습니다. 하던 일 틈틈이 구할 수는 더더욱 없습니다.
다른 한편으로 별도 현대화 프로그램이 없는 조직에는 어차피 필요한 기능을 전술적 재구성의 접점으로 쓰라고 권했습니다.
모순되지 않습니다.
‘틈틈이 할 수 없다’는 말은 다음 뜻이 아닙니다.
모든 구조 개선에는 별도의 수백만 규모 예산이 필요합니다.
이 뜻입니다.
구조적 재구성을 개별 개발자의 보이지 않는 사적 추가 업무로 다뤄서는 안 됩니다.
기능을 재구성의 기회로 쓴다면 결정이 보여야 합니다.
함께 책임져야 합니다.
추가 작업을 기능의 맥락에서 경제적으로 평가해야 합니다.
새 구조는 공동 규칙을 따라야 합니다.
다음과는 근본적으로 다릅니다.
“저녁에 시스템을 조금 더 리팩터링하겠습니다.”
Big Ball of Mud가 오래 살아남는 이유가 바로 남다른 개인들이 구조적 문제를 계속 메워 주기 때문일 수 있습니다.
같은 형태의 보완을 현대화 전략으로 삼으면 원리는 바뀌지 않았습니다.
영웅적 행동의 방향만 달라졌을 뿐입니다.
조직이 함께하지 않는다면?
섹션 제목: “조직이 함께하지 않는다면?”큰 개선 프로그램의 권한이 없어도 기술적 행동 가능성은 남습니다.
작은 전술적 작업을 찾고, 경험 있는 개발자가 공동 지침을 정하며, 필요한 기능 작업을 접점으로 쓸 수 있습니다. 확장과 재구성을 실제 대안으로 추정하고 새 변경을 작고 검증 가능하게 유지할 수 있습니다.
무의미한 여지는 아닙니다. 여러 해 동안 그런 결정이 실제로 믿을 만한 새 영역을 만들 수 있습니다. 하지만 이 경로에도 한계가 있습니다.
조직적 권한의 부재를 개발팀이 영구히 메울 수 있는 리팩터링 비법은 없습니다.
구조 작업이 원칙적으로 허용되지 않고, 추가 납기를 받아들이지 않으며, 모든 변경을 단기적으로 가장 싼 구현 경로로만 평가해야 한다면 기술적 가능성도 제한됩니다.
우선 조직을 평가하는 말은 아닙니다.
그 우선순위가 경제적으로 이해될 수 있습니다.
그 조건에서 기술적으로 무엇을 현실적으로 이룰 수 있는지에 대한 진단일 뿐입니다.
어쨌든 개인 한 명이 그 권한을 대신할 수는 없습니다.
이렇게 다시 처음으로 돌아옵니다.
맺음말
섹션 제목: “맺음말”국소적인 리팩터링과 Fowler, Feathers의 기법은 오래된 시스템에서 여전히 중요한 도구입니다. 하지만 Big Ball of Mud는 어느 순간 규모와 시스템적 얽힘 때문에 독립적인 개선이 많이 생겨도 일관된 전체 아키텍처가 자동으로 복원되지 않는 상태에 이릅니다.
도메인 슬라이스를 따라 단계적으로 재구성하고, 유지해야 할 동작을 확인하며, 옛 구현과 무관하게 그 동작을 지키는 인수·E2E 테스트가 필요합니다. 공동 아키텍처 지침은 서로 다른 개발자가 같은 미래 구조의 호환되는 부분을 만들게 합니다. 상황이 실제로 허용하는 만큼의 조직적 시간과 정당성도 필요합니다.
Strangler Fig는 모든 불확실성을 한 번에 떠안지 않는 소중한 틀입니다. 한 부분을 이해하고 도메인에서 평가하며 검증으로 보호하고 재구성합니다. 책임을 새 경로로 옮기고 옛 경로를 제거한 다음에야 다음 판돈을 겁니다. 자동으로 쉬워지지는 않지만 동시에 이해하고 통제해야 할 범위는 더 제한됩니다.
논의는 출발점으로 돌아옵니다.
한 사람이 혼자 Big Ball of Mud를 구하도록 해서는 안 됩니다.
한 사람이 반드시 지식이나 능력이 부족해서가 아닙니다. 실제로 옛 시스템을 대단히 잘 이해하고 다른 사람보다 빨리 경계를 찾아 재구성의 가장 중요한 출발점이 되는 사람이 있을 수 있습니다. 문제는 미래 시스템도 다시 그 특별한 사람에게 의존하는 경우입니다.
한 사람이 모든 관계를 머릿속에 유지할 때만 아키텍처가 작동하는 시스템은 벗어나려던 문제의 일부를 이미 재생산합니다.
새 아키텍처는 옛 Big Ball of Mud를 가장 잘 이해한 사람의 머릿속에만 존재해서는 안 됩니다.
따라서 Big Ball of Mud에서 벗어나는 과정은 영웅담이 아닙니다. 함께 책임지는 재구성입니다.
참고 문헌
섹션 제목: “참고 문헌”- Feathers, Michael C. (2004): Working Effectively with Legacy Code. Prentice Hall / Pearson, ISBN 978-0-13-117705-5. 이 책은 특성화 테스트(Characterization Tests), Seam Model, 테스트하기 어려운 레거시 시스템을 통제하며 변경하는 기법 등을 다룹니다. Pearson
- Fowler, Martin (2004): Original Strangler Fig Application. 대규모 일괄 전환의 대안으로 단계적 교체를 설명한 최초의 글입니다. martinfowler.com
- Fowler, Martin (2024): Strangler Fig. Strangler Fig 원리를 점진적인 레거시 현대화의 맥락에서 새롭게 정리한 글입니다. martinfowler.com
- Fowler, Martin (2018): Refactoring: Improving the Design of Existing Code, 제2판. Addison-Wesley. 추가 자료: Definition of Refactoring.
- Jørgensen, Magne; Nereng, Johan; Torrissen, Tobias (2026): A survey of the decommissioning of IT systems. Journal of Systems and Software, 241, 113016. DOI: 10.1016/j.jss.2026.113016.
- Liu, Kecheng; Alderson, Albert; Qureshi, Zubair (1999): Requirements recovery from legacy systems by analysing and modelling behaviour. Proceedings of the International Conference on Software Maintenance, S. 3–12. DOI: 10.1109/ICSM.1999.792485.