8년의 갈망, 3개월의 완성 - AI가 바꾼 사이드 프로젝트의 공식

Context

AI 생성 코드의 무분별한 수용으로 인한 코드베이스 오염 발생. 빠른 프로토타이핑 속도 대비 낮은 유지보수성과 설계 품질의 괴리 존재. 정량적 커버리지 수치와 실제 논리적 결함 사이의 간극 확인.

Technical Solution

• Claude 기반의 빠른 프로토타이핑 후 불필요한 코드를 제거하는 점진적 리팩토링 전략 채택
• pre-commit 훅에 타입체커를 통합하여 정적 분석 기반의 런타임 에러 사전 차단 구조 설계
• 단순 단위 테스트의 한계를 극복하기 위해 BDD 및 명세 기반 개발 방식을 AI 워크플로우에 결합
• equivalence partitioning 기법을 AI 에이전트로 자동화하여 60개 모델의 입력 공간 검증
• TLA+를 활용한 시스템 동작 명세화 및 순수 함수 분리를 통한 입력-출력 매핑 테스트 강화
• ClickHouse SQL 설계 시 AI 제안 템플릿 기반 방식을 도입하여 중복 제거 및 쿼리 성능 최적화

Impact

• 생산성 20~50% 향상
• 타입체커 도입 후 2시간 만에 90개 에러 수정
• 250시간의 실제 개발 투입을 통한 AI 보조 시스템 프로그래밍 모델 검증

Key Takeaway

AI는 로컬한 코드 생성에는 강력하나 전체 아키텍처 설계와 트레이드오프 판단에는 한계가 있음. '버릴 전제'의 빠른 프로토타이핑 후 사람이 직접 리뷰하고 리팩토링하는 반복적 정제 과정이 필수적임.