diff --git a/.gitignore b/.gitignore
index 3041f8d..70538ee 100644
--- a/.gitignore
+++ b/.gitignore
@@ -56,3 +56,7 @@ ChangeLog
 
 # generated docs
 doc/source/ref/
+
+# Files used by AI agents for instructions, rules and project context
+# md is also used for docs, but we can ignore them since openstack uses rst
+*.md