개발자가 AI 코드 어시스턴트와 장기간 협업 시 개별적으로 합리적인 결정들이 누적되어 발생하는 아키텍처 드리프트 현상의 원인 분석과 해결 방안 제시

Context

AI 코드 작성 도구를 단일 세션에서 사용하면 높은 생산성을 제공하지만, 여러 세션에 걸쳐 개발 시 개별적으로 합리적인 결정들이 서로 모순되며 아키텍처 일관성이 손상되는 문제가 발생한다. 개발자는 각 세션에서 "yes"만 입력하며 자신의 아키텍처에 대한 통제력을 점진적으로 상실하고, 기존 CLAUDE.md나 프롬프트 규칙으로는 시간과 맥락이 다른 결정 간의 충돌을 완전히 해결할 수 없다.

Technical Solution

• 아키텍처 결정 사항을 append-only JSONL 파일로 세션 간 영속 저장하는 Local Python CLI와 MCP Server 구축
• Claude Haiku 기반 감지 기능을 통해 새로운 결정이 기존 결정과 충돌하는지 자동 검사
• Kuzu 그래프 데이터베이스로 결정 간 관계와 맥락을 구조적으로 매핑
• FastAPI 기반 대시보드에서 개발자가 충돌 사항을 직접 검토하고 해결하도록 UI 제공
• 해결된 결정사항과 그 근거를 컨텍스트로 저장하여 이후 세션에서 활용

Impact

현재 베타 단계로 정량적 성능 수치 미제공

Key Takeaway

AI 코드 어시스턴트의 세션 간 기억 일관성 문제는 더 나은 프롬프트가 아닌 명시적 결정 저장과 인간 중심 해결 메커니즘으로 접근해야 한다.