diff --git a/core/AGENTS.md b/core/AGENTS.md
index fd3468a..9b7be38 100644
--- a/core/AGENTS.md
+++ b/core/AGENTS.md
@@ -24,4 +24,4 @@ Read these files on demand:
 - **Coding conventions** (`~/.claude/core/instructions/coding.md`) — when writing, editing, or reviewing code
 - **Git conventions** (`~/.claude/core/instructions/git.md`) — when doing git operations
 - **Testing conventions** (`~/.claude/core/instructions/testing.md`) — when writing or running tests
-- **Git Commit conventions** (`~/.claude/core/commits.md`) — when commiting changes
+- **Git Commit conventions** (`~/.claude/core/instructions/commits.md`) — when committing changes
diff --git a/core/instructions/commits.md b/core/instructions/commits.md
index 0669413..522a539 100644
--- a/core/instructions/commits.md
+++ b/core/instructions/commits.md
@@ -1,16 +1,17 @@
-```markdown
-# <type>(<scope>): <concise summary>
-# Required.
-#
-# Purpose:
-# - Quickly communicates the intent when scanning `git log`.
-# - Follow Conventional Commits for consistency and tooling.
-# - Describe the intended outcome, not the implementation.
-#
-# Examples:
-# feat(auth): support OAuth device flow
-# fix(cache): prevent stale session reuse
-# refactor(api): simplify request validation
+<!--
+<type>(<scope>): <concise summary>
+Required.
+
+Purpose:
+- Quickly communicates the intent when scanning `git log`.
+- Follow Conventional Commits for consistency and tooling.
+- Describe the intended outcome, not the implementation.
+
+Examples:
+feat(auth): support OAuth device flow
+fix(cache): prevent stale session reuse
+refactor(api): simplify request validation
+-->
 
 ## Why
 <!--
@@ -63,9 +64,8 @@ Omit if there are no noteworthy impacts.
 -->
 
 ---
-# References (Git Trailers)
-# Structured metadata for traceability and tooling.
-# Use only the trailers that apply.
+# References
+<!-- Git Trailers:  Structured metadata for traceability and tooling. Use only the trailers that apply. -->
 
 Fixes:
 Refs:
@@ -76,4 +76,3 @@ Co-authored-by:
 Reviewed-by:
 Signed-off-by:
 BREAKING CHANGE:
-```