oh-my-claude-sisyphus 3.7.0 → 3.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +24 -1
  2. package/commands/hud.md +37 -5
  3. package/commands/omc-setup.md +105 -0
  4. package/dist/__tests__/hud/analytics-display.test.js +137 -1
  5. package/dist/__tests__/hud/analytics-display.test.js.map +1 -1
  6. package/dist/__tests__/hud-windows.test.d.ts +2 -0
  7. package/dist/__tests__/hud-windows.test.d.ts.map +1 -0
  8. package/dist/__tests__/hud-windows.test.js +91 -0
  9. package/dist/__tests__/hud-windows.test.js.map +1 -0
  10. package/dist/features/rate-limit-wait/daemon.d.ts.map +1 -1
  11. package/dist/features/rate-limit-wait/daemon.js +41 -1
  12. package/dist/features/rate-limit-wait/daemon.js.map +1 -1
  13. package/dist/features/state-manager/index.d.ts.map +1 -1
  14. package/dist/features/state-manager/index.js +4 -1
  15. package/dist/features/state-manager/index.js.map +1 -1
  16. package/dist/hooks/permission-handler/__tests__/index.test.js +47 -0
  17. package/dist/hooks/permission-handler/__tests__/index.test.js.map +1 -1
  18. package/dist/hooks/permission-handler/index.d.ts +1 -1
  19. package/dist/hooks/permission-handler/index.d.ts.map +1 -1
  20. package/dist/hooks/permission-handler/index.js +11 -15
  21. package/dist/hooks/permission-handler/index.js.map +1 -1
  22. package/dist/hooks/plugin-patterns/index.d.ts +5 -0
  23. package/dist/hooks/plugin-patterns/index.d.ts.map +1 -1
  24. package/dist/hooks/plugin-patterns/index.js +26 -1
  25. package/dist/hooks/plugin-patterns/index.js.map +1 -1
  26. package/dist/hooks/session-end/index.d.ts +0 -8
  27. package/dist/hooks/session-end/index.d.ts.map +1 -1
  28. package/dist/hooks/session-end/index.js +5 -12
  29. package/dist/hooks/session-end/index.js.map +1 -1
  30. package/dist/hooks/subagent-tracker/index.d.ts.map +1 -1
  31. package/dist/hooks/subagent-tracker/index.js +32 -17
  32. package/dist/hooks/subagent-tracker/index.js.map +1 -1
  33. package/dist/hud/analytics-display.d.ts +16 -0
  34. package/dist/hud/analytics-display.d.ts.map +1 -1
  35. package/dist/hud/analytics-display.js +35 -9
  36. package/dist/hud/analytics-display.js.map +1 -1
  37. package/dist/hud/render.d.ts.map +1 -1
  38. package/dist/hud/render.js +49 -18
  39. package/dist/hud/render.js.map +1 -1
  40. package/dist/hud/types.d.ts +2 -0
  41. package/dist/hud/types.d.ts.map +1 -1
  42. package/dist/hud/types.js +14 -0
  43. package/dist/hud/types.js.map +1 -1
  44. package/dist/installer/index.d.ts.map +1 -1
  45. package/dist/installer/index.js +3 -2
  46. package/dist/installer/index.js.map +1 -1
  47. package/hooks/keyword-detector.sh +4 -4
  48. package/hooks/persistent-mode.sh +10 -10
  49. package/hooks/session-start.sh +4 -4
  50. package/package.json +1 -1
  51. package/scripts/keyword-detector.mjs +4 -4
  52. package/scripts/persistent-mode.mjs +6 -6
  53. package/scripts/persistent-mode.sh +10 -10
  54. package/scripts/session-start.mjs +4 -4
  55. package/skills/hud/SKILL.md +37 -5
  56. package/skills/omc-setup/SKILL.md +162 -4
  57. package/skills/writer-memory/SKILL.md +443 -0
  58. package/skills/writer-memory/lib/character-tracker.ts +338 -0
  59. package/skills/writer-memory/lib/memory-manager.ts +804 -0
  60. package/skills/writer-memory/lib/relationship-graph.ts +400 -0
  61. package/skills/writer-memory/lib/scene-organizer.ts +544 -0
  62. package/skills/writer-memory/lib/synopsis-builder.ts +339 -0
  63. package/skills/writer-memory/templates/synopsis-template.md +46 -0
  64. package/templates/hooks/keyword-detector.sh +4 -4
  65. package/templates/hooks/persistent-mode.sh +10 -10
  66. package/templates/hooks/session-start.sh +4 -4
