AI Agent 시대의 아키텍처 Drift 방지를 위한 Enforcement 기반의 Codebase Constitution 설계

Context

구전으로 전해지는 Tribal Knowledge 기반의 아키텍처 관리 체계는 AI Agent의 코드 생성 환경에서 치명적인 Architectural Drift 유발. Agent는 맥락적 제약 사항을 인지하지 못해 레이어 간 의존성 위반 및 설계 원칙 파괴를 야기하는 한계 노출.

Technical Solution

• 단순 Documentation을 넘어 시스템의 불변성과 경계를 정의하는 Constitution 개념 도입
• Directory 구조가 아닌 Responsibility 기반의 Layer Membership 정의를 통한 아키텍처 내구성 확보
• Dependency Direction 단방향성 및 Inner Layer의 Outer Layer 참조 금지 원칙 명문화
• 모든 아키텍처 규칙에 대해 의도(Intent)를 설명하는 Human Version과 준수 여부를 검증하는 Machine Version의 이원화 설계
• CI, Lint Rule, Validator 등 자동화 도구를 통한 강제성(Enforcement) 부여로 위반 코드의 Merge 원천 차단