한빛미디어

이런 고민 해보신 적 있나요?

코드를 작성한 지 6개월이 지났는데...

어디서부터 손을 대야 할지 막막한 느낌이요.

​

기능 하나 추가했더니 엉뚱한 곳에서 버그가 터지고, 테스트 코드는 있는데 뭔가 믿음이 안 가고...

Flask나 FastAPI로 빠르게 프로토타입은 만들었는데 규모가 커지면서 점점 스파게티 코드가 되어가는 것 같고...

​

저도 프로그램을 개발하면서 이런 고민을 한두 번이 아니었어요.

그래서 이번에 출간된 『클린 아키텍처 with 파이썬』을 바로 집어들었습니다.

​

​

1. 저자는 누구?

​

샘 킨(Sam Keen)은 25년 이상의 경력을 가진 소프트웨어 엔지니어링 리더입니다.

​

소규모 스타트업부터 시작해 AWS, 룰루레몬(Lululemon), 나이키(Nike) 같은 대기업에서 파이썬으로 클라우드 네이티브 시스템을 설계해온 실전 전문가죠.

특히 룰루레몬에서는 회사 최초의 클라우드 네이티브 개발팀을 이끌며 분산 아키텍처 기준을 정립한 것으로 유명합니다.

​

흥미로운 점은, 이 책이 자바나 C# 중심으로만 이야기되던 클린 아키텍처를 "파이썬답게" 풀어보고 싶다는 저자의 진짜 고민에서 출발했다는 거예요.

"파이썬 커뮤니티에서는 클린 아키텍처가 과부하처럼 느껴진다는 시각이 많았어요.

저는 그 선입견을 깨고, 파이썬의 철학을 유지하면서도 아키텍처의 장점을 살릴 수 있다는 걸 보여주고 싶었습니다."

- Sam Keen 인터뷰 중

​

​

2. 이 책은 어떤 책인가요?

​

한마디로 정리하면 → "파이썬다운 유연성"과 "아키텍처의 엄격함"을 동시에 잡는 실전 설계 가이드입니다.

​

로버트 C. 마틴(Uncle Bob)의 고전 『Clean Architecture』의 원칙을 바탕으로 하되, Python 3.13의 최신 문법인 타입 힌팅(Type Hints), 프로토콜(Protocol), 데이터클래스(dataclass)를 적극 활용해서 파이썬 개발자들이 실제로 쓸 수 있는 코드로 구현해냅니다.

​

책 전체에 걸쳐 태스크 관리 애플리케이션(TodoApp) 하나를 예제로 삼아, 챕터가 진행될수록 시스템이 점점 진화하는 방식으로 구성되어 있어요.

GitHub에 챕터별로 실제 동작하는 코드도 함께 제공되니 실습하면서 따라가기에도 아주 좋습니다.

​

​

3. 어떤 내용을 다루나요?

총 12개 챕터로 구성되어 있고, 크게 3부분으로 나눠볼 수 있어요.

​

1) 기초 다지기 (1~3장)

​

1장에서는 클린 아키텍처가 왜 필요한지부터 설명합니다. AI 코딩 에이전트와 LLM 덕분에 코드 생산성은 폭발했지만, 역설적으로 유지보수 비용이 함께 급증한 현실에서 아키텍처가 왜 더 중요해졌는지를 설득력 있게 짚어줘요.

​

2장은 이 책에서 개인적으로 가장 중요한 챕터라고 생각합니다. SOLID 원칙 다섯 가지를 파이썬 실전 코드로 완전히 풀어냅니다. 단순히 이론 설명이 아니라, "이렇게 짜면 왜 나중에 문제가 생기는지"를 눈으로 보여주는 방식이라 이해가 정말 잘 됩니다.

​

3장은 파이썬의 동적 타이핑 특성인 덕 타이핑(Duck Typing), 타입 힌팅, 그리고 최신 기능인 Protocol을 클린 아키텍처 관점에서 어떻게 활용하는지 다룹니다.

​

2) 아키텍처 구현 (4~9장)

​

이 부분이 책의 핵심입니다. 클린 아키텍처의 동심원 레이어, 즉 도메인 계층 → 애플리케이션 계층 → 인터페이스 어댑터 계층 → 프레임워크 계층을 하나씩 구현해나가죠.

