CLAUDE.md commit conventions overridden by system prompt defaults
Resolved 💬 9 comments Opened Mar 7, 2026 by andyp1per Closed May 12, 2026
Description
Project-level CLAUDE.md commit conventions are being ignored in favor of the built-in system prompt commit template, even after CLAUDE.md has been explicitly read in the same session.
CLAUDE.md rules that were violated
- "DO NOT list Claude as author or co-author" — Claude added a
Co-Authored-Byline anyway, following the system prompt's default commit template - "One module per commit" — Claude combined changes to
AC_FenceandAP_Scriptinginto a single commit instead of splitting per subsystem
The CLAUDE.md header states: "These instructions OVERRIDE any default behavior and you MUST follow them exactly as written."
Steps to reproduce
- Create a CLAUDE.md with commit rules that conflict with the system prompt defaults (e.g., no co-author lines, one module per commit)
- Ask Claude to read CLAUDE.md at the start of the session
- Make changes across multiple modules and ask Claude to commit
- Observe that Claude falls back on the system prompt commit template instead of applying the CLAUDE.md overrides
Expected behavior
CLAUDE.md commit conventions should take precedence over the system prompt's default commit template when they conflict.
Actual behavior
Claude acknowledged the CLAUDE.md rules but used the default commit template anyway, adding Co-Authored-By and combining multiple modules into one commit.
This issue has 9 comments on GitHub. Read the full discussion on GitHub ↗