AI 에이전트의 멍청함 해결하기: 저장소당 공유 컨텍스트 트리

AI 코딩 에이전트가 멍청해 보이는 진짜 이유는 무엇일까요? 바로 여러분이 가진 컨텍스트를 공유하지 않기 때문입니다. 여러분은 팀 역사, 코드베이스 결정, 과거 실패 등 수개월간의 정보를 지니고 있습니다. 하지만 Claw는 그런 것 없이 매번 새 세션을 시작합니다. 매주 월요일마다 동일한 아키텍처 결정을 내려야 합니다. 저장소 A의 에이전트가 헬퍼를 리팩터링하면 저장소 B의 에이전트가 다시 원래대로 되돌립니다. 아무도 이미 합의된 내용을 기록하지 않았기 때문입니다.

근본적인 문제: 인간과 에이전트는 동일한 수준의 컨텍스트를 필요로 하며, 양측 모두 최신 상태로 유지되어야 합니다. 저장소별로 AGENTS.md를 두어도 시간이 지나면 낡아지고, 저장소 간에 내용이 달라지며, 업데이트를 담당하는 사람도 없습니다. Notion과 MCP 서버를 시도해봤지만, 에이전트가 제안한 편집 내용을 Notion이 조용히 잘못 병합하는 문제가 있었습니다.

해결책: 컨텍스트 트리 저장소

한 개발자의 해결책: 트리 계층 구조로 정렬된 마크다운 노드로 구성된 저장소입니다. 각 노드에는 소유자가 있습니다. 각 작업 전에 Claw가 관련 노드를 깊이 검색하여 읽고, 작업 후에는 업데이트를 제안합니다. 이렇게 컨텍스트 트리가 자동으로 유지됩니다. 에이전트와 인간이 정확히 동일한 컨텍스트를 공유하게 됩니다.

핵심 세부 사항

• 구조: 트리 계층 구조의 .md 파일 저장소.
• 소유권: 각 노드에 명시적 소유자(인간 또는 에이전트)가 있음.
• 검색: 에이전트가 트리를 따라 내려가 각 작업 전에 관련 정보를 검색함.
• 업데이트: 작업 완료 후 에이전트가 관련 노드에 업데이트를 제안하여 컨텍스트가 자동 유지됨.

이 접근 방식은 인간과 에이전트가 항상 동일한 최신 정보 원천을 기반으로 작업할 수 있도록 보장합니다.