예제
커스텀 규칙
프로젝트를 위한 커스텀 상시-적용 규칙을 작성합니다.
이 예제는 모든 파일에 걸쳐 명명 규칙을 강제하는, 프로젝트 전용의 항상 적용되는 규칙을 추가합니다.
규칙 파일
---
name: "kebab-filenames"
description: "Enforce kebab-case filenames in the src/ tree"
pathFilter: ""
alwaysApply: true
---
# Kebab-case filenames
All new files created under `src/` MUST use kebab-case naming
(lowercase letters, digits, and hyphens only — no underscores,
no camelCase, no PascalCase).
**Correct:** `src/styles/button-group.css`, `src/components/nav-bar.css`
**Incorrect:** `src/styles/buttonGroup.css`, `src/components/NavBar.css`
When in doubt, err on the side of more hyphens.이 파일을 하니스 설치 루트 안의 rules/kebab-filenames.md로 저장하세요(Claude Code 어댑터는 ~/.claude/이며, 그 밖의 경우에는 하니스 고유 경로로 바꾸세요).
규칙이 올바르게 작성되었는지 검증하기
방금 작성한 규칙 파일에 프런트매터 검증기를 실행하세요. Apothem 체크아웃에서는 첫 번째 명령을 사용하세요. 이때 PYTHONPATH=src가 패키지를 임포트할 수 있게 합니다. 스크립트로 설치한 뒤에는 두 번째 명령을 사용하세요. 이때 소스는 $HOME/.apothem/src 아래에 있습니다:
# From an Apothem checkout
PYTHONPATH=src python -m apothem.conformity.gate --check frontmatter-grep ~/.claude/rules/kebab-filenames.md
# After a script install
PYTHONPATH="$HOME/.apothem/src" python -m apothem.conformity.gate --check frontmatter-grep ~/.claude/rules/kebab-filenames.md올바르게 작성된 규칙은 깔끔하게 통과 판정을 받습니다:
{
"orchestrator": "conformity-gate",
"passed": true,
"grep_count": 1
}하니스로 전파하기
설치된 하니스마다 업데이트 명령을 한 번씩 실행하세요:
apothem update --harness claude-code
apothem update --harness cursor --project /path/to/project