​

- 도메인 계층 : 핵심 비즈니스 로직을 외부 관심사(DB, 프레임워크, UI)로부터 완전히 격리하는 방법

- Repository 패턴 : 데이터 저장소를 추상화해서 테스트 가능성을 극대화하는 설계

- 의존성 주입(DI) : 의존성 역전 원칙(DIP)을 파이썬스럽게 구현하는 실전 기법

- Flask 통합 : 웹 프레임워크를 "세부 구현 사항"으로 대우하며 연결하는 방법

​

3) 실전 확장 (10~12장)

​

마지막 부분에서는 현업에서 만나는 난감한 상황들을 다룹니다.

​

- 이벤트 기반 아키텍처 : 이벤트를 활용한 계층 간 느슨한 결합 유지

- 레거시 코드 리팩터링 : "Strangler Fig" 패턴으로 기존 시스템을 단계적으로 클린 아키텍처로 전환하는 방법

- 관측 가능성(Observability) : 로깅과 모니터링을 아키텍처에 올바르게 녹이는 방법

4. 이 책의 가장 큰 장점은?

​

첫째, UML 다이어그램이 없어요!

​

아키텍처 책들이 흔히 UML로 가득 차 있는데, 이 책은 과감하게 코드로 설명합니다.

"개념을 이해하기에 충분한 코드"와 "실제로 동작하는 Github 코드"를 분리해서 제공하는 방식이 정말 탁월합니다.

​

둘째, AI 시대에 더 빛나는 책입니다.

​

저자가 직접 언급한 내용인데, 클린 아키텍처는 AI 코딩 도구와 궁합이 아주 좋습니다. 레이어별로 문제를 분리해두면 AI 에이전트에게 "도메인 객체 부분만 작업해줘"처럼 스코프를 좁혀서 지시할 수 있거든요. Context Rot(긴 컨텍스트에서 AI 성능이 떨어지는 현상) 문제도 자연스럽게 줄어듭니다.

​

셋째, 레거시 전환 전략이 현실적입니다.

​

빅뱅 방식으로 전체를 다시 짜는 건 거의 항상 실패한다고 단호하게 말하면서, 스트랭글러 패턴(Strangler Fig)으로 하위 레이어부터 조금씩 분리하는 현실적인 전략을 구체적으로 알려줘요.

​

​

5. 어떤 분께 추천하나요?

​

- 파이썬 개발 경력이 1~3년 이상인 중급 이상의 개발자

- 혼자 짜면 잘 돌아가는데, 팀 프로젝트나 장기 유지보수가 힘든 분

- Flask/FastAPI로 개발 중인데 점점 코드가 복잡해지는 느낌이 드는 분

- 레거시 파이썬 코드를 정리하고 싶은데 어디서 시작해야 할지 모르는 분

- AI 코딩 도구(Claude Code, Cursor 등)를 더 효과적으로 활용하고 싶은 개발자

​

단, 파이썬을 처음 배우는 분이나 OOP가 아직 낯선 분께는 다소 어려울 수 있어요.

어느 정도 Python 객체 지향 프로그래밍에 익숙한 분에게 맞는 책입니다.

​

​

6. 마무리하며...

​

솔직히 말씀드리면, "파이썬은 동적 언어니까 자바식 아키텍처는 어울리지 않아" 라는 편견을 저도 조금 갖고 있었어요.

​

그런데 이 책을 읽으면서 그 생각이 완전히 바뀌었습니다.

​

파이썬의 Protocol, 타입 힌팅, 데이터클래스를 활용하면 클린 아키텍처가 오히려 더 파이썬답게 구현될 수 있다는 걸 직접 코드로 보여주거든요.

​

단순히 "돌아가는 코드"가 아니라, 6개월 뒤, 2년 뒤에도 유지보수하기 쉬운 코드를 짜고 싶은 파이썬 개발자라면 꼭 한 번 읽어볼 만한 책입니다!

​

특히 요즘처럼 AI 코딩 도구가 급속도로 발전하는 시대일수록, 좋은 아키텍처를 갖춘 코드베이스가 더 큰 경쟁력이 된다는 점... 잊지 마세요.