neozest : neo+zest

주말부터 틈틈이 읽은 책 한 권이 있다. 데이비드 토머스(David Thomas)의 《Simplicity》, 국내 번역 제목으로는 《미니멀리즘
프로그래머》다. 《실용주의 프로그래머(The Pragmatic Programmer)》 공동 저자로 잘 알려진 그의 신작이다. 분량은 약 190쪽 정도라 금방 읽을 수 있을 것 같았지만, 막상 읽기 시작하니 책장이 쉽게 넘어가지 않았다. 책의 내용이 어렵기 때문이라기보다는, 문장 하나하나가 개발자로서의 나를 되돌아보게 만들었기 때문이다.

읽는 내내 떠올랐던 책은 역시 저자의 전작 《실용주의 프로그래머》였다. 그 책이 개발자의 태도와 사고방식을 이야기했다면, 이 책은 그 연장선에서 '단순함(Simplicity)'이라는 관점으로 소프트웨어 개발을 다시 바라보게 만든다.

복잡함과 난해함은 다르다

책 초반에 등장하는 문장이 인상 깊었다.

"소프트웨어의 복합(complex)적인 면은 다루기 어렵지만, 그 안에는 분명한 규칙이 존재합니다. 하지만 그 규칙을 무시하면 복잡함(complicated)이 찾아옵니다."

소프트웨어는 본질적으로 복잡한 시스템이다. 하지만 복잡함 자체가 문제는 아니다. 복잡한 시스템에도 일정한 구조와 규칙이 존재한다. 문제는 그 규칙을 이해하려 하지 않고 임의로 덧붙이고 얽어매기 시작할 때 발생한다. 그 순간 시스템은 '복합적(complex)'인 상태에서 '난해한(complicated)' 상태로 변한다.

개발을 하다 보면 이런 상황을 자주 보게 된다. 원래는 구조적으로 이해할 수 있는 문제였는데, 일정에 쫓기거나 임시방편이 반복되면서 결국 아무도 이해하지 못하는 시스템이 되어버리는 경우다. 책은 그런 상황을 피하기 위한 기본적인 태도를 반복해서 이야기한다.

배움은 시간을 '만들어야' 한다

책에서 또 하나 기억에 남는 문장이 있다.

"어떻게든 시간을 마련해야 합니다. 그렇지 않으면 배우고 개선할 수 없습니다."

누구나 알고 있는 말이다. 하지만 실천하기 가장 어려운 말이기도 하다.
개발자의 일정은 항상 바쁘다. 기능을 만들어야 하고, 버그를 수정해야 하고, 운영 이슈도 대응해야 한다. 그러다 보면 새로운 것을 배우는 일은 항상 뒤로 밀린다. 하지만 저자는 여기서 한 걸음 더 나아간다. 학습은 단순한 지식 축적이 아니라 '피드백 루프'의 일부라고 말한다.

책에서 제시하는 기본적인 흐름은 다음과 같다.

현행 파악 → 실행 → 학습 → 다시 개선

개발에서 흔히 말하는 feedback, retrospective, iteration과 같은 개념들이 자연스럽게 연결된다. 결국 좋은 개발 프로세스라는 것은 거창한 것이 아니라 지속적으로 피드백을 받으며 개선하는 루프를 만드는 일이라는 생각이 들었다.

의존성은 통제권을 넘기는 일

요즘 개발은 외부 모듈과 프레임워크 위에서 이루어지는 경우가 많다. 생산성 면에서는 분명 장점이 크다. 하지만 저자는 의존성에 대해 상당히 조심스러운태도를 보인다.

"의존성을 추가하면 미래의 내가 가져야 할 통제권의 일부를 남에게 넘겨주는 것이나 다름없다."

특히 프레임워크에 대해서는 더 강하게 경계한다.

"프레임워크가 API를 쥐고 있을 뿐만 아니라 애플리케이션 아키텍처를 어떻게 짤지까지 규정해 버리기 때문."

저자의 메시지는 프레임워크를 쓰지 말라는 것이 아니라, 사고의 주도권을 개발자가 가져야 한다는 것에 가깝다.

자동화는 인지적 부담을 줄인다

책에서 반복적으로 등장하는 또 하나의 주제는 인지적 부담(cognitive load)이다. 훌륭한 개발자는 시스템의 인지적 부담을 줄이는 사람이라고 저자는 말한다. 그 방법 중 하나가 자동화다.

반복적인 작업을 자동화하면 개발자는 문제 해결에 더 많은 집중력을 사용할 수 있다. 이 부분을 읽으면서 자연스럽게 떠오른 것이 CLI 기반 자동화였다. 최근 AI Agent 분야에서 "스킬 + CLI" 방식이 주목받는 것도 같은 맥락이라고 생각한다.

팀과 커뮤니케이션도 시스템이다

이 책이 흥미로운 이유는 기술 이야기만 하지 않는다는 점이다. 팀과 커뮤니케이션도 하나의 시스템으로 바라본다.

특히 인상 깊었던 문장은 다음이다.

"다양성은 회복력입니다."

그래서 저자는 팀 리더의 역할을 정보 흐름을 설계하는 사람으로 본다. 회의 방식, 의사결정 구조, 참석자 구성 등도 모두 시스템 설계의 일부다. 이 부분을 읽으면서 "프로그래머"라는 책 제목이 조금 좁게 느껴졌다. 오히려 PO, PM, 팀 리더 같은 역할을 하는 사람들에게 더 도움이 될 수도 있는 책이라는 생각이 들었다.

