5 분 소요

“이거 왜 이렇게 복잡해요?”

개발을 하다 보면 한 번쯤 듣게 되는 말이다. 사용자에게서 듣기도 하고, 새로 합류한 동료에게서 듣기도 한다. 솔직히 말하면 내가 내 코드를 보면서 중얼거릴 때도 있다.

처음에는 복잡한 이유가 기술에 있다고 생각했다. 설계를 잘못했거나, 리팩토링을 미뤘거나, 레거시가 쌓였거나. 틀린 말은 아니다. 그런데 복잡해진 코드를 하나씩 거슬러 올라가 보면 이상하게도 같은 지점에 도착하곤 했다.

모호함.

무엇을 만들어야 하는지, 왜 만들어야 하는지, 어디까지 만들어야 하는지가 분명하지 않았던 순간들이다. 이번 글에서는 그 모호함이 어떻게 복잡함으로 바뀌는지, 그리고 AI가 코드를 대신 써주는 지금 우리가 어디에 힘을 써야 하는지에 대해 이야기해보려 한다.


철학이 모호하면 기능이 복잡해진다

어떤 제품이든 “우리는 무엇을 위해 존재하는가”에 대한 답이 있어야 한다. 거창하게 들리지만 사실 단순한 질문이다. 이 앱은 누구의 어떤 문제를 해결하는가.

이 답이 흐릿하면 어떤 일이 생길까.

모든 요청이 그럴듯해 보인다. 영업팀이 요청한 기능도 필요해 보이고, 운영팀이 요청한 기능도 필요해 보이고, 대표가 어디선가 보고 온 기능도 필요해 보인다. 거절할 기준이 없으니 일단 다 넣는다. 그렇게 기능은 하나씩 늘어나고, 화면에는 버튼이 늘어나고, 설정 메뉴에는 토글이 늘어난다.

결국 사용자는 길을 잃는다. 하고 싶은 건 하나인데 선택지는 열 개다. 우리는 “다양한 니즈를 충족한다”고 말하지만 사용자 입장에서는 그냥 어려운 앱이다.

철학이 없는 제품은 거절하는 법을 모른다. 그리고 거절하지 못한 것들이 복잡함이 된다.

철학의 부재는 결국 모호한 어플리케이션을 만들어낼 수밖에 없다. 기능 하나하나는 이유가 있었겠지만, 그 이유들을 꿰는 하나의 실이 없으니 전체로 보면 방향을 알 수 없는 덩어리가 된다.


모호한 요구사항은 모호한 코드를 낳는다

요구사항 문서에 이런 문장이 적혀 있다고 해보자.

“사용자가 필요한 경우 알림을 받을 수 있도록 한다.”

필요한 경우가 언제인지, 어떤 알림인지, 받지 않을 수도 있는지, 알림을 놓치면 어떻게 되는지. 아무것도 정해져 있지 않다. 그런데 일정은 정해져 있다.

개발자는 어떻게든 코드를 써야 한다. 그래서 가능한 모든 경우를 대비한다. 플래그를 하나 추가하고, 혹시 모르니 옵션을 하나 더 열어두고, 나중에 바뀔 수도 있으니 분기를 하나 더 만든다. 그렇게 “혹시 몰라서” 들어간 코드들이 쌓인다.

경험해본 사람은 알 거다. 요구사항이 모호하면 코드는 방어적이 된다. 그리고 방어적인 코드는 대부분 복잡하다.

요구사항의 모호함은 사라지지 않는다. 코드로 옮겨갈 뿐이다.


모호한 코드는 모든 것을 어렵게 만든다

모호하게 태어난 코드는 그 뒤로도 계속 비용을 청구한다.

디버깅이 어렵다. 버그를 찾으려면 “원래 어떻게 동작해야 하는지”를 알아야 한다. 그런데 그게 정해진 적이 없다. 버그인지 의도된 동작인지부터 논쟁해야 한다. 코드를 읽는 게 아니라 고고학을 하게 된다.

