From a02f817bf18a9f012bc5f14481ea90ebc18b8992 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 9 May 2026 16:46:10 +0000
Subject: [PATCH] Samskara modal: explain when the injected prompt actually
 changes

Two of the panels in this modal correspond to text that lands in the
chat-loop's per-turn system-prompt appendix, but they update on
completely different cadences and the modal never said so. Result was
the natural reader question "does this change between turns?" had no
on-screen answer.

Add short help paragraphs under both relevant section headers:

- Compound summary: static for a whole conversation. The samskara
  worker's compound-regen phase rebuilds it once enough new samskaras
  have been minted since the last regen, so it drifts between
  conversations rather than mid-thread.
- Cohort fires: one cohort per user turn; each turn's bullets were
  appended next to the compound summary in that turn's prompt and
  resolved against whatever the user said next.

The first paragraph also points the reader at the second so the
"there's a per-turn fire list too" detail isn't buried.
---
 src/screens/Samskara.svelte | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/src/screens/Samskara.svelte b/src/screens/Samskara.svelte
index d34a104..cb76764 100644
--- a/src/screens/Samskara.svelte
+++ b/src/screens/Samskara.svelte
@@ -895,6 +895,15 @@
            this session. Stale / empty cases rendered explicitly so
            "nothing shown" reads as data rather than a bug. -->
       <h2 class="pane-section">Compound summary (always on in system prompt)</h2>
+      <p class="subtle pane-help">
+        Static for the whole conversation. A background worker rebuilds
+        it once enough new samskaras have been minted since the last
+        regen, so the paragraph drifts between conversations rather than
+        mid-thread. Each turn also gets a per-turn "fired this turn"
+        bullet list appended next to this paragraph - recomputed from
+        the current user message - which is what the Cohort fires
+        section below shows the history of.
+      </p>
       {#if compound === null && !loading && !error}
         <p class="subtle">No compound summary yet - the worker builds one once you have ~5 samskaras.</p>
       {:else if compound}
@@ -956,6 +965,12 @@
           </label>
         {/if}
       </div>
+      <p class="subtle pane-help">
+        One cohort per user turn. Each turn's top-scoring samskaras were
+        appended to that turn's system prompt alongside the compound
+        summary above, then resolved against whatever the user said
+        next.
+      </p>
       {#if !threadId}
         <p class="subtle">Open a conversation to see fires scoped to it.</p>
       {:else if cohortGroups.length === 0 && !loading}
@@ -1273,6 +1288,15 @@
   .pane-section:first-child {
     margin-top: 0;
   }
+  /* Help text under a section heading. Tucked tight to the heading so
+     the relationship reads as "subtitle" rather than "first paragraph
+     of body content"; uppercase pane-section above already carries the
+     visual break. */
+  .pane-help {
+    margin: -0.2rem 0 0.6rem;
+    font-size: 0.85rem;
+    line-height: 1.4;
+  }
 
   .counts-grid {
     display: grid;