remember

remember skill 개요

remember가 하는 일

remember skill은 사실, 규칙, 결정 사항, 주의할 점을 Claude auto-memory에 명시적으로 저장하기 위한 집중형 Knowledge Capture skill입니다. 자동 캡처에만 맡기기에는 너무 중요한 내용을 다룰 때 사용하도록 설계되었습니다. 예를 들어 “드디어 CI 문제의 원인을 찾았다”, “이 프로젝트에는 문서화되지 않은 규칙이 있다”, “Claude가 이 팀의 선호를 잊으면 안 된다” 같은 순간에 적합합니다.

어시스턴트에게 “이거 기억해 둬”라고 말한 뒤 실제로 남아 있기를 기대하는 대신, remember는 에이전트에게 반복 가능한 워크플로를 제공합니다. 지식을 해석하고, 중복을 확인한 다음, 타임스탬프가 포함된 맥락 있는 메모리 항목으로 기록합니다.

잘 맞는 사용자와 팀

remember skill은 반복되는 맥락이 중요한 장기 프로젝트에 특히 잘 맞습니다. 엔지니어링 팀, 여러 저장소를 오가는 1인 개발자, AI 지원 디버깅 워크플로, 시간이 지날수록 더 나아져야 하는 에이전트에 유용합니다. 중요한 지식이 채팅 기록에는 있지만 아직 CLAUDE.md, 문서, 테스트, 코드 주석에는 반영되지 않은 경우 특히 효과적입니다.

다만 이 skill은 완전한 지식 베이스, 노트 앱, 문서 생성기가 아닙니다. 역할은 더 좁습니다. 향후 Claude 세션에 영향을 주어야 하는 간결하고 실행 가능한 기억을 남기는 것입니다.

일반 프롬프트와 다른 점

“이거 기억해” 같은 일반 프롬프트는 모호합니다. remember skill은 운영상 필요한 절차를 더합니다. 무엇을 기억해야 하는지, 왜 중요한지, 그 기억이 프로젝트 전용인지 전역적인 선호인지 확인합니다. 또한 메모리 파일이 같은 사실의 반복 버전으로 지저분해지지 않도록 중복 확인 단계도 포함합니다.

그래서 remember는 잊어버렸을 때의 비용이 큰 상황에서 가치가 큽니다. 반복 디버깅, 잘못된 도구 선택, 무시된 코딩 규칙, 선호도의 흔들림 같은 문제를 줄이는 데 도움이 됩니다.

remember skill 사용 방법

remember 설치와 소스 검토

예를 들어 다음처럼 사용하는 skill manager로 저장소에서 skill을 설치합니다.

npx skills add alirezarezvani/claude-skills --skill remember

그다음 아래 위치의 소스를 확인합니다.

engineering-team/self-improving-agent/skills/remember/SKILL.md

이 skill은 작고, 저장소 미리보기 기준으로 별도의 scripts/, references/, rules/, resources/ 디렉터리가 없습니다. 따라서 핵심적으로 읽어야 할 파일은 SKILL.md입니다. 프로덕션 에이전트 구성에서 사용하기 전에 사용 예시, 중복 확인 명령, 메모리 항목 작성 워크플로를 주의 깊게 확인하세요.

기본 remember 사용법

저장하고 싶은 정확한 지식을 /si:remember 뒤에 붙여 호출합니다.

/si:remember "This project's CI requires Node 20 LTS — v22 breaks the build"

좋은 입력은 구체적이고, 오래 유효하며, 실행 가능해야 합니다. 약한 입력은 다음과 같습니다.

/si:remember "CI is weird"

더 나은 입력은 다음과 같습니다.

/si:remember "CI fails on Node 22 because the build image expects Node 20 LTS; use Node 20 for local reproduction and GitHub Actions parity"

더 강한 버전은 미래의 Claude에게 무슨 일이 있었는지, 어디에 적용되는지, 어떤 행동을 해야 하는지 알려 줍니다.

프롬프트에 포함할 내용

좋은 결과를 얻으려면 네 가지 정보를 포함하세요.

• 사실: Claude가 보존해야 할 내용.
• 맥락: 적용되는 위치. 예: repo, endpoint, test suite, tool, team.
• 이유: 잊었을 때 왜 나쁜 출력이 나오는지.
• 범위: 프로젝트 전용인지, 일반 선호인지.

예시:

/si:remember "Project-specific: In this repo, API auth uses a custom JWT library instead of passport. Do not recommend passport middleware unless we are replacing the auth layer."

이렇게 입력하면 단순히 흐릿한 메모가 아니라, 나중에 실제로 쓸모 있는 메모리를 만들 수 있는 재료가 충분해집니다.

Knowledge Capture를 위한 실전 워크플로

발견, 결정, 수정이 생긴 직후 remember를 사용하세요. 정보가 아직 생생하고 대화가 다른 주제로 넘어가기 전이 가장 좋은 타이밍입니다.

실용적인 흐름은 다음과 같습니다.

1. 디버깅, 리뷰, 계획 중 오래 유효할 사실을 발견합니다.
2. 맥락과 결과를 담아 한 문장으로 정리합니다.
3. /si:remember "<fact>"를 실행합니다.
4. skill이 중복 메모리를 확인하게 합니다.
5. 비슷한 항목이 이미 있다면 새 잡음을 추가하지 말고 업데이트하거나 명확히 합니다.
6. 새 메모리를 향후 세션에서 사용할 수 있는 상태로 두고 작업을 이어갑니다.

