무너진 아키텍처 수정은 그만하세요: Cursor Composer와 ArchUnit으로 패키지 경계 자동 강제하기

무너진 아키텍처 수정은 그만하세요: Cursor Composer와 ArchUnit으로 패키지 경계 자동 강제하기

2026년에 우리는 더 이상 보일러플레이트 (boilerplate) 코드를 작성하지 않습니다. 대신 AI 에이전트에게 모듈 전체를 한 번에 리팩터링하도록 지시합니다. 하지만 자동화된 아키텍처 가드레일 (architectural guardrails)을 설정하지 않는다면, Cursor Composer는 여러분의 깔끔한 육각형 아키텍처 (hexagonal architecture)를 30초도 안 되어 거대한 진흙 덩어리 (ball of mud)로 만들어 버릴 것입니다.

대부분의 개발자가 실수하는 이유

• 수동적인 PR 리뷰: 빠르게 진행되는 AI 코드 생성 과정에서 불법적인 패키지 임포트 (예: domain이 infrastructure를 임포트하는 경우)를 잡아내기 위해 인간 리뷰어에게 의존하는 것은 패배할 수밖에 없는 싸움입니다.
• 정적인 문서화: 빌드 파이프라인 (build pipeline)에서 실행되는 실행 가능한 피트니스 함수 (fitness functions)를 작성하는 대신, 아무도 읽지 않는 Notion에 "아키텍처 가이드라인"을 작성하는 것입니다.
• 수동적인 엉킴 풀기: Cursor Composer가 단 한 번의 프롬프트로 5개 패키지에 걸쳐 대규모 다중 파일 리팩터링 (multi-file refactoring)을 적용한 후, 순환 의존성 (cyclical dependencies)을 수동으로 푸는 데 수 시간을 소비하는 것입니다.

올바른 방법

AI 주도 개발을 확장할 수 있는 유일한 방법은 아키텍처를 유닛 테스트 (unit tests)처럼 취급하고, Cursor Composer를 사용하여 자신의 출력물을 규제하는 ArchUnit 규칙을 생성하는 것입니다.

• 자동화된 피트니스 함수 (Automated Fitness Functions): ArchUnit 1.3.x를 사용하여 패키지 격리를 단언하는 JUnit 5 테스트를 작성함으로써, 육각형 경계가 코드 내에 엄격하게 정의되도록 보장하십시오.
• Cursor 컨텍스트화 (Contextualization): .cursorrules 파일에 ArchUnit 정의를 제공하여, LLM (예: Claude 3.7 Sonnet)이 다중 파일 편집을 시도하기도 전에 경계를 위반할 수 없음을 알게 하십시오.
• CI 기반 강제 적용 (CI-Gated Enforcement): 모든 커밋마다 이러한 아키텍처 테스트를 실행하십시오. 만약 Cursor가 경계를 침범하면 빌드가 즉시 실패하며, AI가 자신의 실수를 스스로 리팩터링하도록 강제합니다.

인터뷰를 준비 중이라면, 저는 전체 실행 추적(execution traces)이 포함된 실제 머신 코딩 문제들을 제공하는 javalld.com을 구축해 왔습니다.

코드를 보여주세요 (또는 예시)

Cursor가 순수 도메인 레이어 (pure domain layer)로 인프라 세부 사항을 유출하는 것을 방지하기 위해 필요한 정확한 ArchUnit 1.3.0 테스트는 다음과 같습니다:

@AnalyzeClasses(packages = "com.faang.billing")
class ArchitectureTest {
    @ArchTest
...

핵심 요약 (Key Takeaways)

• AI에는 가드레일 (guardrails)이 필요합니다: Cursor Composer와 같은 멀티 파일 코드 생성기 (multi-file code generators)는 매우 강력하지만, 실행 가능한 테스트가 없다면 아키텍처 의도 (architectural intent)를 파악하지 못합니다.
• 아키텍처의 시프트 레프트 (Shift-left architecture): AI가 새로운 기능을 구축하도록 프롬프트를 입력하기 전에 ArchUnit 규칙을 작성하여, AI가 도메인 경계 (domain boundaries)를 준수하도록 보장하십시오.
• 무관용 드리프트 (Zero-tolerance drift): 아키텍처 위반을 깨진 단위 테스트 (unit tests)와 똑같이 취급하십시오. 테스트가 실패(red)했다면 예외 없이 중단해야 합니다.