목록 보기
AI가 규칙을 "알잘딱" 지키는 백엔드 레포 만들기
백엔드

AI가 규칙을 "알잘딱" 지키는 백엔드 레포 만들기

채널톡
채널톡
2026년 2월 26일

두줄요약

AI가 아키텍처 규칙을 어기는 문제를 CLAUDE.md가 아니라 코드 구조와 테스트로 해결한 사례를 다뤘습니다. Go 백엔드를 DDD와 커스텀 아키텍처 테스트로 리팩토링해 AI가 안정적으로 코드를 생성하도록 만들었습니다.

문제 상황

  • Claude Code, Cursor 같은 AI 코딩 도구가 아키텍처 규칙과 의존성 금지 사항을 안정적으로 지키지 못하는 문제
  • CLAUDE.md 같은 자연어 지침은 모호하고 무시될 수 있어, 사람이 리뷰에서 다시 잡아야 하는 한계
  • God Object와 과도한 cross-import로 인해 영향 범위 추적과 일관된 코드 생성이 어려운 구조

원인 분석

  • 자연어 규칙은 해석 여지가 커서 AI가 강제력 있게 따르기 어려움
  • 구조가 정리되지 않으면 규칙 자체를 명확하게 정의하고 검증하기 어려움
  • 모듈 패턴이 제각각이면 AI가 예측 가능한 코드 형태를 학습하기 어려움

해결 방법

  • DDD 기반 리팩토링으로 도메인/서브도메인 경계와 대칭적인 구조를 정리
  • alias.go, Public Service, Saga 패턴으로 외부 접근 경로와 도메인 간 의존성 통제
  • go/ast 기반 커스텀 아키텍처 테스트와 타입 체크, 린터로 규칙을 결정론적으로 강제
  • pre-commit, pre-push, CI 단계의 enforcement pipeline으로 위반을 조기 차단

댓글 0

댓글을 작성하려면 로그인이 필요합니다.

댓글을 불러오는 중...