diff --git a/agents/bugfixer.md b/agents/bugfixer.md
index 30c1d2f..6e1b822 100644
--- a/agents/bugfixer.md
+++ b/agents/bugfixer.md
@@ -173,6 +173,12 @@ Load `$HOME/.claude/agents/doc-syncer.md`.
 Execute in automatic mode:
 `auto-mode scope: <list of files modified during this session>`
 
+**Then commit the docs** — follow `$HOME/.claude/lib/doc-commit.md`: it surgically commits
+ONLY the files doc-syncer patched (its `PATCHED_FILES` output), never `git add -A`, never
+`.claude/`/`CLAUDE.md` (rc 4 = a loud BDR-022 anomaly, not a silent skip), and no-ops when
+nothing was patched — the common case for a trivial change. No FINISH in an inline flow, so
+it just commits the docs on the current branch (no ordering concern).
+
 ## STEP 7 — CAPITALIZE (memory registries)
 
 A bugfix with an understood root cause is almost always worth one entry:
diff --git a/agents/feater.md b/agents/feater.md
index d84c69c..75e1050 100644
--- a/agents/feater.md
+++ b/agents/feater.md
@@ -141,6 +141,12 @@ Load `$HOME/.claude/agents/doc-syncer.md`.
 Execute in automatic mode:
 `auto-mode scope: <list of files modified during this session>`
 
+**Then commit the docs** — follow `$HOME/.claude/lib/doc-commit.md`: it surgically commits
+ONLY the files doc-syncer patched (its `PATCHED_FILES` output), never `git add -A`, never
+`.claude/`/`CLAUDE.md` (rc 4 = a loud BDR-022 anomaly, not a silent skip), and no-ops when
+nothing was patched — the common case for a trivial change. No FINISH in an inline flow, so
+it just commits the docs on the current branch (no ordering concern).
+
 ## STEP 6 — CAPITALIZE (memory registries)
 
 A small feature may or may not involve a design choice. Scan the work for:
diff --git a/agents/hotfixer.md b/agents/hotfixer.md
index 46025a9..e9f6c64 100644
--- a/agents/hotfixer.md
+++ b/agents/hotfixer.md
@@ -118,6 +118,12 @@ Load `$HOME/.claude/agents/doc-syncer.md`.
 Execute in automatic mode:
 `auto-mode scope: <list of files modified during this session>`
 
+**Then commit the docs** — follow `$HOME/.claude/lib/doc-commit.md`: it surgically commits
+ONLY the files doc-syncer patched (its `PATCHED_FILES` output), never `git add -A`, never
+`.claude/`/`CLAUDE.md` (rc 4 = a loud BDR-022 anomaly, not a silent skip), and no-ops when
+nothing was patched — the common case for a trivial hotfix. No FINISH in an inline flow, so
+it just commits the docs on the current branch (no ordering concern).
+
 ## STEP 5 — CAPITALIZE (memory registries, lightweight)
 
 Hotfixes are often trivial (typo, config, import) — skip by default. But if the fix revealed something non-obvious: