diff --git a/doc/ellie.md b/doc/ellie.md
index 8549539..f933a79 100644
--- a/doc/ellie.md
+++ b/doc/ellie.md
@@ -45,7 +45,7 @@ Opens the session tree (`*ellie-sessions*`), attached to the last-known
 session for your working directory if it still exists.
 
 <p align="center">
-  <a href="img/ellie.png"><img src="img/ellie.png" alt="ellie Emacs interface showing the Ollie session tree and chat window" width="75%"></a>
+  <a href="resources/img/ellie.png"><img src="resources/img/ellie.png" alt="ellie Emacs interface showing the Ollie session tree and chat window" width="75%"></a>
 </p>
 
 ## Session tree
diff --git a/doc/kde-gui.md b/doc/kde-gui.md
index ea53784..eaa42de 100644
--- a/doc/kde-gui.md
+++ b/doc/kde-gui.md
@@ -3,7 +3,7 @@
 ollie-gui is a free-standing Qt6/QML desktop application that talks to an ollie session directly through `ollie-9p`. No D-Bus, no Plasma dependencies — it runs on any Linux desktop with Qt6 installed.
 
 <p align="center">
-  <a href="img/ollie-kde.png"><img src="img/ollie-kde.png" alt="Ollie KDE GUI window showing a session tree, chat history, and prompt input bar with KDE Plasma Breeze theme" width="75%"></a>
+  <a href="resources/img/ollie-kde.png"><img src="resources/img/ollie-kde.png" alt="Ollie KDE GUI window showing a session tree, chat history, and prompt input bar with KDE Plasma Breeze theme" width="75%"></a>
 </p>
 
 ## Prerequisites
diff --git a/doc/architecture.md b/doc/resources/architecture.md
similarity index 100%
rename from doc/architecture.md
rename to doc/resources/architecture.md
diff --git a/doc/core.md b/doc/resources/core.md
similarity index 100%
rename from doc/core.md
rename to doc/resources/core.md
diff --git a/doc/edsl.md b/doc/resources/edsl.md
similarity index 100%
rename from doc/edsl.md
rename to doc/resources/edsl.md
diff --git a/doc/evolution.md b/doc/resources/evolution.md
similarity index 100%
rename from doc/evolution.md
rename to doc/resources/evolution.md
diff --git a/doc/ideas.md b/doc/resources/ideas.md
similarity index 100%
rename from doc/ideas.md
rename to doc/resources/ideas.md
diff --git a/doc/img/ellie.png b/doc/resources/img/ellie.png
similarity index 100%
rename from doc/img/ellie.png
rename to doc/resources/img/ellie.png
diff --git a/doc/img/ollie-acme.png b/doc/resources/img/ollie-acme.png
similarity index 100%
rename from doc/img/ollie-acme.png
rename to doc/resources/img/ollie-acme.png
diff --git a/doc/img/ollie-kde.png b/doc/resources/img/ollie-kde.png
similarity index 100%
rename from doc/img/ollie-kde.png
rename to doc/resources/img/ollie-kde.png
diff --git a/doc/img/ollie-tui.png b/doc/resources/img/ollie-tui.png
similarity index 100%
rename from doc/img/ollie-tui.png
rename to doc/resources/img/ollie-tui.png
diff --git a/doc/img/ollie-ui-composition.png b/doc/resources/img/ollie-ui-composition.png
similarity index 100%
rename from doc/img/ollie-ui-composition.png
rename to doc/resources/img/ollie-ui-composition.png
diff --git a/doc/multi-agent.md b/doc/resources/multi-agent.md
similarity index 100%
rename from doc/multi-agent.md
rename to doc/resources/multi-agent.md
diff --git a/doc/no-mcp.md b/doc/resources/no-mcp.md
similarity index 100%
rename from doc/no-mcp.md
rename to doc/resources/no-mcp.md
diff --git a/doc/remote-execution.md b/doc/resources/remote-execution.md
similarity index 100%
rename from doc/remote-execution.md
rename to doc/resources/remote-execution.md
diff --git a/doc/whitepaper.md b/doc/resources/whitepaper.md
similarity index 100%
rename from doc/whitepaper.md
rename to doc/resources/whitepaper.md
diff --git a/doc/writing-tools.md b/doc/resources/writing-tools.md
similarity index 100%
rename from doc/writing-tools.md
rename to doc/resources/writing-tools.md