hookify-rules

Hookify 규칙 작성

개요

Hookify 규칙은 감시할 패턴과, 패턴이 일치할 때 Claude에게 보여줄 메시지를 정의하는 YAML frontmatter 포함 Markdown 파일입니다. 규칙은 .claude/hookify.{rule-name}.local.md 파일로 저장됩니다.

규칙 파일 형식

기본 구조

---
name: rule-identifier
enabled: true
event: bash|file|stop|prompt|all
pattern: regex-pattern-here
---

규칙이 트리거될 때 Claude에게 보여줄 메시지

Frontmatter 필드

Field	Required	Values	Description
name	Yes	kebab-case string	고유 식별자
enabled	Yes	true/false	삭제 없이 on/off
event	Yes	bash/file/stop/prompt/all	어떤 hook 이벤트가 트리거하는지
action	No	warn/block	warn은 메시지 표시, block은 작업 차단
pattern	Yes*	regex string	일치 패턴

고급 형식(여러 조건)

---
name: warn-env-api-keys
enabled: true
event: file
conditions:
  - field: file_path
    operator: regex_match
    pattern: \.env$
  - field: new_text
    operator: contains
    pattern: API_KEY
---

.env 파일에 API 키를 추가하고 있습니다. 이 파일이 .gitignore에 있는지 확인하세요.

이벤트별 조건 필드

• bash: command
• file: file_path, new_text, old_text, content
• prompt: user_prompt

연산자

• regex_match
• contains
• equals
• not_contains
• starts_with
• ends_with

모든 조건이 일치해야 규칙이 트리거됩니다.

이벤트 타입 가이드

bash 이벤트

Bash 명령 패턴을 매칭합니다.

• 위험 명령: rm\s+-rf, dd\s+if=, mkfs
• 권한 상승: sudo\s+, su\s+
• 권한 문제: chmod\s+777

file 이벤트

Edit/Write/MultiEdit 작업을 매칭합니다.

• 디버그 코드: console\.log\(, debugger
• 보안 리스크: eval\(, innerHTML\s*=
• 민감 파일: \.env$, credentials, \.pem$

stop 이벤트

완료 점검과 리마인더입니다. .* 패턴이면 항상 매치됩니다.

prompt 이벤트

사용자 프롬프트 내용을 기준으로 워크플로 강제를 적용합니다.

패턴 작성 팁

정규식 기본

• 특수문자는 이스케이프합니다: . → \., ( → \(
• \s 공백, \d 숫자, \w 단어 문자
• + 1회 이상, * 0회 이상, ? 선택
• | OR

흔한 함정

• 너무 넓음: log는 login, dialog도 잡음 → console\.log\(
• 너무 좁음: rm -rf /tmp → rm\s+-rf
• YAML 이스케이프: 따옴표 없는 패턴을 우선. 따옴표 문자열은 \\s처럼 이중 이스케이프 필요

테스트

python3 -c "import re; print(re.search(r'your_pattern', 'test text'))"

파일 구성

• 위치: 프로젝트 루트의 .claude/
• 이름 규칙: .claude/hookify.{descriptive-name}.local.md
• Gitignore: .claude/*.local.md를 .gitignore에 추가

명령

• /hookify [description] - 새 규칙 생성
• /hookify-list - 규칙 테이블 보기
• /hookify-configure - 규칙 on/off 설정
• /hookify-help - 전체 문서

빠른 참조

최소 규칙:

---
name: my-rule
enabled: true
event: bash
pattern: dangerous_command
---
Warning message here