백엔드
AI가 규칙을 "알잘딱" 지키는 백엔드 레포 만들기
두줄요약
AI가 자연어 규칙을 무시하는 문제를 해결하기 위해 Go 백엔드를 DDD 구조로 리팩토링했습니다. 커스텀 아키텍처 테스트와 CI 강제로 규칙을 코드 수준에서 검증하도록 만들었습니다.
문제 상황
- AI 코딩 도구가 CLAUDE.md 같은 자연어 규칙을 자주 무시해 아키텍처 위반 코드가 생성되는 문제
- God Object 구조와 모듈 간 과도한 교차 의존으로 인해 영향 범위 추적과 코드 생성 패턴 예측이 어려운 상태
원인 분석
- 자연어 컨텍스트 파일의 모호성과 규칙 충돌, 긴 컨텍스트에서의 지침 누락
- 규칙이 문서에만 있고 코드 구조와 테스트로 강제되지 않아 결정론적 검증 부재
해결 방법
- DDD 기반으로 도메인 구조를 정리하고 alias.go, Public Service, Saga로 외부 접근과 도메인 간 호출 경계 설정
- Go AST 기반 커스텀 아키텍처 테스트와 golangci-lint, 타입 시스템, pre-commit/pre-push/CI 파이프라인으로 규칙 강제
성능/운영 포인트
- 점진적으로 WARNING에서 ERROR로 전환해 기존 코드베이스를 무리 없이 정리
- 테스트 실패 메시지로 AI가 스스로 잘못된 의존성과 네이밍을 수정하는 자율 리팩토링 루프 구성