BayramAnnakov/claude-reflect

해결하는 문제

Claude Code는 세션 간의 수정 사항이나 반복되는 패턴을 종종 잊어버립니다. claude-reflect는 사용자 수정 사항을 포착하고 반복되는 워크플로우 패턴을 발견하여 이를 재사용 가능한 규칙과 기술로 변환하는 영구적인 메모리 시스템을 구축함으로써, AI가 같은 실수를 두 번 반복하지 않도록 합니다.

작동 방식

이 시스템은 Python 기반 플러그인과 TypeScript 기반 모드라는 두 가지 주요 모드로 작동합니다. 빠른 정규식 패턴(예: "아니요, X를 사용하세요"와 같은 문구 포착)과 의미론적 AI 검증(노이즈를 걸러내고 다국어를 지원하기 위함)을 결합한 하이브리드 탐지 방식을 사용합니다.

1. 캡처: 후크가 세션 중 수정 사항을 자동으로 감지하여 대기열에 추가합니다.
2. 처리: 사용자가 /reflect를 실행하여 대기열을 검토하고, 이러한 규칙을 CLAUDE.md(전역 또는 프로젝트별) 또는 AGENTS.md에 추가하는 것을 승인합니다.
3. 기술 발견: /reflect-skills 명령은 세션 기록을 분석하여 반복되는 작업(예: 생산성 검토를 여러 번 요청하는 경우)을 찾아내고, .claude/commands/에 전용 기술 파일을 생성할 것을 제안합니다.
4. 라우팅: 특정 기술을 사용하는 동안 이루어진 수정 사항은 해당 기술의 정의 파일로 다시 라우팅되어 시간이 지남에 따라 기술을 개선합니다.

대상 사용자

프로젝트 관례와 개인적인 선호 사항을 문서화하는 과정을 자동화하려는 Claude Code CLI 사용자, 그리고 AGENTS.md 지원을 통해 Codex, Cursor 또는 Aider를 사용하는 개발자를 위한 도구입니다.

주요 특징

• 영구 메모리: 수정 사항을 CLAUDE.md에 동기화하여 세션 간에도 지속되도록 합니다.
• AI 기반 기술 발견: 기록을 분석하여 반복되는 의도를 바탕으로 새로운 /commands를 제안합니다.
• 다국어 지원: 의미론적 분석을 통해 모든 언어의 수정 사항을 이해합니다.
• 기록 스캔: 과거의 모든 세션을 스캔하여 놓친 학습 내용을 복구할 수 있습니다.
• 의미론적 중복 제거: 유사한 규칙을 통합하여 메모리 파일을 깔끔하게 유지합니다.