테스트가 어렵다. 테스트는 기대값을 적는 일이다. 기대가 모호하면 테스트도 모호해진다. 무엇을 검증해야 하는지 모르니 구현을 그대로 따라 적는 테스트가 나오고, 그런 테스트는 리팩토링할 때마다 깨진다. 지켜주는 게 아니라 발목을 잡는다.

클린한 코드와 아키텍처가 어렵다. 우리는 클린 코드를 좋아한다. 책임을 나누고, 경계를 긋고, 이름을 잘 짓는다. 그런데 이 모든 건 “무엇이 무엇인지” 알 때 가능하다. 도메인이 모호하면 경계를 그을 수 없고, 개념이 모호하면 이름을 지을 수 없다. Manager, Helper, Util 같은 이름이 늘어나는 건 대체로 우리가 그게 뭔지 모르고 있다는 신호다.

클린 코드는 기술의 문제처럼 보이지만, 사실은 명확함의 문제에 더 가깝다고 생각한다.


모호함을 묵인한 대가

그럼에도 우리는 모호함을 자주 넘긴다. 이유는 대부분 같다. 빨리 결정해야 하니까.

“일단 이렇게 가고 나중에 다시 보죠.”

이 말이 나오는 회의를 셀 수 없이 많이 겪었다. 그 자리에서는 합리적인 판단처럼 보인다. 논쟁을 길게 끌면 일정이 밀리고, 일단 만들어보면 뭔가 보일 거라는 기대도 있다.

문제는 “나중에”가 오지 않는다는 거다. 왔다고 해도 그때는 이미 그 모호함 위에 코드가 쌓이고, 데이터가 쌓이고, 사용자의 습관이 쌓인 뒤다. 처음에 30분 논쟁하면 끝났을 일이 이제는 마이그레이션과 하위 호환과 공지 문구까지 따라오는 일이 된다.

모호함을 묵인하는 건 결정을 미루는 게 아니라, 비용을 미루는 것이다. 그것도 이자를 붙여서.

기술 부채라는 말은 익숙한데, 나는 이런 걸 모호함 부채라고 부르고 싶다. 그리고 기술 부채보다 훨씬 갚기 어렵다. 기술 부채는 적어도 코드에 남아 있지만, 모호함 부채는 사람들 머릿속에 제각각 다른 모양으로 남아 있기 때문이다.


명확함은 어디서 오는가

그렇다면 명확함은 어디서 오는 걸까. 똑똑한 기획자 한 명이 문서를 잘 쓰면 생기는 걸까.

내 생각은 조금 다르다. 명확함은 두 가지 위에서 생긴다고 본다.

하나는 확고한 철학이다. 앞서 말한 “우리는 무엇을 위해 존재하는가”에 대한 답이다. 이게 있어야 판단의 기준이 생긴다.

다른 하나는 견고한 시스템이다. 여기서 말하는 시스템은 어플리케이션이 아니다. 일하는 방식이다. 요구사항이 어떤 경로로 들어오고, 누가 어떤 질문을 던지고, 어떤 상태가 되어야 개발에 들어갈 수 있는지. 그런 워크플로우를 말한다.

철학만 있고 시스템이 없으면 명확함은 사람에게 의존한다. 그 사람이 바쁘거나, 휴가를 가거나, 퇴사하면 다시 모호해진다. 반대로 시스템만 있고 철학이 없으면 절차는 돌아가는데 무엇을 위한 절차인지 알 수 없다. 형식적인 체크리스트만 남는다.

명확함은 개인의 역량이 아니라 조직의 습관에 가깝다. 철학이 방향을 잡고, 시스템이 그 방향을 매번 확인하게 만든다.


모호하면 멈추고, 논쟁하라

그래서 나는 요즘 이렇게 생각한다. 모호하면 멈춰야 한다.

멈추는 건 불편하다. 진행이 안 되는 것처럼 보이고, 까다로운 사람처럼 보이기도 한다. “그냥 적당히 해주시면 돼요”라는 말을 들으면 더 그렇다.

그런데 적당히는 없다. 개발자가 적당히 정하는 순간, 그건 코드 안에서 확정된 사양이 된다. 아무도 합의하지 않은 사양이.

