Error
Commit message contains a forbidden pattern (by default, references to tmp/ directory).
Why this matters
tmp/paths are transient and don't belong in permanent commit history- Custom patterns let you block project-specific or sensitive content
- Catches debug paths and throwaway workarounds before they land in the log
How to fix
Remove forbidden patterns from your commit message:
# Wrong:
git commit -sS -m "fix(build): update path to tmp/cache"
# Correct:
git commit -sS -m "fix(build): update cache path configuration"Default patterns
\btmp/- References to tmp/ directories\btmp\b- Standalone "tmp" word
Configuration
Customize forbidden patterns in config.toml:
[validators.git.commit.message]
forbidden_patterns = [
"\\btmp/",
"\\bTODO\\b",
"\\bHACK\\b",
]Clear all forbidden patterns:
[validators.git.commit.message]
forbidden_patterns = []Hook output
When this error is triggered, klaudiush writes JSON to stdout:
permissionDecisionReason (shown to Claude):
[GIT014] Commit message contains a forbidden pattern (tmp/). Remove forbidden pattern from commit message
systemMessage (shown to user): Formatted error with fix hint and reference URL.
additionalContext (behavioral guidance):
Automated klaudiush validation check. Fix the reported errors and retry the same command.