Specs-First 도입을 통한 AI 생성 코드의 Technical Debt 제거 및 유지보수성 확보

Context

자연어 기반의 단순 요청으로 코드를 생성하는 Vibe Coding 방식의 확산으로 인한 설계 부재 상황 분석. 비즈니스 로직과 데이터 접근 계층이 혼재된 코드 생성으로 인해 Production 환경에서 예기치 못한 런타임 에러 및 심각한 Technical Debt 축적 문제 발생.

Technical Solution

• Spec $\rightarrow$ Architecture $\rightarrow$ Code $\rightarrow$ Human Review $\rightarrow$ Integration의 단계적 파이프라인 구축
• Input/Output 타입 정의 및 Edge Case를 명시한 30라인 내외의 정밀한 Spec 파일 작성
• CLAUDE.md 파일을 통한 Project-wide 시스템 룰셋 정의로 일관된 Code Convention 강제
• Controller 내 DB 직접 접근 금지 및 보안 Sanitization 규칙 등 명시적 제약 사항(Constraints) 설정
• 단순 기능 구현 요청에서 탈피하여 Error Mode 및 HTTP Response 포맷을 사전 정의하는 설계 방식 채택