Loop Memory
반사신경(Reflexion) 스타일 언어 메모리: 에이전트가 각 시도에 대해 성찰을 글로 기록하고, 저장된 성찰을 읽은 후에 행동합니다. 연구(Shinn et al., 2023)에 따르면, 이 메커니즘(성찰-저장-재읽기)은 무작정 재시도하는 것보다 훨씬 뛰어난 성능을 보입니다(12회 시도 기준 의사 결정 과제에서 +22%, 코드에서 +11% 향상). 또한 성찰 없는 단순 기억보다 8포인트 더 높습니다. 이러한 향상은 '더 열심히 재시도'하는 것이 아니라 기록된 이유에서 비롯됩니다.
프로토콜
행동 전 (모든 작업)
.loop/LESSONS.md파일을 읽습니다.- 상시 규칙 섹션을 무조건 적용합니다.
- 가장 최근 3개의 항목을 읽습니다. 현재 작업과 관련된 항목이 있다면, 해당 항목이 접근 방식을 어떻게 바꾸는지 한 줄로 설명합니다. 관련 항목이 없으면 강제로 적용하지 않고 진행합니다.
행동 후 (모든 시도, 성공 또는 실패)
파일 형식에 따라 정확히 하나의 항목을 추가합니다.
## [날짜] — [작업, 최대 5단어] — 성공|실패
- 발생한 상황: [한 줄]
- 근본 원인 / 성공 이유: [한 줄]
- 다음에는: [하나의 구체적이고 확인 가능한 지침]
"다음에는" 항목의 품질 기준:
- ❌ "데이터베이스에 더 신경 써라" — 확인 불가능
- ✅ "시드 스크립트 전에
npx prisma migrate deploy를 실행하라" — 확인 가능 - ❌ "API가 까다롭다는 것을 기억하라" — 모호함
- ✅ "/users 엔드포인트는 50개 단위로 페이지네이션합니다. 카운트할 때는 항상 ?page=를 전달하세요" — 구체적
실패 성찰 (특별히)
시도가 실패했을 때, 성찰은 반드시 다음 질문에 답해야 합니다: 내가 잘못 믿고 있던 것은 무엇인가? 실패한 시도는 대개 오타가 아니라 잘못된 가정에서 비롯됩니다. 그 가정을 명확히 지목하세요. 그것이 교훈입니다.
유지 관리 (파일이 약 30개 항목을 초과할 때)
- 모든 항목을 오래된 순서대로 읽습니다.
- 2회 이상 반복된 교훈은 상시 규칙으로 승격되며, 하나의 명령형 문장으로 다시 작성됩니다.
- 승격 후 가장 오래된 20개 항목을 삭제합니다.
- 사용자의 승인 없이 상시 규칙을 삭제하지 마십시오.
저장하지 말아야 할 것
- 비밀, 키, 토큰, 개인 데이터 — 실패의 원인이었더라도 절대 저장하지 마십시오.
- 서술("그 다음 X를 시도했고, 이후 Y가 일어났다…") — 결론만 저장하십시오.
- 중복 교훈 — 이미 있다면 다시 추가하지 말고, 승격을 고려하십시오.
- 비난이나 자기 비판 — 교훈은 지침이지 감정이 아닙니다.
피해야 할 실패 모드
- 기념일 메모리: 항목은 쓰지만 읽지 않는 경우. 읽는 단계가 가치의 핵심이며, 쓰기만 하는 것은 일기에 불과합니다.
- 단일 사건에 과적합: 일회성 환경 오류는 교훈이 아닙니다. 재발할 수 없는 일은 기록하지 마십시오.
- 무제한 성장: 아무도 읽지 않는 200개 항목의 파일은 죽은 메모리입니다. 압축하십시오.