Clawback: 누출된 Claude 검증 루프의 Hooks 기반 구현

Clawback는 유출된 Claude 소스 맵의 검증 루프를 프롬프트가 아닌 기계적 훅으로 구현한 GitHub 프로젝트입니다. 이 접근 방식은 iamfakeguru/claude-md의 "tsc를 실행하지 않고는 완료할 수 없습니다"와 같은 프롬프트 기반 검증이 컨텍스트 압박 하에서 모델에 의해 건너뛸 수 있는 한계를 해결합니다.

훅 아키텍처

시스템은 문제를 두 계층으로 나눕니다:

• 훅 (기계적, 건너뛸 수 없음):
  • 정지 훅: Claude가 완료하려고 할 때 타입 체크 + 린트를 실행합니다. 실패하면 코드 2로 종료하여 Claude가 계속 수정하도록 강제합니다. 연속 세 번 실패한 블록은 회로 차단기를 트리거합니다.
  • PostToolUse: 모든 파일 편집 후 자동 포맷팅 및 린트를 수행합니다.
  • PreToolUse: Claude가 .env 및 lockfile을 건드리기 전에 편집을 차단합니다.
  • PostCompact: 컨텍스트 압축 후 git 상태와 gotchas.md를 다시 주입합니다.
• CLAUDE.md (행동적): 훅이 강제할 수 없는 사항을 위해 사용되며, 단계적 실행(단계당 ≤5개 파일), 계획 대 빌드 분리, 컨텍스트 감소 인식, 실수 로깅을 포함합니다.

기술적 세부 사항

이 도구는 구성 파일(tsconfig.json, go.mod, Cargo.toml, pyproject.toml, composer.json)을 찾아 스택을 자동 감지합니다. 구성이 필요 없으며 종속성이 전혀 없습니다. Clawback는 iamfakeguru의 CLAUDE.md 프로젝트를 대체하지 않고 함께 작동합니다.

구현은 소스 맵에서 USER_TYPE === 'ant' 뒤에 숨겨져 있던 유출된 검증 루프를 기반으로 합니다. GitHub 저장소는 https://github.com/LZong-tw/clawback에서 이용할 수 있습니다.