GIT016

Error

List items in the commit body aren't formatted as valid Markdown.

Why this matters

• Lists need blank lines before them in Markdown
• Missing blank lines break rendering in GitHub and GitLab

How to fix

Add blank lines before lists:

# Wrong:
git commit -sS -m "feat(api): add endpoints
Changes:
- Added user endpoint
- Added auth endpoint"

# Correct:
git commit -sS -m "feat(api): add endpoints

Changes:

- Added user endpoint
- Added auth endpoint"

Markdown rules

1. Blank line after the title
2. Blank line before any list
3. Consistent list marker (-, *, or 1.)

Hook output

When this error is triggered, klaudiush writes JSON to stdout:

permissionDecisionReason (shown to Claude): [GIT016] List items in commit body aren't formatted as valid Markdown. Add empty line before list items in commit body

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.

Related

• GIT005 - Commit message body issues
• GIT004 - Commit message title issues