diff --git a/README.md b/README.md
index ff1417a..697c06b 100644
--- a/README.md
+++ b/README.md
@@ -27,11 +27,11 @@ Stack and commands. What technologies and what commands does the AI need to know
 
 - .aider.conf.yml - Aider config (models, auto-test..)
 - .gitignore - Common stuff easy to forget. 
-- SPEC.md - What the project does
-- ARCH.md - How it's built
-- CONVENTIONS.md - Code style rules
-- TESTS.md - Test cases in natural language
-- JOURNAL.md - Personal session notes
+- docs/SPEC.md - What the project does
+- docs/ARCH.md - How it's built
+- docs/CONVENTIONS.md - Code style rules
+- docs/TESTS.md - Test cases in natural language
+- docs/JOURNAL.md - Personal session notes
 
 ## Philosophy
 
diff --git a/ARCH.md b/docs/ARCH.md
similarity index 98%
rename from ARCH.md
rename to docs/ARCH.md
index d7ecec5..6ab3d4c 100644
--- a/ARCH.md
+++ b/docs/ARCH.md
@@ -21,6 +21,7 @@ Example:
 
 ## File structure
 
+Example:
 src/
   main.py
   config.py
@@ -34,7 +35,6 @@ tests/
 One section per non-obvious decision. What we choose, what we rejected, why. 
 
 Example:
-
 ### Polling vs events
 - Decision: Polling every 10s
 - Options: Using interrupts
diff --git a/CONVENTIONS.md b/docs/CONVENTIONS.md
similarity index 100%
rename from CONVENTIONS.md
rename to docs/CONVENTIONS.md
diff --git a/JOURNAL.md b/docs/JOURNAL.md
similarity index 100%
rename from JOURNAL.md
rename to docs/JOURNAL.md
diff --git a/SPEC.md b/docs/SPEC.md
similarity index 100%
rename from SPEC.md
rename to docs/SPEC.md
diff --git a/TESTS.md b/docs/TESTS.md
similarity index 100%
rename from TESTS.md
rename to docs/TESTS.md