왜 AI 에이전트가 작업에서 벗어나는가 (그리고 3-File 해결)

Source: Dev.to

문제점

AI 에이전트를 완벽하게 설정했는데, 일주일 뒤면 명확히 제시한 규칙을 무시하고 있습니다. 설정을 바꾸지 않았는데 무슨 일이 일어난 걸까요?
이는 컨텍스트 드리프트—프로덕션 AI 에이전트 환경에서 가장 흔한 실패 유형 중 하나입니다.

모든 에이전트는 컨텍스트 윈도우 안에서 동작합니다. 원래 지시에서 멀어질수록 그 지시가 점점 희석됩니다.

트리거

• 긴 작업 체인 – 8번의 툴 호출 후, 시스템 프롬프트가 6,000 토큰 전으로 밀려남.
• 서브‑에이전트 핸드‑오프 – 작업은 전달했지만 행동 제약은 전달하지 않음.
• 세션 재시작 – 크론 잡이 오래된 지시와 함께 에이전트를 다시 로드함.

해결책

행동 규칙을 시스템 프롬프트에만 두지 말고, 명시적으로 다시 읽히는 파일에 저장하세요.

다른 작업을 하기 전에 반드시 할 일

1. SOUL.md 읽기
2. USER.md 읽기
3. 그 다음 진행

이렇게 하면 정체성 재로드가 눈에 보이는 단계가 되고, 보이지 않는 가정이 사라집니다.

지속적인 로깅

• 일일 로그 파일이 모든 내용을 캡처합니다.
• MEMORY.md는 정제된 버전 – 세션을 넘어 유지할 가치가 있는 교훈들.

선별된 메모리를 가진 에이전트는 시간이 지날수록 더 날카로워집니다. 일일 로그만 가진 에이전트는 컨텍스트를 빠르게 채워버립니다.

상태 지속성

에이전트가 현재 작업을 알아야 한다면 파일에 기록하세요. 머릿속 메모리는 재시작 시 사라집니다.

{
  "task": "write weekly newsletter",
  "status": "in_progress",
  "started": "2026-03-08T09:00:00"
}

AI 에이전트는 파일에서 상태를 읽어들이는 무상태 함수입니다. 이를 내면화하면 드리프트가 신비롭게 느껴지지 않습니다.

당신은 다음을 구현하는 에이전트를 만들게 됩니다:

• 정체성을 명시적으로 재로드하고,
• 상태를 지속적으로 기록하며,
• 매 세션을 정확히 자신이 누구인지 알고 시작하는 새로운 시작으로 취급합니다.

추가 읽을거리

Ask Patrick Library는 세션, 핸드‑오프, 프로덕션 루프 전반에 걸쳐 에이전트를 작업에 집중시키는 76개의 검증된 패턴을 문서화하고 있습니다.

→ 라이브러리를 탐색해 보세요.