그러니 모호하면 묻고, 답이 모호하면 다시 묻고, 그래도 모호하면 논쟁해야 한다. 끊임없이. 논쟁은 시간 낭비가 아니라 모호함을 해소하는 가장 싼 방법이다. 코드를 다 짜고 나서 하는 논쟁보다는 확실히 싸다.

논쟁이 없는 팀은 합의가 잘 되는 팀이 아니라, 모호함을 서로 덮어주는 팀일 수도 있다.


명확하면 추상적이어도 괜찮다

오해가 없었으면 해서 덧붙이자면, 명확함이 곧 구체적인 스펙을 의미하는 건 아니다.

“우리는 사용자가 3초 안에 송금을 끝낼 수 있게 한다.”

이 문장은 꽤 추상적이다. 화면 설계도 없고 API 스펙도 없다. 그런데 명확하다. 이 문장 하나로 많은 걸 판단할 수 있다. 확인 단계를 하나 더 넣자는 요청이 들어오면 3초를 지킬 수 있는지 물어보면 된다. 기능 두 개 중 하나를 먼저 해야 하면 어느 쪽이 3초에 더 가까운지 보면 된다.

명확하면 추상적이어도 방향은 확실하다. 그리고 방향이 확실하면 우선순위를 정할 수 있다.

반대로 아무리 구체적인 문서라도 왜 이렇게 해야 하는지가 빠져 있으면 모호하다. 문서에 없는 상황이 오는 순간 아무도 판단하지 못한다.


AI는 모호함 앞에 바보가 된다

요즘은 AI와 함께 코드를 짠다. 나도 꽤 많이 쓰고 있고, 솔직히 많이 의지하고 있다.

그런데 AI를 쓰면 쓸수록 확실해지는 게 하나 있다. AI는 모호함 앞에서 바보가 된다.

명확한 지시를 주면 놀라울 정도로 잘 해낸다. 입력과 출력이 분명하고, 제약이 분명하고, 왜 그래야 하는지가 분명하면 사람보다 빠르고 꼼꼼하다. 반면 “적당히 알아서 잘” 같은 지시를 주면 결과물은 그럴듯한데 어딘가 틀려 있다. 더 무서운 건 틀린 걸 아주 자신 있게 내놓는다는 점이다.

생각해보면 당연하다. AI는 우리가 정하지 않은 것을 대신 정해준다. 가장 그럴듯한 쪽으로. 그리고 그 “그럴듯함”은 우리 제품의 철학과는 아무 관계가 없다. 사람 개발자라면 중간에 “이거 이렇게 하는 거 맞아요?”라고 물어보기라도 했을 텐데, AI는 대체로 묻지 않고 채운다.

결국 모호한 요구사항을 AI에게 던지면 모호한 코드가 사람이 짤 때보다 훨씬 빠르게, 훨씬 많이 만들어진다. 복잡함을 생산하는 속도가 빨라질 뿐이다.


마무리

AI가 코드를 써주는 시대에 개발자의 역할이 무엇이냐는 질문을 자주 듣는다. 아직 정답은 잘 모르겠다. 다만 한 가지는 점점 확신이 생긴다.

구체화는 AI가 잘한다. 명확화는 아직 우리가 해야 한다.

무엇을 만들지, 왜 만들지, 무엇을 만들지 않을지. 이 질문들에 답하는 일은 여전히 사람의 몫이다. 그리고 그 답을 찾는 과정은 대부분 멈추고, 묻고, 논쟁하는 지루한 시간으로 채워진다.

나는 그 지루한 시간에 우리의 역량을 집중해야 한다고 생각한다. 모호함을 명확함으로 바꾸는 데 힘을 쓰고, 그렇게 얻은 명확함을 구체화하는 데에는 AI를 적극적으로 쓰자. 그게 지금 우리가 할 수 있는 가장 효율적인 분업이 아닐까 싶다.

개발의 복잡함은 모호함에서 온다. 그러니 복잡함과 싸우고 싶다면, 코드보다 먼저 모호함과 싸워야 한다.