이 워크플로는 메모리를 대화 기록 전체의 사본으로 만들지 않으면서도 유용하게 유지해 줍니다.

remember skill FAQ

remember는 언제 사용해야 하나요?

remember는 해당 지식이 향후 작업에 영향을 줄 가능성이 있고, 코드베이스나 문서만 봐서는 이미 명확하지 않을 때 사용하세요. 좋은 후보로는 빌드 요구사항, 프레임워크 제약, 아키텍처 결정, 반복되는 테스트 문제, 문서화되지 않은 규칙, 안정적인 사용자 또는 팀 선호가 있습니다.

“지금 파일 X를 편집 중이다”처럼 일시적인 작업 상태에는 사용하지 마세요. 단, 세션이 끝난 뒤에도 그 사실이 중요하다면 예외입니다.

remember는 초보자에게도 적합한가요?

네. 명령 자체는 단순합니다. 다만 초보자는 모호하거나 감정적인 메모를 저장하지 않도록 주의해야 합니다. “the database is annoying” 같은 메모리는 도움이 되지 않습니다. 반면 “Local DB tests require Docker Compose service postgres-test to be running before npm test” 같은 메모리는 유용합니다.

이 skill은 사용자가 운영상 배운 점을 명확히 설명할 수 있을 때 가장 잘 작동합니다.

remember와 CLAUDE.md는 어떻게 다른가요?

CLAUDE.md는 향후 모든 에이전트가 저장소의 일부로 읽어야 하는 안정적이고 공유되는 프로젝트 지침에 더 적합합니다. remember는 점진적 학습, 어렵게 얻은 발견, 아직 공식 문서로 정리할 준비가 되지 않은 맥락에 더 적합합니다.

좋은 패턴은 먼저 remember를 사용하고, 반복되거나 팀 전체에 필요한 메모리는 이후 CLAUDE.md, README 파일, 테스트, 아키텍처 문서로 승격하는 것입니다.

remember를 쓰지 말아야 할 때는 언제인가요?

비밀값, 인증 정보, 개인 토큰, 민감한 개인정보에는 remember를 사용하지 마세요. 팀 전체가 볼 수 있어야 하는 지식이라면 소스 관리되는 문서를 대체하는 용도로도 사용하지 마세요. 또한 추측, 해결되지 않은 가설, 일회성 관찰을 저장하는 것도 피하세요. 꼭 저장해야 한다면 불확실하다는 점을 명확히 표시해야 합니다.

메모리는 미래의 실수를 줄여야지, 추측을 보존하는 공간이 되어서는 안 됩니다.

remember skill 개선 방법

더 선명한 입력으로 remember 결과 개선하기

품질을 가장 크게 좌우하는 요소는 입력 문장입니다. remember를 호출하기 전에 거친 발견을 오래 쓸 수 있는 지침으로 다시 작성하세요.

거친 입력:

/si:remember "Jest hangs sometimes"

개선된 입력:

/si:remember "Project-specific: Jest integration tests can hang after DB tests unless run with --forceExit; use this flag when reproducing CI test hangs locally."

이 버전은 도구, 조건, 우회 방법, 범위를 모두 명시합니다. 그래서 저장된 메모리를 Claude가 나중에 더 정확하게 적용할 수 있습니다.

중복되고 오래된 메모리 피하기

업스트림 워크플로에는 프로젝트 메모리 파일을 대상으로 하는 중복 확인 단계가 포함되어 있습니다. 이 단계를 반드시 지키세요. 중복 메모리는 특히 시간이 지나며 규칙이 바뀔 때 서로 충돌하는 지침을 만들 수 있습니다.

오래된 항목을 발견했다면 메모리를 개념적으로 수정하는 쪽을 우선하세요. 예를 들어 “This replaces the old Node 18 note; the project now standardizes on Node 20 LTS.”처럼 명확히 대체 관계를 남기는 편이 모순되는 사실을 계속 쌓는 것보다 낫습니다.

반복되는 메모리는 문서로 승격하기

같은 기억된 사실이 여러 기여자에게 영향을 준다면 메모리 밖으로 꺼내세요. CLAUDE.md, README.md, 온보딩 문서, 테스트 설정 메모, architecture decision records에 추가하세요. remember는 포착에는 뛰어나지만, 공유된 거버넌스에는 소스 관리되는 문서가 더 적합합니다.

유용한 기준은 이렇습니다. Claude가 그 메모리를 두 번 넘게 필요로 했다면, 사람도 아마 필요합니다.

주의해야 할 일반적인 실패 패턴

주요 실패 패턴은 과도한 저장, 범위가 불분명한 저장, 근거 없는 결론 저장입니다. “always use explicit error handling”처럼 너무 넓은 항목은 피하세요. 정말 전역 선호가 아니라면 더 좁게 범위를 잡은 지침이 낫습니다. 예: “In this repo, avoid catch-all error handlers in API routes because errors are logged by middleware.”

좋은 remember 사용은 에이전트를 경직되거나 시끄럽게 만들지 않으면서, 향후 지원 품질을 높이는 간결하고 맥락 있는 메모리를 만듭니다.