Back to all errors

GIT010

GIT

Missing required flags

Error

Git commit is missing required flags (typically -s and -S).

Why this matters

The -s (signoff) flag records Developer Certificate of Origin compliance. The -S (GPG sign) flag cryptographically verifies authorship. Both are required by default.

How to fix

Add the required flags:

git commit -sS -m "message"

Or use the long forms:

git commit --signoff --gpg-sign -m "message"

Configuration

Set which flags are required in config.toml:

[validators.git.commit]
required_flags = ["-s", "-S"]  # Default: both signoff and GPG sign

Require only signoff:

[validators.git.commit]
required_flags = ["-s"]

Disable flag requirements:

[validators.git.commit]
required_flags = []

Hook output

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

permissionDecisionReason (shown to Claude): [GIT010] Git commit is missing required flags (-s, -S). Add -sS flags: git commit -sS -m "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.

  • GIT001 - Missing signoff flag
  • GIT002 - Missing GPG sign flag

© 2026 Smykla Skalski Labs