이 게시물은 AI 코딩 에이전트를 제대로 활용하려면 프롬프트보다 코드베이스 구조가 먼저여야 함을 강조합니다. 자연어 가이드라인(CLAUDE.md 등)은 해석 모호성, 컨텍스트 윈도우 한계, 즉각 피드백 부재로 인해 실패할 수 있다고 설명합니다. 반면 빌드 가드레일(모듈 의존성/컴파일 규칙)은 닫힌 루프를 만들어 위반 시 즉시 빌드 실패로 피드백을 제공한다고 말합니다. 모듈 경계가 무너지는 상황(예: model 모듈에 Spring/인프라 의존성 유입, 잘못된 의존성 추가)이 빌드 결과를 통해 교정되는 사례를 제시합니다. CLAUDE.md는 “무엇이 바람직한지”를 안내하고, 빌드 가드레일은 “무엇이 불가능한지”를 물리적으로 강제하는 보완 관계로 정리합니다. 코드 품질(Q축)만 높아서는 AI 접근성(A축)이 낮을 수 있으며, A축을 평가하는 지표로 패턴 일관성, 빌드 피드백 품질, 모듈 경계 예측 가능성, 의존성 방향 강제, 독립 실행 가능성을 제안합니다.