@@ -0,0 +1,443 @@
1
+ ---
2
+ name: writer-memory
3
+ description: Agentic memory system for writers - track characters, relationships, scenes, and themes
4
+ argument-hint: "init|char|rel|scene|query|validate|synopsis|status|export [args]"
5
+ ---
6
+
7
+ # Writer Memory - Agentic Memory System for Writers
8
+
9
+ Persistent memory system designed for creative writers, with first-class support for Korean storytelling workflows.
10
+
11
+ ## Overview
12
+
13
+ Writer Memory maintains context across Claude sessions for fiction writers. It tracks:
14
+
15
+ - **Characters (캐릭터)**: Emotional arcs (감정궤도), attitudes (태도), dialogue tone (대사톤), speech levels
16
+ - **World (세계관)**: Settings, rules, atmosphere, constraints
17
+ - **Relationships (관계)**: Character dynamics and evolution over time
18
+ - **Scenes (장면)**: Cut composition (컷구성), narration tone, emotional tags
19
+ - **Themes (테마)**: Emotional themes (정서테마), authorial intent
20
+
21
+ All data persists in `.writer-memory/memory.json` for git-friendly collaboration.
22
+
23
+ ## Commands
24
+
25
+ | Command | Action |
26
+ |---------|--------|
27
+ | `/oh-my-claudecode:writer-memory init <project-name>` | Initialize new project memory |
28
+ | `/oh-my-claudecode:writer-memory status` | Show memory overview (character count, scene count, etc) |
29
+ | `/oh-my-claudecode:writer-memory char add <name>` | Add new character |
30
+ | `/oh-my-claudecode:writer-memory char <name>` | View character details |
31
+ | `/oh-my-claudecode:writer-memory char update <name> <field> <value>` | Update character field |
32
+ | `/oh-my-claudecode:writer-memory char list` | List all characters |
33
+ | `/oh-my-claudecode:writer-memory rel add <char1> <char2> <type>` | Add relationship |
34
+ | `/oh-my-claudecode:writer-memory rel <char1> <char2>` | View relationship |
35
+ | `/oh-my-claudecode:writer-memory rel update <char1> <char2> <event>` | Add relationship event |
36
+ | `/oh-my-claudecode:writer-memory scene add <title>` | Add new scene |
37
+ | `/oh-my-claudecode:writer-memory scene <id>` | View scene details |
38
+ | `/oh-my-claudecode:writer-memory scene list` | List all scenes |
39
+ | `/oh-my-claudecode:writer-memory theme add <name>` | Add theme |
40
+ | `/oh-my-claudecode:writer-memory world set <field> <value>` | Set world attribute |
41
+ | `/oh-my-claudecode:writer-memory query <question>` | Query memory naturally (Korean supported) |
42
+ | `/oh-my-claudecode:writer-memory validate <character> <dialogue>` | Check if dialogue matches character tone |
43
+ | `/oh-my-claudecode:writer-memory synopsis` | Generate emotion-focused synopsis |
44
+ | `/oh-my-claudecode:writer-memory export` | Export full memory as readable markdown |
45
+ | `/oh-my-claudecode:writer-memory backup` | Create manual backup |
46
+
47
+ ## Memory Types
48
+
49
+ ### 캐릭터 메모리 (Character Memory)
50
+
51
+ Tracks individual character attributes essential for consistent portrayal:
52
+
53
+ | Field | Korean | Description |
54
+ |-------|--------|-------------|
55
+ | `arc` | 감정궤도 | Emotional journey (e.g., "체념 -> 욕망자각 -> 선택") |
56
+ | `attitude` | 태도 | Current disposition toward life/others |
57
+ | `tone` | 대사톤 | Dialogue style (e.g., "담백", "직설적", "회피적") |
58
+ | `speechLevel` | 말투 레벨 | Formality: 반말, 존댓말, 해체, 혼합 |
59
+ | `keywords` | 핵심 단어 | Characteristic words/phrases they use |
60
+ | `taboo` | 금기어 | Words/phrases they would never say |
61
+ | `emotional_baseline` | 감정 기준선 | Default emotional state |
62
+ | `triggers` | 트리거 | What provokes emotional reactions |
63
+
64
+ **Example:**
65
+ ```
66
+ /writer-memory char add 새랑
67
+ /writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택"
68
+ /writer-memory char update 새랑 tone "담백, 현재충실, 감정억제"
69
+ /writer-memory char update 새랑 speechLevel "해체"
70
+ /writer-memory char update 새랑 keywords "그냥, 뭐, 괜찮아"
71
+ /writer-memory char update 새랑 taboo "사랑해, 보고싶어"
72
+ ```
73
+
74
+ ### 세계관 메모리 (World Memory)
75
+
76
+ Establishes the universe your story inhabits:
77
+
78
+ | Field | Korean | Description |
79
+ |-------|--------|-------------|
80
+ | `setting` | 배경 | Time, place, social context |
81
+ | `rules` | 규칙 | How the world operates (magic systems, social norms) |
82
+ | `atmosphere` | 분위기 | Overall mood and tone |
83
+ | `constraints` | 제약 | What cannot happen in this world |
84
+ | `history` | 역사 | Relevant backstory |
85
+
86
+ ### 관계 메모리 (Relationship Memory)
87
+
88
+ Captures the dynamic between characters over time:
89
+
90
+ | Field | Description |
91
+ |-------|-------------|
92
+ | `type` | Base relationship: romantic, familial, friendship, rivalry, professional |
93
+ | `status` | Current state: budding, stable, strained, broken, healing |
94
+ | `power_dynamic` | Who has the upper hand, if any |
95
+ | `events` | Timeline of relationship-changing moments |
96
+ | `tension` | Current unresolved conflicts |
97
+ | `intimacy_level` | Emotional closeness (1-10) |
98
+
99
+ **Example:**
100
+ ```
101
+ /writer-memory rel add 새랑 해랑 romantic
102
+ /writer-memory rel update 새랑 해랑 "첫 키스 - 새랑 회피"
103
+ /writer-memory rel update 새랑 해랑 "해랑 고백 거절당함"
104
+ /writer-memory rel update 새랑 해랑 "새랑 먼저 손 잡음"
105
+ ```
106
+
107
+ ### 장면 메모리 (Scene Memory)
108
+
109
+ Tracks individual scenes and their emotional architecture:
110
+
111
+ | Field | Korean | Description |
112
+ |-------|--------|-------------|
113
+ | `title` | 제목 | Scene identifier |
114
+ | `characters` | 등장인물 | Who appears |
115
+ | `location` | 장소 | Where it happens |
116
+ | `cuts` | 컷 구성 | Shot-by-shot breakdown |
117
+ | `narration_tone` | 내레이션 톤 | Narrative voice style |
118
+ | `emotional_tag` | 감정 태그 | Primary emotions (e.g., "설렘+불안") |
119
+ | `purpose` | 목적 | Why this scene exists in the story |
120
+ | `before_after` | 전후 변화 | What changes for characters |
121
+
122
+ ### 테마 메모리 (Theme Memory)
123
+
124
+ Captures the deeper meaning woven through your story:
125
+
126
+ | Field | Korean | Description |
127
+ |-------|--------|-------------|
128
+ | `name` | 이름 | Theme identifier |
129
+ | `expression` | 표현 방식 | How this theme manifests |
130
+ | `scenes` | 관련 장면 | Scenes that embody this theme |
131
+ | `character_links` | 캐릭터 연결 | Which characters carry this theme |
132
+ | `author_intent` | 작가 의도 | What you want readers to feel |
133
+
134
+ ## Synopsis Generation (시놉시스)
135
+
136
+ The `/synopsis` command generates an emotion-focused summary using 5 essential elements:
137
+
138
+ ### 5 Essential Elements (시놉시스 5요소)
139
+
140
+ 1. **주인공 태도 요약** (Protagonist Attitude Summary)
141
+ - How the protagonist approaches life/love/conflict
142
+ - Their core emotional stance
143
+ - Example: "새랑은 상실을 예방하기 위해 먼저 포기하는 사람"
144
+
145
+ 2. **관계 핵심 구도** (Core Relationship Structure)
146
+ - The central dynamic driving the story
147
+ - Power imbalances and tensions
148
+ - Example: "사랑받는 자와 사랑하는 자의 불균형"
149
+
150
+ 3. **정서적 테마** (Emotional Theme)
151
+ - The feeling the story evokes
152
+ - Not plot, but emotional truth
153
+ - Example: "손에 쥔 행복을 믿지 못하는 불안"
154
+
155
+ 4. **장르 vs 실제감정 대비** (Genre vs Real Emotion Contrast)
156
+ - Surface genre expectations vs. actual emotional content
157
+ - Example: "로맨스지만 본질은 자기수용 서사"
158
+
159
+ 5. **엔딩 정서 잔상** (Ending Emotional Aftertaste)
160
+ - The lingering feeling after the story ends
161
+ - Example: "씁쓸한 안도, 불완전한 해피엔딩의 여운"
162
+
163
+ ## Character Validation (캐릭터 검증)
164
+
165
+ The `/validate` command checks if dialogue matches a character's established voice.
166
+
167
+ ### What Gets Checked
168
+
169
+ | Check | Description |
170
+ |-------|-------------|
171
+ | **Speech Level** | Does formality match? (반말/존댓말/해체) |
172
+ | **Tone Match** | Does the emotional register fit? |
173
+ | **Keyword Usage** | Uses characteristic words? |
174
+ | **Taboo Violation** | Uses forbidden words? |
175
+ | **Emotional Range** | Within character's baseline? |
176
+ | **Context Fit** | Appropriate for relationship and scene? |
177
+
178
+ ### Validation Results
179
+
180
+ - **PASS**: Dialogue is consistent with character
181
+ - **WARN**: Minor inconsistencies, may be intentional
182
+ - **FAIL**: Significant deviation from established voice
183
+
184
+ **Example:**
185
+ ```
186
+ /writer-memory validate 새랑 "사랑해, 해랑아. 너무 보고싶었어."
187
+ ```
188
+ Output:
189
+ ```
190
+ [FAIL] 새랑 validation failed:
191
+ - TABOO: "사랑해" - character avoids direct declarations
192
+ - TABOO: "보고싶었어" - character suppresses longing expressions
193
+ - TONE: Too emotionally direct for 새랑's 담백 style
194
+
195
+ Suggested alternatives:
196
+ - "...왔네." (minimal acknowledgment)
197
+ - "늦었다." (deflection to external fact)
198
+ - "밥 먹었어?" (care expressed through practical concern)
199
+ ```
200
+
201
+ ## Context Query (맥락 질의)
202
+
203
+ Natural language queries against memory, with full Korean support.
204
+
205
+ ### Example Queries
206
+
207
+ ```
208
+ /writer-memory query "새랑은 이 상황에서 뭐라고 할까?"
209
+ /writer-memory query "규리의 현재 감정 상태는?"
210
+ /writer-memory query "해랑과 새랑의 관계는 어디까지 왔나?"
211
+ /writer-memory query "이 장면의 정서적 분위기는?"
212
+ /writer-memory query "새랑이 먼저 연락하는 게 맞아?"
213
+ /writer-memory query "해랑이 화났을 때 말투는?"
214
+ ```
215
+
216
+ The system synthesizes answers from all relevant memory types.
217
+
218
+ ## Behavior
219
+
220
+ 1. **On Init**: Creates `.writer-memory/memory.json` with project metadata and empty collections
221
+ 2. **Auto-Backup**: Changes are backed up before modification to `.writer-memory/backups/`
222
+ 3. **Korean-First**: Emotion vocabulary uses Korean terms throughout
223
+ 4. **Session Loading**: Memory is loaded on session start for immediate context
224
+ 5. **Git-Friendly**: JSON formatted for clean diffs and collaboration
225
+
226
+ ## Integration
227
+
228
+ ### With OMC Notepad System
229
+ Writer Memory integrates with `.omc/notepad.md`:
230
+ - Scene ideas can be captured as notes
231
+ - Character insights from analysis sessions are preserved
232
+ - Cross-reference between notepad and memory
233
+
234
+ ### With Architect Agent
235
+ For complex character analysis:
236
+ ```
237
+ Task(subagent_type="oh-my-claudecode:architect",
238
+ model="opus",
239
+ prompt="Analyze 새랑's arc across all scenes...")
240
+ ```
241
+
242
+ ### Character Validation Pipeline
243
+ Validation pulls context from:
244
+ - Character memory (tone, keywords, taboo)
245
+ - Relationship memory (dynamics with dialogue partner)
246
+ - Scene memory (current emotional context)
247
+ - Theme memory (authorial intent)
248
+
249
+ ### Synopsis Builder
250
+ Synopsis generation aggregates:
251
+ - All character arcs
252
+ - Key relationship events
253
+ - Scene emotional tags
254
+ - Theme expressions
255
+
256
+ ## Examples
257
+
258
+ ### Full Workflow
259
+
260
+ ```
261
+ # Initialize project
262
+ /writer-memory init 봄의 끝자락
263
+
264
+ # Add characters
265
+ /writer-memory char add 새랑
266
+ /writer-memory char update 새랑 arc "체념 -> 욕망자각 -> 선택"
267
+ /writer-memory char update 새랑 tone "담백, 현재충실"
268
+ /writer-memory char update 새랑 speechLevel "해체"
269
+
270
+ /writer-memory char add 해랑
271
+ /writer-memory char update 해랑 arc "확신 -> 동요 -> 기다림"
272
+ /writer-memory char update 해랑 tone "직진, 솔직"
273
+ /writer-memory char update 해랑 speechLevel "반말"
274
+
275
+ # Establish relationship
276
+ /writer-memory rel add 새랑 해랑 romantic
277
+ /writer-memory rel update 새랑 해랑 "첫 만남 - 해랑 일방적 호감"
278
+ /writer-memory rel update 새랑 해랑 "새랑 거절"
279
+ /writer-memory rel update 새랑 해랑 "재회 - 새랑 내적 동요"
280
+
281
+ # Set world
282
+ /writer-memory world set setting "서울, 현대, 20대 후반 직장인"
283
+ /writer-memory world set atmosphere "도시의 건조함 속 미묘한 온기"
284
+
285
+ # Add themes
286
+ /writer-memory theme add "포기하지 않는 사랑"
287
+ /writer-memory theme add "자기 보호의 벽"
288
+
289
+ # Add scene
290
+ /writer-memory scene add "옥상 재회"
291
+
292
+ # Query for writing
293
+ /writer-memory query "새랑은 이별 장면에서 어떤 톤으로 말할까?"
294
+
295
+ # Validate dialogue
296
+ /writer-memory validate 새랑 "해랑아, 그만하자."
297
+
298
+ # Generate synopsis
299
+ /writer-memory synopsis
300
+
301
+ # Export for reference
302
+ /writer-memory export
303
+ ```
304
+
305
+ ### Quick Character Check
306
+
307
+ ```
308
+ /writer-memory char 새랑
309
+ ```
310
+
311
+ Output:
312
+ ```
313
+ ## 새랑
314
+
315
+ **Arc (감정궤도):** 체념 -> 욕망자각 -> 선택
316
+ **Attitude (태도):** 방어적, 현실주의
317
+ **Tone (대사톤):** 담백, 현재충실
318
+ **Speech Level (말투):** 해체
319
+ **Keywords (핵심어):** 그냥, 뭐, 괜찮아
320
+ **Taboo (금기어):** 사랑해, 보고싶어
321
+
322
+ **Relationships:**
323
+ - 해랑: romantic (intimacy: 6/10, status: healing)
324
+
325
+ **Scenes Appeared:** 옥상 재회, 카페 대화, 마지막 선택
326
+ ```
327
+
328
+ ## Storage Schema
329
+
330
+ ```json
331
+ {
332
+ "version": "1.0",
333
+ "project": {
334
+ "name": "봄의 끝자락",
335
+ "genre": "로맨스",
336
+ "created": "2024-01-15T09:00:00Z",
337
+ "lastModified": "2024-01-20T14:30:00Z"
338
+ },
339
+ "characters": {
340
+ "새랑": {
341
+ "arc": "체념 -> 욕망자각 -> 선택",
342
+ "attitude": "방어적, 현실주의",
343
+ "tone": "담백, 현재충실",
344
+ "speechLevel": "해체",
345
+ "keywords": ["그냥", "뭐", "괜찮아"],
346
+ "taboo": ["사랑해", "보고싶어"],
347
+ "emotional_baseline": "평온한 무관심",
348
+ "triggers": ["과거 언급", "미래 약속"]
349
+ }
350
+ },
351
+ "world": {
352
+ "setting": "서울, 현대, 20대 후반 직장인",
353
+ "rules": [],
354
+ "atmosphere": "도시의 건조함 속 미묘한 온기",
355
+ "constraints": [],
356
+ "history": ""
357
+ },
358
+ "relationships": [
359
+ {
360
+ "id": "rel_001",
361
+ "from": "새랑",
362
+ "to": "해랑",
363
+ "type": "romantic",
364
+ "dynamic": "해랑 주도 → 균형",
365
+ "speechLevel": "반말",
366
+ "evolution": [
367
+ { "timestamp": "...", "change": "첫 만남 - 해랑 일방적 호감", "catalyst": "우연한 만남" },
368
+ { "timestamp": "...", "change": "새랑 거절", "catalyst": "과거 트라우마" },
369
+ { "timestamp": "...", "change": "재회 - 새랑 내적 동요", "catalyst": "옥상에서 재회" }
370
+ ],
371
+ "notes": "새랑의 불신 vs 해랑의 기다림",
372
+ "created": "..."
373
+ }
374
+ ],
375
+ "scenes": [
376
+ {
377
+ "id": "scene-001",
378
+ "title": "옥상 재회",
379
+ "characters": ["새랑", "해랑"],
380
+ "location": "회사 옥상",
381
+ "cuts": ["해랑 먼저 발견", "새랑 굳은 표정", "침묵", "해랑 먼저 말 걸기"],
382
+ "narration_tone": "건조체",
383
+ "emotional_tag": "긴장+그리움",
384
+ "purpose": "재회의 어색함과 남은 감정 암시",
385
+ "before_after": "새랑: 무관심 -> 동요"
386
+ }
387
+ ],
388
+ "themes": [
389
+ {
390
+ "name": "포기하지 않는 사랑",
391
+ "expression": "해랑의 일관된 태도",
392
+ "scenes": ["옥상 재회", "마지막 고백"],
393
+ "character_links": ["해랑"],
394
+ "author_intent": "집착이 아닌 믿음의 사랑"
395
+ }
396
+ ],
397
+ "synopsis": {
398
+ "protagonist_attitude": "새랑은 상실을 예방하기 위해 먼저 포기하는 사람",
399
+ "relationship_structure": "기다리는 자와 도망치는 자의 줄다리기",
400
+ "emotional_theme": "사랑받을 자격에 대한 의심",
401
+ "genre_contrast": "로맨스지만 본질은 자기수용 서사",
402
+ "ending_aftertaste": "불완전하지만 따뜻한 선택의 여운"
403
+ }
404
+ }
405
+ ```
406
+
407
+ ## File Structure
408
+
409
+ ```
410
+ .writer-memory/
411
+ ├── memory.json # Main memory file
412
+ ├── backups/ # Auto-backups before changes
413
+ │ ├── memory-2024-01-15-090000.json
414
+ │ └── memory-2024-01-20-143000.json
415
+ └── exports/ # Markdown exports
416
+ └── export-2024-01-20.md
417
+ ```
418
+
419
+ ## Tips for Writers
420
+
421
+ 1. **Start with Characters**: Build character memories before scenes
422
+ 2. **Update Relationships After Key Scenes**: Track evolution actively
423
+ 3. **Use Validation While Writing**: Catch voice inconsistencies early
424
+ 4. **Query Before Difficult Scenes**: Let the system remind you of context
425
+ 5. **Regular Synopsis**: Generate periodically to check thematic coherence
426
+ 6. **Backup Before Major Changes**: Use `/backup` before significant story pivots
427
+
428
+ ## Troubleshooting
429
+
430
+ **Memory not loading?**
431
+ - Check `.writer-memory/memory.json` exists
432
+ - Verify JSON syntax is valid
433
+ - Run `/writer-memory status` to diagnose
434
+
435
+ **Validation too strict?**
436
+ - Review taboo list for unintended entries
437
+ - Consider if character is growing (arc progression)
438
+ - Intentional breaks from pattern are valid for dramatic moments
439
+
440
+ **Query not finding context?**
441
+ - Ensure relevant data is in memory
442
+ - Try more specific queries
443
+ - Check character names match exactly