review

review skill 개요

review가 하는 일

review는 Claude Code auto-memory를 점검하기 위한 self-improving-agent skill입니다. 이 review skill은 에이전트가 MEMORY.md를 살펴보고, 상위 지침으로 승격할 만한 후보를 찾고, 오래되었거나 중복된 항목을 식별하며, 프로젝트 메모리가 통제 없이 커지지 않도록 유지보수 권장사항을 제시하게 해줍니다. 에이전트가 무엇을 학습했는지, 무엇을 오래 유지할 프로젝트 지침으로 삼아야 하는지, 무엇을 정리해야 하는지 알고 싶을 때 review skill을 사용하면 좋습니다.

이 review skill이 잘 맞는 경우

이 skill은 Claude Code memory를 Context Engineering 워크플로의 일부로 사용하는 팀에 가장 유용합니다. 반복적으로 얻은 교훈, 도구 선호도, 아키텍처 결정, 자주 발생하는 실수 등이 자동으로 기록되지만 주기적인 편집 검토가 필요한 프로젝트에 잘 맞습니다. 반대로 프로젝트에서 Claude Code memory를 사용하지 않거나, .claude 프로젝트 메모리 디렉터리가 없거나, 단일 소스 파일에 대한 일회성 요약만 필요한 경우에는 유용성이 낮습니다.

일반 프롬프트와 다른 점

일반적인 “내 메모리를 요약해줘” 프롬프트는 운영 관점의 점검을 놓치기 쉽습니다. review skill은 에이전트에게 구체적인 감사 경로를 제공합니다. 프로젝트별 메모리 디렉터리를 찾고, MEMORY.md를 읽고, 200줄 startup limit에 비해 줄 수 부담이 어느 정도인지 확인하며, 반복되는 내용을 감지하고, 오래된 파일 참조를 검증한 뒤, 승격 후보와 가치가 낮은 항목을 분리합니다. 이런 구조 덕분에 장기간 유지되는 에이전트 컨텍스트를 관리할 때 결과물이 훨씬 실행 가능해집니다.

review skill 사용 방법

review 설치 및 먼저 확인할 파일

다음 명령으로 GitHub repository에서 skill을 설치합니다.

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

설치한 뒤에는 먼저 SKILL.md를 읽으세요. 이 repository 경로에는 전체 워크플로가 단일 파일에 들어 있으며, 추가로 확인해야 할 rules/, resources/, references/, scripts는 없습니다. 특히 중요한 소스 섹션은 Usage, What It Does, Step 1: Locate memory directory, Step 2: Read and analyze MEMORY.md입니다.

기본 review 사용 명령

업스트림 skill은 /si:review 형태의 호출을 기준으로 설계되어 있습니다.

• /si:review: 전체 메모리 감사
• /si:review --quick: 개수와 주요 후보만 빠르게 확인
• /si:review --stale: 오래된 항목에 집중
• /si:review --candidates: 승격 가능성이 높은 항목만 표시

실제로는 감사하려는 프로젝트의 루트에서 review skill을 호출하세요. 이 skill은 Claude Code의 프로젝트 메모리에 접근할 수 있어야 하며, 보통 현재 작업 디렉터리를 기반으로 한 ~/.claude/projects/.../memory 경로 아래에 있습니다.

review 결과를 개선하는 입력

약한 프롬프트는 다음과 같습니다.

“Review memory.”

더 나은 프롬프트는 다음과 같습니다.

“Run the review skill for this repository. Check the project auto-memory, count MEMORY.md lines against the startup limit, identify recurring lessons that should be promoted into durable instructions, flag stale entries that reference deleted files or old tools, and group recommendations by promote, consolidate, prune, and keep.”

이 방식이 더 잘 작동하는 이유는 감사 기준과 의사결정 범주를 명확히 지정하기 때문입니다. 최근 프로젝트 변경 사항을 알고 있다면 함께 적어주세요. 예를 들어 이름이 바뀐 디렉터리, 제거된 도구, 새로운 코딩 표준, 정책 변경 등이 있습니다. 이런 정보는 에이전트가 메모리 항목이 오래되었는지, 여전히 가치가 있는지 판단하는 데 도움이 됩니다.

권장 review 워크플로

메모리 파일이 크거나 우선순위 분류만 필요하다면 /si:review --quick으로 시작하세요. 컨텍스트를 새로 정비하기 전, 새 에이전트 설정을 온보딩할 때, 또는 큰 기능 개발 주기 전에 누적된 메모리를 정리할 때는 전체 review를 실행하는 것이 좋습니다. 대규모 리팩터링, 의존성 변경, 파일 이동 이후에는 --stale을 사용하세요. 목표가 Context Engineering, 즉 반복된 교훈을 CLAUDE.md, 프로젝트 문서, 팀 규칙으로 승격하는 것이라면 --candidates가 적합합니다.

review skill FAQ

review는 Claude Code memory 전용인가요?

네. 이 skill은 Claude Code auto-memory 관례에 맞춰 설계되어 있으며, 특히 ~/.claude/projects/.../memory 아래의 프로젝트 메모리와 MEMORY.md를 전제로 합니다. 다른 메모리 파일에도 review 가이드를 응용할 수는 있지만, 에이전트가 예상된 Claude Code memory layout을 따라갈 수 있을 때 가장 큰 가치를 냅니다.

메모리 디렉터리가 없으면 어떻게 되나요?

skill은 auto-memory가 비활성화되어 있거나 사용할 수 없을 수 있다고 보고한 뒤, /memory 사용 같은 메모리 설정 확인을 제안해야 합니다. 이는 설치 전 판단에도 유용한 지점입니다. 팀이 아직 Claude Code memory를 활성화하지 않았거나 충분히 쌓아두지 않았다면, review가 분석할 내용은 메모리가 생기기 전까지 많지 않습니다.

언제 review를 쓰지 말아야 하나요?

review를 코드 리뷰, 보안 리뷰, 문서 QA의 대체재로 사용하지 마세요. 이 skill은 에이전트 메모리의 품질을 감사하는 것이지, 소스 코드의 정확성을 검증하는 도구가 아닙니다. 반복 패턴이 아직 없는 신규 프로젝트, 지속적인 에이전트 메모리를 의도적으로 사용하지 않는 팀, 단일 문서의 간단한 요약만 필요한 경우에도 잘 맞지 않습니다.

Context Engineering에서 review가 어떻게 도움이 되나요?

Context Engineering에서 review는 원시 메모리를 유지보수 대기열로 바꿔줍니다. 반복적으로 관찰된 내용 중 무엇을 안정적인 컨텍스트로 만들지, 어떤 항목이 중복인지, 어떤 오래된 메모리가 미래의 에이전트를 오도하기 전에 제거되어야 하는지 판단하는 데 도움이 됩니다. 이 결과물은 에이전트의 운영 컨텍스트를 편집자가 검토하듯 다룰 때 가장 가치가 큽니다.

review skill 개선 방법

명령만 주지 말고 review에 근거를 제공하기

review skill은 에이전트가 실제 메모리 파일과 현재 repository를 확인할 수 있을 때 더 잘 작동합니다. 메모리 텍스트에만 의존하지 말고, 참조된 경로를 filesystem checks로 검증할 수 있게 하세요. 오래된 지침이 의심된다면 이유를 함께 말해 주세요. 예를 들어 “we migrated from Jest to Vitest,” “the api/legacy folder was removed,” “the deployment process changed last week.”처럼 설명하면 됩니다.

바로 결정할 수 있는 범주로 요청하기

실제 조치로 이어지는 범주를 요청하세요. 좋은 분류 예시는 다음과 같습니다.

• Promote to durable project instruction
• Consolidate with similar entries
• Prune because stale or low-value
• Keep as temporary memory
• Investigate because evidence is unclear

이렇게 하면 review 결과가 막연한 요약으로 흐르는 것을 막고, 감사 후 CLAUDE.md, 팀 문서, 메모리 파일을 업데이트하기 쉬워집니다.

주의해야 할 흔한 실패 패턴

가장 흔한 실패는 일회성 관찰을 과도하게 승격하는 것입니다. 메모리 항목은 보통 반복적으로 나타나거나, 정책에 가깝거나, 향후 세션 전반에 널리 유용할 때만 승격하는 것이 좋습니다. 또 다른 실패는 단지 오래되었다는 이유만으로 항목을 삭제하는 것입니다. 오래되었다는 사실만으로 stale하다고 볼 수는 없습니다. 더 좋은 stale 신호는 존재하지 않는 파일, 대체된 도구, 서로 모순되는 관례, 완료된 임시 작업에 대한 참조입니다.

첫 review 이후 반복하기

첫 review가 끝나면 에이전트에게 권장사항을 최소한의 patch plan으로 바꿔 달라고 요청하세요. 무엇을 추가하고, 병합하고, 제거하고, 다시 확인할지 정리하게 하면 됩니다. 그런 다음 quick mode로 review를 다시 실행해 메모리가 더 짧아졌는지, 중복이 줄었는지, 현재 프로젝트 동작과 더 잘 맞는지 확인하세요. 이렇게 하면 review가 일회성 보고서가 아니라 지속적인 유지보수 루프가 됩니다.