Repolode
BayramAnnakov

BayramAnnakov/claude-reflect

Claude Code에 수정 사항과 선호도를 기록해 CLAUDE.md와 AGENTS.md에 지속적으로 반영하는 자가 학습 애드온

스타
1,827
포크
165
열린 이슈
10
마지막 커밋
17일 전

어떤 프로젝트인가요?

claude-reflect는 Claude에게 해 준 수정을 장기 기억으로 바꿔 주는 Claude Code 애드온입니다. “아니, gpt-5 말고 gpt-5.1을 써”처럼 말하면 훅이 수정 사항을 대기열에 넣고, /reflect 명령으로 내용을 검토한 뒤 승인한 규칙을 CLAUDE.md 또는 AGENTS.md에 기록할 수 있습니다. 그러면 이후 세션은 해당 규칙을 바탕으로 시작합니다.

또한 지난 세션 기록을 분석해 반복 작업을 찾아내고, /reflect-skills를 통해 재사용 가능한 슬래시 명령으로 제안합니다. 별도의 얼리 액세스 모드 버전은 세션 중 짧은 프롬프트를 확인하고, 프롬프트 위에 표시되는 띠에서 버튼을 한 번 눌러 각 규칙을 저장할 수 있습니다.

Python 플러그인은 macOS, Linux, Windows에서 실행되며 AGENTS.md를 읽는 Codex, Cursor 및 기타 도구와 함께 사용할 수 있습니다.

핵심 기능

  • 01Claude Code 훅을 통해 수정 사항과 긍정적인 피드백을 수집합니다.
  • 02하위 디렉터리와 링크된 문서를 포함해 승인된 규칙을 CLAUDE.md와 AGENTS.md에 반영합니다.
  • 03세션에서 반복되는 패턴을 찾아 초안 슬래시 명령을 생성합니다.
  • 04검토 과정에서 의미 기반 확인을 통해 어떤 언어로든 수정 사항을 감지합니다.
  • 05중복 제거와 대기열 보기 기능을 제공해 메모리 파일을 깔끔하게 관리할 수 있습니다.

활용 사례

  • 세션마다 모델 이름, 테스트 명령 또는 코딩 규칙에 대해 같은 수정을 반복해서 말하지 않아도 됩니다.
  • 새 기기에서 수개월치 기존 Claude Code 기록을 활용해 메모리를 구축할 수 있습니다.
  • 매일 하는 검토나 배포 절차처럼 자주 요청하는 작업을 재사용 가능한 명령으로 만들 수 있습니다.

빠른 시작

  1. 1

    마켓플레이스를 추가합니다

    claude plugin marketplace add bayramannakov/claude-reflect
  2. 2

    플러그인을 설치합니다

    claude plugin install claude-reflect@claude-reflect-marketplace
  3. 3

    플러그인을 활성화하려면 Claude Code를 다시 시작합니다

  4. 4

    /reflect를 실행해 대기열에 쌓인 학습 내용을 처리합니다

    /reflect

사용 전 알아둘 점

  • Claude Code CLI와 Python 3.6 이상이 필요합니다.
  • mod 버전은 Claude Code 2.1.286 이상이 필요하며, 확인한 프롬프트마다 본인 계정으로 모델을 한 번 호출합니다.
  • mod와 Python 플러그인을 모두 설치하면 각 수정 사항이 두 번 기록됩니다.

토픽

자주 묻는 질문

claude-reflect은(는) 무엇인가요?
Claude Code에 수정 사항과 선호도를 기록해 CLAUDE.md와 AGENTS.md에 지속적으로 반영하는 자가 학습 애드온 claude-reflect는 Claude에게 해 준 수정을 장기 기억으로 바꿔 주는 Claude Code 애드온입니다. “아니, gpt-5 말고 gpt-5.1을 써”처럼 말하면 훅이 수정 사항을 대기열에 넣고, /reflect 명령으로 내용을 검토한 뒤 승인한 규칙을 CLAUDE.md 또는 AGENTS.md에 기록할 수 있습니다. 그러면 이후 세션은 해당 규칙을 바탕으로 시작합니다.
claude-reflect은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
claude-reflect은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
claude-reflect은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. claude-reflect의 마지막 커밋은 2026년 10월 3일입니다.
claude-reflect은(는) 어디에 사용할 수 있나요?
세션마다 모델 이름, 테스트 명령 또는 코딩 규칙에 대해 같은 수정을 반복해서 말하지 않아도 됩니다. 새 기기에서 수개월치 기존 Claude Code 기록을 활용해 메모리를 구축할 수 있습니다. 매일 하는 검토나 배포 절차처럼 자주 요청하는 작업을 재사용 가능한 명령으로 만들 수 있습니다.
claude-reflect는 어떻게 설치하나요?
마켓플레이스를 추가합니다: claude plugin marketplace add bayramannakov/claude-reflect 플러그인을 설치합니다: claude plugin install claude-reflect@claude-reflect-marketplace 플러그인을 활성화하려면 Claude Code를 다시 시작합니다 /reflect를 실행해 대기열에 쌓인 학습 내용을 처리합니다: /reflect
claude-reflect은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/BayramAnnakov/claude-reflect

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트