Agentic Technical Debt 억제를 위한 ADR 기반 설계 제어 프레임워크

Context

LLM Agent 기반 개발 시 세션 반복에 따라 초기 설계 의도가 소실되는 Agentic Technical Debt 발생. Agent가 코드베이스를 기반으로 아키텍처를 자의적으로 재해석하며 설계 일관성이 붕괴되는 Drift 현상 직면.

Technical Solution

• 명시적 제약 사항 정의를 위한 PRD 및 Out-of-scope 리스트 작성으로 Agent의 임의적 기능 확장을 원천 차단
• CLAUDE.md 파일을 통한 Hard Rules 정의 및 매 세션 강제 로드 방식으로 설계 준수 강제
• ADR(Architecture Decision Record) 도입을 통해 결정 맥락, 근거, 기각 대안을 기록하여 중복 의사결정 방지
• Read(문서 분석) $\rightarrow$ Validate(범위 검증 및 충돌 확인) $\rightarrow$ Implement(구현 및 커밋 리뷰)로 이어지는 3단계 세션 파이프라인 구축
• Memory MCP 등 단순 Recall 도구가 아닌 Direction 제어 중심의 문서화 전략 채택