diff --git a/CLAUDE.md b/CLAUDE.md
index 9b3ee3f..d56ce1c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -106,6 +106,17 @@ From experience with this repository:
 - Use browser automation MCPs (Claude in Chrome, Playwright, Chrome DevTools) for Claude to inspect console logs
 - Provide screenshots when reporting visual issues
 
+## Git Commit Rules
+
+When committing changes, **create separate commits per file**. Do NOT bundle multiple file changes into a single commit. Each file gets its own commit with a descriptive message specific to that file's changes.
+
+For example, if `README.md`, `best-practice/claude-subagents.md`, and a skill file all changed:
+- Commit 1: `git add README.md` → commit with README-specific message
+- Commit 2: `git add best-practice/claude-subagents.md` → commit with subagents-doc-specific message
+- Commit 3: `git add .claude/skills/weather-fetcher/SKILL.md` → commit with skill-specific message
+
+This makes the git history cleaner and easier to review, revert, or cherry-pick individual changes.
+
 ## Documentation
 
 See `.claude/rules/markdown-docs.md` for documentation standards. Key docs: