this repo has no description
Document open-ended search workflow using query expansion
For broad queries like "what are the main themes?" or "find references
to the protagonist's childhood", Claude automatically expands queries
into multiple specific search terms using domain knowledge, runs
parallel searches, and synthesizes results.
This leverages Claude's knowledge to catch synonyms and related concepts
without requiring fuzzy search infrastructure.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
+32
+4
AGENTS.md
+4
AGENTS.md
···
85
85
2. Added `findTocItemByHref()` - recursively searches TOC tree for matching href
86
86
3. Updated `formatToc()` - shows `[ch: N]` inline with each entry
87
87
4. Fixed `getChapterContent()` - uses proper TOC lookup for title extraction
88
+
89
+
### 2025-11-26: Open-Ended Search Documentation
90
+
91
+
Added documentation for handling broad/conceptual queries using LLM-assisted query expansion. For queries like "what are the main themes?" or "find references to the protagonist's childhood", Claude expands the query into multiple specific search terms using domain knowledge, runs parallel searches, and synthesizes the results. This leverages Claude's knowledge to catch synonyms and related concepts without requiring fuzzy search infrastructure.
+2
README.md
+2
README.md
···
9
9
- **Chapter reading** - read specific chapters by number
10
10
- **Full extraction** - extract entire book as markdown
11
11
- **Search** - find text with surrounding context
12
+
- **Open-ended search** - broad queries are automatically expanded using Claude's domain knowledge
12
13
13
14
## Installation
14
15
···
23
24
- "Read chapter 5"
24
25
- "Search for 'democracy' in the book"
25
26
- "Extract the entire book as markdown"
27
+
- "What does the book say about the main character's motivation?" (open-ended queries work too!)
26
28
27
29
Claude will automatically use this skill when it detects EPUB-related requests.
28
30
+26
SKILL.md
+26
SKILL.md
···
56
56
3. **Read specific chapters** for targeted analysis, or use **full** for complete extraction
57
57
4. **Use search** to find specific topics, quotes, or references
58
58
59
+
## Open-Ended Search
60
+
61
+
For broad or conceptual queries like "what are the main themes in this book?" or "find all references to the protagonist's childhood", use **query expansion**:
62
+
63
+
1. **Expand the query** into multiple specific search terms using domain knowledge
64
+
- Example: "protagonist's childhood" → search for character name, "young", "childhood", "memory", "father", "mother", "grew up", etc.
65
+
2. **Run searches in parallel** for each expanded term
66
+
3. **Synthesize results** by deduplicating and consolidating findings across searches
67
+
68
+
This approach leverages Claude's domain knowledge to catch synonyms, related concepts, and terminology variations that a simple keyword search would miss.
69
+
70
+
### Example
71
+
72
+
User asks: "What does the book say about the author's research methodology?"
73
+
74
+
Expand to searches:
75
+
- "methodology"
76
+
- "research"
77
+
- "study"
78
+
- "analysis"
79
+
- "data"
80
+
- "findings"
81
+
- "evidence"
82
+
83
+
Then consolidate the results into a comprehensive answer.
84
+
59
85
## Output Format
60
86
61
87
All output is clean Markdown: