Mneme: 아키텍처 결정을 위반하는 Claude Code 편집을 차단하는 PreToolUse 후크

Marcus Dillavou가 Mneme을 만들었습니다. 이는 PreToolUse 훅으로, Claude Code의 편집을 가로채서 디스크에 쓰기 전에 기록된 아키텍처 결정 파일과 대조합니다. 목표는 금지된 라이브러리, 거부된 패턴, 잊혀진 규칙이 새 파일에 다시 나타나는 것을 방지하는 것입니다.

설치

pip install mneme
python scripts/install_claude_code.py

이 명령은 훅 항목을 .claude/settings.json에 쓰고 네 개의 슬래시 명령을 설치합니다:

• /mneme-check — 위반 검사 실행
• /mneme-context — 현재 파일에 대한 컨텍스트 가져오기
• /mneme-record — 새 결정 기록
• /mneme-review — 기존 결정 검토

작동 방식

Claude가 편집을 시도하면 Mneme은 작업을 키워드 색인된 결정과 비교합니다. 위반이 감지되면 훅이 작업을 차단하고 결정 ID를 피드백으로 반환합니다. Claude는 제한을 확인하고 이유를 이해한 후 출력을 조정합니다. 수동 재정의가 필요 없습니다.

훅은 열린 실패 방식입니다. Mneme이 PATH에 없거나 시간 초과되면 0으로 종료되고 Claude Code가 정상적으로 진행됩니다. mneme check가 실제로 위반 판정을 반환할 때만 차단합니다.

에지 케이스

검색이 키워드 기반이므로 결정의 범위가 중요합니다. 작성자는 프로덕션 프로젝트에서 훅이 올바르게 작동하는지에 대한 실제 피드백을 적극적으로 찾고 있습니다.