diff --git a/.config/yadm/CLAUDE.md b/.config/yadm/CLAUDE.md
new file mode 100644
index 0000000..c7e5b40
--- /dev/null
+++ b/.config/yadm/CLAUDE.md
@@ -0,0 +1,7 @@
+# Agent Instructions
+
+- Be clear and concise.
+- Never include AI attributions (e.g. "Co-Authored-By", "Generated with Claude") in commit messages.
+- This is a yadm-managed dotfiles repo rooted at `$HOME`. Always use `yadm` (not plain `git`) for version control: `yadm status`, `yadm add`, `yadm commit`, `yadm push`, etc.
+- Any change made here must be reproducible on other systems via `yadm bootstrap` — keep the bootstrap scripts (`bootstrap##*`) up to date when adding dependencies, packages, or setup steps a fresh system would need.
+- Keep `readme.md` updated when relevant, and keep it short and to the point.