Communitygithub.com

Loop Engineering Skills — 순환 엔지니어링 기술

AI 코딩 에이전트를 위한 잃어버린 두뇌 — 코드보다 먼저 작성된 검증 게이트, 모든 실패에서 배우는 반사신경 스타일 메모리, 실제 앵커를 갖춘 자기 수정 루프. Claude Code는 한 줄 설치, 다른 AI는 복사-붙여넣기 프롬프트로 사용 가능합니다.

Loop Engineering Skills — 순환 엔지니어링 기술란 무엇인가요?

이 스킬은 AI 코딩 에이전트(Claude Code, Cursor, Codex 등)가 작업을 수행할 때 반사신경(Reflexion) 스타일의 언어 메모리를 통해 지속적으로 학습하고 개선하도록 설계되었습니다. 연구(Shinn et al., 2023)에 따르면, 에이전트가 각 시도 후에 성찰을 기록하고, 다음 작업 전에 최근 성찰을 읽는 이 메커니즘은 무작정 재시도하는 것보다 의사 결정 작업에서 +22%, 코드 작업에서 +11% 더 높은 성능을 보이며, 성찰 없는 단순 기억보다 8포인트 더 우수합니다. 핵심은 '더 열심히 재시도' 하는 것이 아니라 '기록된 이유'에서 학습한다는 점입니다. `.loop/LESSONS.md` 파일에 성찰을 저장하고, 실패 시 잘못된 가정을 명확히 식별하며, 약 30개 항목이 쌓이면 자동으로 압축하여 '상시 규칙'으로 승격시키는 구조로, 지속 가능하고 효율적인 학습 루프를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add haidrrrry/loop-engineering-skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Loop Memory

반사신경(Reflexion) 스타일 언어 메모리: 에이전트가 각 시도에 대해 성찰을 글로 기록하고, 저장된 성찰을 읽은 후에 행동합니다. 연구(Shinn et al., 2023)에 따르면, 이 메커니즘(성찰-저장-재읽기)은 무작정 재시도하는 것보다 훨씬 뛰어난 성능을 보입니다(12회 시도 기준 의사 결정 과제에서 +22%, 코드에서 +11% 향상). 또한 성찰 없는 단순 기억보다 8포인트 더 높습니다. 이러한 향상은 '더 열심히 재시도'하는 것이 아니라 기록된 이유에서 비롯됩니다.

프로토콜

행동 전 (모든 작업)

  1. .loop/LESSONS.md 파일을 읽습니다.
  2. 상시 규칙 섹션을 무조건 적용합니다.
  3. 가장 최근 3개의 항목을 읽습니다. 현재 작업과 관련된 항목이 있다면, 해당 항목이 접근 방식을 어떻게 바꾸는지 한 줄로 설명합니다. 관련 항목이 없으면 강제로 적용하지 않고 진행합니다.

행동 후 (모든 시도, 성공 또는 실패)

파일 형식에 따라 정확히 하나의 항목을 추가합니다.

## [날짜] — [작업, 최대 5단어] — 성공|실패
- 발생한 상황: [한 줄]
- 근본 원인 / 성공 이유: [한 줄]
- 다음에는: [하나의 구체적이고 확인 가능한 지침]

"다음에는" 항목의 품질 기준:

  • ❌ "데이터베이스에 더 신경 써라" — 확인 불가능
  • ✅ "시드 스크립트 전에 npx prisma migrate deploy를 실행하라" — 확인 가능
  • ❌ "API가 까다롭다는 것을 기억하라" — 모호함
  • ✅ "/users 엔드포인트는 50개 단위로 페이지네이션합니다. 카운트할 때는 항상 ?page=를 전달하세요" — 구체적

실패 성찰 (특별히)

시도가 실패했을 때, 성찰은 반드시 다음 질문에 답해야 합니다: 내가 잘못 믿고 있던 것은 무엇인가? 실패한 시도는 대개 오타가 아니라 잘못된 가정에서 비롯됩니다. 그 가정을 명확히 지목하세요. 그것이 교훈입니다.

유지 관리 (파일이 약 30개 항목을 초과할 때)

  1. 모든 항목을 오래된 순서대로 읽습니다.
  2. 2회 이상 반복된 교훈은 상시 규칙으로 승격되며, 하나의 명령형 문장으로 다시 작성됩니다.
  3. 승격 후 가장 오래된 20개 항목을 삭제합니다.
  4. 사용자의 승인 없이 상시 규칙을 삭제하지 마십시오.

저장하지 말아야 할 것

  • 비밀, 키, 토큰, 개인 데이터 — 실패의 원인이었더라도 절대 저장하지 마십시오.
  • 서술("그 다음 X를 시도했고, 이후 Y가 일어났다…") — 결론만 저장하십시오.
  • 중복 교훈 — 이미 있다면 다시 추가하지 말고, 승격을 고려하십시오.
  • 비난이나 자기 비판 — 교훈은 지침이지 감정이 아닙니다.

피해야 할 실패 모드

  • 기념일 메모리: 항목은 쓰지만 읽지 않는 경우. 읽는 단계가 가치의 핵심이며, 쓰기만 하는 것은 일기에 불과합니다.
  • 단일 사건에 과적합: 일회성 환경 오류는 교훈이 아닙니다. 재발할 수 없는 일은 기록하지 마십시오.
  • 무제한 성장: 아무도 읽지 않는 200개 항목의 파일은 죽은 메모리입니다. 압축하십시오.

관련 스킬