diff --git a/apps/ai-game-creator-shell/src/App.tsx b/apps/ai-game-creator-shell/src/App.tsx
index cadf990b4..cb5a6aa9d 100644
--- a/apps/ai-game-creator-shell/src/App.tsx
+++ b/apps/ai-game-creator-shell/src/App.tsx
@@ -1669,6 +1669,10 @@ export function App({
     // DirectProject history is written by Rust from raw app-server items.
     // The browser only renders that projection and must not append chat rows.
     if (projectSupervisorOnly && directCodexProductRuntime) {
+      // `messages` is only an optimistic UI projection in Direct mode; it is
+      // intentionally not proof of durability. Rust owns the raw response
+      // history, so this effect must not route these rows through the generic
+      // browser conversation writer.
       savedConversationCountRef.current = messages.length;
       return;
     }