"할 수 있다"와 "해야 한다"는 다르다

책 후반부에서 특히 공감했던 문장이 있다.

"할 수 있다고 해서 좋은 생각인 것은 아니다."

기술적으로 가능한 것만 강조하는 대화는 개발 현장에서 자주 등장한다. 하지만 엔지니어링의 본질은 가능한 것을 만드는 것이 아니라 문제에 가장 적절한 해답을 찾는 것일지도 모른다.

상태 머신에 대한 공감

책에서 상태 머신(state machine)을 활용하라는 부분도 개인적으로 공감이 컸다. 대부분의 업무 로직은 상태 기반으로 동작한다. 로그인 상태, 주문 상태, 결제 상태, 실행 상태 등 거의 모든 시스템이 상태 변화를 중심으로 움직인다. 그런데도 많은 코드가 이를 명시적으로 표현하지 않는다.

저자의 말처럼 상태를 명확히 모델링하는 것만으로도 시스템은 훨씬 단순해질 수 있다.

결국, 다시 《실용주의 프로그래머》

책을 다 읽고 나니 자연스럽게 떠오른 생각이 하나 있다.

"다시 《실용주의 프로그래머》를 읽어보고 싶다."

이 책은 개발 기술 자체를 가르쳐주는 책이라기보다는 개발자가 어떤 태도와 사고방식을 가져야 하는지를 다시 점검하게 만드는 책이다. 190쪽 남짓한 얇은 책이지만, 읽는 동안 계속해서 스스로에게 질문하게 만든다.

• 지금 내가 만들고 있는 시스템은 정말 단순한가?
• 내가 사용하는 도구와 프레임워크는 문제 해결을 위한 것인가?
• 나는 배우고 개선할 시간을 제대로 만들고 있는가?

* 이 글은 책을 읽으면서 트위터에 남겼던 기록을 기반으로 GPT가 글 초안을 작성했고, 다시 Neo가 다듬어 보았습니다.

요즘은 모듈/패키지/프레임워크를 이용하여 기능을 구현하는 경우가 많다. 생산성을 위해서는 그럴 수 밖에 없다고 생각한다. 그러다보니 그냥 동작하는 것처럼만 보이면 OK인것처럼 인식하는 경우도 많다. 하지만 문제와 해결방안, 그 원리를 이해하지 않으면 작성된 코드들이 결국 유지보수하는 과정에서 복잡도가 증가하여 오래 살아남기 힘들다.

이런 문제의 해결 방법은 의도를 가지고 코드를 작성하는 것이라 생각하는데.. 의도를 가지려면 본인이 해결하고자 하는 문제를 인식하고 그에 대한 해결 방안에 대한 이론과 가설을 세워야 한다. 문제를 어떻게 인식하고 접근할 것인가에서는 세상을 바라보는 사상이나 철학이 반영된다고 생각한다. 중요한 것은 자신의 접근방식 모델을 세운 다음 코드를 작성해야 한다는 점!

즉, 자신이 해결하려는 문제를 인식하여 과제로 정리한 후, 문제에 대한 이해를 바탕으로 나름의 이론과 가설을 세워 해결방안 또는 접근방안을 만들고, 이를 코드로 녹여내려는 의식적인 흐름이 필요하다. 이런 생각을 가지고 있던 중 실용주의 프로그래머 20주년 기념판 288쪽-289쪽에 좋은 내용이 나와있어서 핵심 문구만 소개한다.

• 코드를 마주 찍어내는데에 드는 시간을 줄이고 싶고, 가능한 한 개발 주기 초기에 오류를 잡아서 고치고 싶고, 애초부터 오류를 더 적게 만들고 싶다면 의도적으로 프로그래밍 해야 한다.
• 언제나 지금 무엇을 하고 있는지 알아야 한다.
• 더 경험이 적은 프로그래머에게 코드를 상세히 설명할 수 있는가?
• 자신도 잘 모르는 코드를 만들지 마라
• 계획을 세우고 그것을 바탕으로 진행하라
• 신뢰할 수 있는 것에만 기대라
• 가정에 의존하지 마라. 무언가를 신뢰할 수 있을지 판단하기 어렵다면 일단 최악의 상황을 가정하라
• 가정을 기록으로 남겨라
• 코드 뿐만 아니라 여러분이 세운 가정도 테스트 해보라.
• 추측만 하지 말고 실제로 시험해보라
• 중요한 것에 먼저 시간을 투자하라. 중요한 부분이 가장 어려운 부분이기도 한 경우가 많다
• 더는 적절한 코드가 아니라 싶으면 어떤 코드라도 교체할 수 있다. -> 리팩토링

사족> 실용주의 프로그래머 20주년판 2/3 정도 읽었는데, 정말 세월의 흐름에 상관없이 읽어볼 책이다. 저자는 20년동안 정체된 것이 아니라 발전하는 개발자의 모습을 보여준다.

사족#2> ChatGPT를 개발에 많이 활용해 보고 있다. ChatGPT가 주는 답이 기존 구글링보다 좋은 검색결과라기 보다는 내 머리속에 혼재되어 있는 생각들을 ChatGPT와 대화하면서  모델로 만들 수 있기 때문에 큰 도움이 된다고 생각한다. 그 모델에 확신을 더해 의도를 명확하게 하여 코드를 작성하는 것!