모델이 지켜주기를 바라는 대신 규칙을 실제로 강제하는 Claude 코드 플러그인을 만들었습니다

Claude Code를 많이 사용해 왔는데, 여기서 모두가 이야기하는 똑같은 문제에 계속 부딪힙니다: 모델이 당신의 규칙을 무시한다는 것입니다. 테스트를 먼저 작성하라고 지시하면 구현 코드를 작성합니다. 코딩 표준을 제공해도 그중 일부만 골라 따릅니다. 그리고 규칙집이 늘어날수록, 작업에 관련 있는 몇 안 되는 규칙들 때문에 모든 것을 컨텍스트에 채워 넣으면서 점점 더 많은 토큰을 소모하게 됩니다.

그래서 Writ을 만들었습니다. 두 가지 구성 요소가 있습니다:

첫 번째는 현재 작업에 필요한 관련 규칙과 스킬만 선택하는 검색 엔진입니다. Neo4j 지식 그래프를 통해 5단계 파이프라인을 실행하므로, 하나의 규칙이 발동되면 관련된 규칙(의존성, 충돌, 보완)들이 자동으로 함께 옵니다. 중앙값 쿼리 시간은 0.338ms입니다. 276개의 규칙에 대해 컨텍스트를 약 83,000 토큰에서 쿼리당 약 1,600 토큰으로 줄여줍니다.

두 번째는 프롬프트가 아닌 bash hooks 기반의 강제화 계층(enforcement layer)입니다. PreToolUse, PostToolUse, SessionEnd에 연결된 30개의 스크립트가 있습니다. 작업 모드에서는 사용자가 계획과 테스트 골격을 승인하기 전까지 Claude가 코드를 작성할 수 없습니다. 실제로 정적 분석을 실행하고 증명하지 않고는 '테스트 통과'라고 말할 수 없습니다. 이 후크들은 도구 호출(tool calls)을 가로채서 실행되기 전에 차단합니다. AI가 규칙을 따를지 안 할지를 결정하게 두지 않습니다.

또한 프로젝트의 린터(linter)들을 자동으로 발견하고 실행합니다. PHPStan, ESLint, ruff, cargo check, go vet 등입니다. 게다가 주입(injection), 인증(auth), 암호화(crypto), N+1 쿼리에 대한 사용자 지정 분석기까지 포함됩니다. 모든 것이 파일 작성 시마다 이루어집니다.

276개의 규칙과 스킬이 12개 도메리에 걸쳐 기본으로 제공되며, 테스트는 1,442개가 있습니다.

Writ repo: https://github.com/infinri/Writ