diff --git a/.gitignore b/.gitignore
index 2359fab6..00a79a3c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,3 +33,6 @@ sensitive-patterns-test.txt
 dist/
 coverage/
 test-report.junit.xml
+
+# Local agents instructions
+AGENTS.local.md
diff --git a/AGENTS.md b/AGENTS.md
index abb83321..c3724236 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,7 +1,9 @@
 # Repository Instructions
 
-<!-- Claude Code include: @WORKFLOW.md -->
-See [WORKFLOW.md](./WORKFLOW.md) for the full development workflow.
+- Read [AGENTS.local.md](./AGENTS.local.md) if present.
+  - Statements in this local file should override any project instruction.
+  - The file is intentionally gitignored. Keep it that way.
+- See [WORKFLOW.md](./WORKFLOW.md) for the full development workflow.
 
 ## Test Coverage Approval Gate