サンプル
カスタムルール
あなたのプロジェクト向けにカスタムの常時オンルールを作成する。
この例では、すべてのファイルにわたって命名規則を強制する、プロジェクト固有の常時オンのルールを追加します。
ルールファイル
---
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 のチェックアウトからは 1 つ目のコマンドを使ってください。そこでは PYTHONPATH=src によってパッケージがインポート可能になります。スクリプトでインストールした後は、ソースが $HOME/.apothem/src 配下にあるため、2 つ目のコマンドを使います：
# 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
}ハーネスへ伝播する
インストール済みのハーネスごとに、更新コマンドを 1 回ずつ実行します。
apothem update --harness claude-code
apothem update --harness cursor --project /path/to/project