From 956155010a75dc90b536bbaf03abcb277eced36f Mon Sep 17 00:00:00 2001
From: Ollie Agent <ollie@example.com>
Date: Tue, 4 Aug 2026 19:37:12 +0200
Subject: [PATCH] move system prompt override to whitepaper

---
 doc/usage.md      | 13 -------------
 doc/whitepaper.md | 27 ++++++++++++++++++++++++++-
 2 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/doc/usage.md b/doc/usage.md
index e8bade0..88e6681 100644
--- a/doc/usage.md
+++ b/doc/usage.md
@@ -367,19 +367,6 @@ Each agent can use a different `agent=`, `backend=`, or `model=`.
 > **For implementers**: The raw 9P filesystem reference, store federation, and
 > tool discovery internals are documented in [doc/whitepaper.md](whitepaper.md).
 
-## System prompt override
-
-The default system prompt is compiled into `olliesrv`. To replace it, set the
-`systemPrompt` field in an agent config JSON to a file path:
-
-```json
-{
-  "systemPrompt": "~/.config/ollie/prompts/SYSTEM_PROMPT_QWEN.md",
-  "prompt": ["$OLLIE_CFG_PATH/prompts/agent-coding.md"],
-  "temperature": 0.7
-}
-```
-
 ## Viewing model context
 
 The rendered context window for any session is readable at
diff --git a/doc/whitepaper.md b/doc/whitepaper.md
index fe4a811..fb1981b 100644
--- a/doc/whitepaper.md
+++ b/doc/whitepaper.md
@@ -199,4 +199,29 @@ Drop an executable and its `.meta` file in `$OLLIE_TOOLS_PATH`.
 The next session created will pick it up automatically. No restart required.
 
 See [doc/writing-tools.md](writing-tools.md) for the full specification including
-host-conditional variants and privileged tools.
\ No newline at end of file
+host-conditional variants and privileged tools.
+
+---
+
+## System Prompt Override
+
+The default system prompt is compiled into `olliesrv`. To replace it — for
+models that need their own identity preamble — set the `systemPrompt` field
+in an agent config JSON to a file path:
+
+```json
+{
+  "systemPrompt": "~/.config/ollie/prompts/SYSTEM_PROMPT_QWEN.md",
+  "prompt": ["$OLLIE_CFG_PATH/prompts/agent-coding.md"],
+  "temperature": 0.7
+}
+```
+
+The file is read at session creation time. If it doesn't exist, the embedded
+default is used. The override replaces only the base system prompt layer; the
+operational model (9P documentation), environment block, and agent-specific
+prompt commands are still appended on top.
+
+Model-specific prompts live at `~/.config/ollie/prompts/SYSTEM_PROMPT_*.md`.
+Create an agent config per model family and point `systemPrompt` at the
+appropriate file.
\ No newline at end of file