6 months of .md memory, conflicting facts are the hard part
TL;DR Highlight
AI 에이전트 메모리를 마크다운 파일로 6개월 운영하면서 발견한 지식 충돌 문제와 Telegram 봇으로 사람이 직접 해결하는 에스컬레이션 패턴 소개
Who Should Read
로컬 AI 코딩 에이전트를 직접 운영하면서 장기 메모리 아키텍처를 고민하는 개발자. 특히 에이전트가 시간이 지나면서 잘못된 사실을 학습하는 문제를 겪고 있는 분들.
Core Mechanics
- .md 파일을 파일시스템으로 쓰는 에이전트 메모리 구조를 6개월 운영하고 클라우드로 마이그레이션 중 — 크로스링크, 청크 truncation, 지식 추출 기능을 추가했음.
- 메모리 레이어를 두 계층으로 설계: 하루에도 여러 번 업데이트되는 '웜(warm)' 지식 레이어 + 크로스링크가 많은 '아카이브(archive)' 레이어.
- 지식베이스에 서로 모순되는 사실들이 쌓이면 에이전트가 hallucination(모델이 잘못된 정보를 사실처럼 말하는 현상)을 일으키는 문제를 발견.
- 기존 서드파티 툴들은 최신성(recency) 기준으로 충돌을 자동 해결하지만, 이 개발자는 self-hosted + human-in-the-loop 방식을 선택.
- Telegram 봇을 통한 에스컬레이션 메커니즘 구현: 충돌 감지 시 사람에게 알림을 보내고, 사람의 판단 결과를 임베딩해서 이후 충돌 해결의 '진실(truth)'로 활용.
- 3주간 운영 결과 hallucination이 개선된 것으로 보이나, '언제 자동 해결하고 언제 사람에게 넘길지'와 '사람 입력을 진실로 쓰는 게 맞는지'는 여전히 미해결 질문.
Evidence
- 6개월 이상 .md 파일시스템 기반 에이전트 메모리를 실제 운영한 실전 경험 기반 — 특정 수치 벤치마크는 없으나 장기 운영 사례.
- 에스컬레이션 메커니즘 도입 후 3주간 hallucination이 개선된 것으로 체감 — 정량 지표는 없음.
- 충돌 해결 결과를 임베딩(텍스트를 벡터로 변환해 검색 가능하게 하는 기법)해서 유사 충돌 시 재활용하는 방식으로 점진적 개선 구조 구축.
How to Apply
- 에이전트 메모리를 '자주 바뀌는 웜 레이어(최근 학습/결정)'와 '잘 안 바뀌는 아카이브 레이어'로 분리하고, 두 레이어 간 크로스링크를 .md 파일 내부에 명시적으로 추가하면 맥락 추적이 훨씬 쉬워짐.
- 지식베이스에 새 사실을 추가할 때 기존 내용과 모순 여부를 체크하는 로직을 넣고, 충돌 감지 시 Slack/Telegram 봇으로 사람에게 에스컬레이션하는 파이프라인을 만들면 hallucination을 사전에 차단 가능.
- 사람이 내린 충돌 해결 결정을 별도 '진실 데이터셋'으로 임베딩해두면, 이후 유사한 충돌이 생겼을 때 벡터 유사도 검색으로 자동 해결 가능 범위를 점진적으로 넓힐 수 있음.
Code Example
# 충돌 감지 + Telegram 에스컬레이션 패턴 예시 (Python 슈도코드)
import json
from pathlib import Path
def check_conflict(new_fact: str, existing_facts: list[str], embedder, threshold=0.85) -> list[str]:
"""
새 사실과 기존 사실들 사이의 의미적 충돌 감지
"""
new_vec = embedder.encode(new_fact)
conflicts = []
for fact in existing_facts:
sim = cosine_similarity(new_vec, embedder.encode(fact))
if sim > threshold: # 비슷한 주제인데
# LLM에게 모순 여부 판단 요청
prompt = f"""다음 두 사실이 서로 모순되는지 판단해줘.
사실1: {fact}
사실2: {new_fact}
모순이면 'CONFLICT', 아니면 'OK'로만 답해."""
result = llm.complete(prompt)
if 'CONFLICT' in result:
conflicts.append(fact)
return conflicts
def escalate_to_human(conflict_pair: tuple, bot_token: str, chat_id: str):
"""
Telegram으로 충돌 사실 쌍을 사람에게 전송
"""
import requests
msg = f"""⚠️ 지식 충돌 감지!
기존: {conflict_pair[0]}
신규: {conflict_pair[1]}
어떤 게 맞나요?
1️⃣ 기존 사실 유지
2️⃣ 신규 사실로 교체
3️⃣ 둘 다 틀림 (직접 입력)"""
requests.post(
f"https://api.telegram.org/bot{bot_token}/sendMessage",
json={"chat_id": chat_id, "text": msg}
)
def save_resolution(fact_a: str, fact_b: str, truth: str, resolution_db_path: str, embedder):
"""
해결 결과를 임베딩해서 나중에 유사 충돌 자동 해결에 활용
"""
resolution = {
"fact_a": fact_a,
"fact_b": fact_b,
"truth": truth,
"embedding": embedder.encode(f"{fact_a} vs {fact_b}").tolist()
}
db = json.loads(Path(resolution_db_path).read_text())
db.append(resolution)
Path(resolution_db_path).write_text(json.dumps(db, indent=2))
# 메모리 구조 예시 (.md)
"""
# warm_memory.md ← 오늘 업데이트된 학습/결정
## 최근 결정
- 2024-01-15: auth 모듈은 JWT 방식 사용 [[decisions/auth.md]]
- 2024-01-16: JWT 대신 session 기반으로 변경 ← 충돌 감지 대상!
# archive/auth.md ← 크로스링크된 아카이브
## 관련 결정: [[warm_memory.md#최근-결정]]
## 히스토리: ...
"""Terminology
Related Papers
Migrating a production AI agent to GPT-5.6: 2.2x faster, 27% cheaper
마케팅 웹사이트를 자동 생성하는 프로덕션 AI 에이전트를 Claude Opus 4.8에서 GPT-5.6 Sol로 전환한 실전 경험담으로, 단순 모델 교체가 아니라 eval 하네스, 툴 스키마, 캐싱, 추론 리플레이까지 손봐야 했던 과정을 구체적인 수치와 함께 정리했다.
What xAI's Grok build CLI sends to xAI: A wire-level analysis
xAI의 공식 코딩 CLI 도구 Grok Build가 사용자 동의 없이 전체 Git 저장소와 .env 시크릿 파일을 xAI 서버로 업로드한다는 사실이 네트워크 트래픽 분석으로 밝혀졌다.
Remember When It Matters: Proactive Memory Agent for Long-Horizon Agents
LLM 에이전트가 긴 작업 중 중요한 정보를 잊어버리는 문제를 별도의 메모리 에이전트가 '적절한 타이밍에' 끼어들어 해결하는 방법
WebSwarm: Recursive Multi-Agent Orchestration for Deep-and-Wide Web Search
복잡한 웹 검색을 재귀적으로 분해하고 각 노드에 적합한 검색 모드를 동적으로 할당하는 멀티에이전트 프레임워크
Show HN: Reverse-engineering web apps into agent tools
로그인된 웹 앱의 API 호출을 브라우저에서 감시해 자동으로 MCP 도구로 변환하는 에이전트를 만들었다. 소스 코드나 공식 API 문서 없이도 Jira, Spotify 같은 서비스에 AI 어시스턴트를 붙일 수 있다.
Show HN: FableCut – A browser video editor AI agents can drive (zero deps)
타임라인 전체를 JSON 파일 하나로 표현하고 MCP/REST로 AI 에이전트가 직접 편집할 수 있는 브라우저 비디오 에디터로, Claude 같은 AI가 프롬프트 하나로 영상을 자동 컷편집하고 결과를 실시간으로 UI에 반영해준다.