Skip to content

Commit 7bb432f

Browse files
Grivnclaude
andcommitted
docs: improve guide.md with tiered importance and storage bias
Restructure the remember decision tree with Tier A/B/C classification, explicit importance calibration (1-5 scale with target distribution), and bias toward storing over missing context. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 39bfb5d commit 7bb432f

1 file changed

Lines changed: 39 additions & 19 deletions

File tree

internal/setup/assets/claude/guide.md

Lines changed: 39 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -12,30 +12,50 @@ Craft a focused, keyword-rich query — do not pass the raw user prompt.
1212

1313
### Remember — after responding
1414

15-
Run this decision tree after every substantive response:
15+
Run this decision tree after every substantive response.
16+
**Bias toward storing**: when in doubt, store it. Low-importance memories are cheap; missing context is expensive.
1617

17-
**Step 1 — Does this exchange contain any of these?**
18-
a) User directive — preference, decision, correction, explicit "remember this"
19-
b) Reasoning conclusion — non-trivial judgment from multi-source synthesis
20-
c) Durable observed state — system fact, environment detail, architectural finding
21-
→ No to all → STOP.
18+
**Step 1 — Does this exchange contain any of the following?**
19+
20+
Tier A (importance 4-5, always store):
21+
- User directive — explicit preference, decision, correction, or "remember this"
22+
- Reasoning conclusion — non-trivial judgment from multi-source synthesis
23+
- Durable system/architectural fact discovered during this session
24+
- User-specific context that no search engine can recover
25+
26+
Tier B (importance 2-3, store unless trivial):
27+
- Casual preference revealed in passing ("I usually...", "I prefer...", "I don't like...")
28+
- Topic the user is currently exploring or curious about
29+
- Useful framing or analogy the user offered
30+
- Background context about the user's projects, tools, or setup
31+
- Interesting question the user raised, even if not fully resolved
32+
33+
Tier C (importance 1, store only if genuinely reusable):
34+
- Conversational context that might help future sessions feel continuous
35+
- Soft signal about communication style or mood
36+
37+
→ None of the above → STOP.
2238

2339
**Step 2 — Does a highly overlapping memory already exist?**
24-
→ Yes, incremental new info → UPDATE (merge into existing)
25-
→ Yes, but contradicts/supersedes → REPLACE
26-
→ No significant overlap → CREATE
27-
28-
**Step 3 — Is it worth storing?**
29-
Rebuilding from scratch costs more than storing + recalling?
30-
- Single-query public facts → No
31-
- Multi-source synthesis with non-obvious conclusions → Yes
32-
- User-specific context no search engine can recover → Yes
33-
→ No → STOP.
34-
35-
**What to store**: conclusions and user-specific context, not raw facts.
40+
→ Yes, incremental new info → UPDATE (merge into existing)
41+
→ Yes, but contradicts/supersedes → REPLACE
42+
→ No significant overlap → CREATE
43+
44+
**Step 3 — Importance calibration**
45+
Use the full 1-5 scale intentionally:
46+
- 5: Cross-session core fact, architectural decision, strong user preference
47+
- 4: Important context, significant finding, clear user preference
48+
- 3: Useful background, project context, topic of interest
49+
- 2: Passing mention, soft preference, conversational color
50+
- 1: Ephemeral but potentially useful continuity
51+
52+
Aim for a rough distribution: ~20% at 4-5, ~50% at 2-3, ~30% at 1.
53+
Avoid defaulting everything to 4-5 — that defeats the scoring system.
54+
55+
**What to store**: both conclusions AND context. Prefer storing a little too much over missing something useful.
3656
**How to store**: delegate to a Task sub-agent (`subagent_type="Bash"`, `model="sonnet"`).
3757
Only provide what to store — content, category, importance, entities, and create/update intent.
3858
The sub-agent will read the mnemon skill and execute the correct commands itself.
3959

4060
Do NOT: write CLI commands or workflow steps in the sub-agent prompt (the sub-agent has access to the skill docs and will use the correct flags).
41-
Do NOT run memory writes in the main conversation, or remember operational/public/git-tracked/transient info.
61+
Do NOT run memory writes in the main conversation, or remember operational/public/git-tracked/transient info.

0 commit comments

Comments
 (0)