엔지니어가 Claude와 spec-writer, Auto-Dream, Obsidian 통합으로 AI 에이전트의 맥락 오염 문제 해결 및 워크플로우 구조화

Context

Claude를 사용하면서 구조화되지 않은 요청으로 인해 주간 할당량을 빠르게 소진했다. AI 에이전트가 프로젝트에 오래 참여하면서 MEMORY.md 파일에 오래된 노트와 상충하는 지시사항이 누적되어 에이전트의 응답 속도가 느려지고 오류가 발생했다.

Technical Solution

• spec-writer 도구 도입: 코드 작성 전에 수용 기준, 아키텍처 계획, 원자적 작업으로 구성된 스펙 문서 생성 강제
• ASSUMPTION 태그 활용: Claude가 자체 판단으로 내린 모든 결정을 명시적으로 표시하여 불필요한 코드 작성 사전 방지
• Auto-Dream 기능 활용: Claude Code의 /dreaming 명령어로 메모리 파일 자동 정리하여 사용하지 않는 정보 제거 및 맥락 통합
• Obsidian 통합: obsidian-skills 저장소를 통해 Markdown 기반 노트 간 연결을 Claude가 이해하도록 구성하여 노트 조직, 분류, 숨겨진 연결 발견 지원

Key Takeaway

AI 에이전트의 성능은 모델 자체보다 입력 맥락의 구조와 정결성에 더 큰 영향을 받는다. 스펙 문서화, 메모리 정기 정리, 명시적 가정 표시는 에이전트 기반 워크플로우의 필수 운영 원칙이다.