From e09d1cd297954bf6870f56e284832ef8e374be18 Mon Sep 17 00:00:00 2001
From: Defame1297 <gitea@rkdr.net>
Date: Sat, 27 Jun 2026 14:02:31 +0000
Subject: [PATCH] fix(core): correct commits path, fix typo, and remove stray
 code fence
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## Why
`core/AGENTS.md` referenced a non-existent path (`~/.claude/core/commits.md`)
instead of the correct `~/.claude/core/instructions/commits.md`, and contained a
typo ("commiting" → "committing"). `core/instructions/commits.md` was wrapped in
an erroneous markdown code fence that caused agents reading the file to see it as
a raw text block rather than a live template with usable HTML comment sections.

## Impact
Agents following the content index in AGENTS.md will now resolve the correct path
for commit conventions. The commits template is now properly structured so its
comment-gated sections render as intended.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 core/AGENTS.md               |  2 +-
 core/instructions/commits.md | 33 ++++++++++++++++-----------------
 2 files changed, 17 insertions(+), 18 deletions(-)

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:
-```