FSD와 Clean Architecture의 만남: Clean F.S.D

FSD(Feature-Sliced Design)와 Clean Architecture. 두 가지는 출발점이 달라 보이지만, 실제로는 같은 질문에서 시작합니다. “어떻게 하면 코드가 복잡해지지 않으면서도, 변화에 유연하게 대응할 수 있을까?” FSD는 기능(feature) 단위로 코드를 나누어 유저 중심의 개발 흐름을 강조합니다. Clean Architecture는 의존성의 방향을 안쪽으로 제한해 도메인 로직을 지켜내는 데 집중합니다. 저는 이 둘을 결합해 Clean F.S.D라는 구조를 만들었습니다. 핵심은 간단합니다. Entities = 읽기 전용 (Read) → 안정된 도메인 모델, Server Component 중심 Features = 쓰기 전용 (Write) → 사용자 이벤트, Server Action·상태 변경 읽기와 쓰기를 명확히 분리하면, 경계가 흐려질 때 오는 혼란을 줄일 수 있습니다. 이 방식은 단순히 구조를 깔끔하게 만드는 게 아니라, AI 협업에 최적화된 설계 방식이기도 합니다. AI에게 “Entities 안에서만 작업해”라고 하면 읽기 전용 규칙을 스스로 지킵니다. “Features에서 Form을 만들어줘”라고 하면 자동으로 쓰기 맥락에서 코드를 생성합니다. 즉, 설계 철학이 AI에게도 일관된 제약 조건으로 전달되는 거죠. Clean F.S.D는 단순한 폴더 구조가 아니라 AI 시대의 개발 협업을 위한 안전장치입니다. 혹시 여러분의 프로젝트 구조에서는 읽기와 쓰기가 얼마나 명확하게 구분되어 있나요?