diff --git a/.gitignore b/.gitignore
index e8b097e22..de0397365 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,7 +30,10 @@ launchSettings.json
 *.diagsession
 TestResults/
 BenchmarkDotNet.Artifacts/
-.codex
 
 # local planning/design notes (not for publication)
 planning/
+
+# agent tooling: only .claude/skills is repo content; everything else in .claude is per-user state
+.claude/*
+!.claude/skills/