diff --git a/AGENTS.md b/AGENTS.md
index d9c490e6..20be4352 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,10 +1,10 @@
 # Project architecture
 
-@architecture.md
+@docs/architecture.md
 
 # Project conventions
 
-@project-conventions.md
+@docs/project-conventions.md
 
 <!-- usage-rules-start -->
 <!-- usage_rules-start -->
diff --git a/ARCHITECTURE.md b/docs/architecture.md
similarity index 100%
rename from ARCHITECTURE.md
rename to docs/architecture.md
diff --git a/project-conventions.md b/docs/project-conventions.md
similarity index 100%
rename from project-conventions.md
rename to docs/project-conventions.md