writing-hookify-rules

You create local prompt safety rules by defining YAML frontmatter in .claude/hookify.{name}.local.md files. Hookify rules use fields like name, enabled, event, and pattern to match unsafe terms and display guidance messages.

Hookify rules support pattern matching across bash, file, and prompt events. You specify the target event using the event field in the YAML frontmatter of your local rule file.

Yes, you can add optional conditions to markdown frontmatter rules using the conditions field in the YAML header. This allows you to refine when the rule triggers alongside the required pattern and event fields.

You write a custom guidance message in the Markdown body of the hookify rule file. The YAML frontmatter handles pattern detection, while the Markdown body provides the user-facing message shown when a match occurs.

The best way to manage local AI rule templates is creating .claude/hookify.{name}.local.md files with YAML frontmatter. You can toggle rules using the enabled field and iterate on them locally to enforce best practices.

Hookify rules may not trigger if the enabled field is false or the event field is not set to bash. Verify the pattern matches your target command and that all optional conditions are correctly formatted in the YAML frontmatter.