이 게시물은 AI 코딩 도구가 CLAUDE.md 같은 컨텍스트 문서를 무시해 아키텍처 규칙을 자주 어기는 문제를 해결한 사례를 다룹니다. 규칙을 자연어로 문서화(CLAUDE.md)하는 대신 타입 체크, 린터, 커스텀 아키텍처 테스트로 위반을 결정론적으로 강제하는 방향을 선택합니다. DDD 기반 리팩토링으로 God Object를 해체하고, 도메인 간 조율은 Saga가 담당하며 alias.go를 통해 외부 진입점만 허용하도록 구조를 정리합니다. Go 컨벤션 v2와 대칭성(symmetry)을 적용해 도메인/계층/패턴을 예측 가능하게 만들고, 패키지명 stutter 제거 등 네이밍 규칙도 일관화합니다. 커스텀 아키텍처 테스트는 Go AST(go/ast)를 파싱해 의존성, 네이밍, 인터페이스 패턴, 구조 규칙을 위반 시 fail로 감지하며 CI에 통합합니다. 점진적 enforcement을 위해 초기엔 WARNING으로 시작해 수정 완료된 도메인을 ERROR로 전환하며 최종적으로 7개 도메인과 9개 saga를 enforced 상태로 가져옵니다. 좋은 아키텍처 테스트가 있으면 Claude Code가 사람 개입 없이 리팩토링을 수행하고, 위반을 에러 메시지로 즉시 교정할 수 있다고 설명합니다.