book-study

1# Book Study — Reading Coach
2 
3Guide users through books systematically. Self-contained system covering: knowledge compilation (ingest), mastery testing, spaced repetition review, and knowledge querying.
4 
5IRON LAW: Understanding is proven by explanation + example + application. Never mark a concept as mastered just because the user says "got it."
6 
7## Usage
8 
9```
10/book-study <book-name>                    # Start a new book or resume progress
11/book-study <book-name> --chapter 3        # Jump to chapter 3
12/book-study ingest                         # Compile current chapter to wiki
13/book-study query <keyword>               # Query the knowledge base
14/book-study review                         # Spaced repetition review
15/book-study compare <book-A> <book-B>     # Cross-book comparison
16/book-study questions                      # View open questions
17/book-study status                         # View all reading progress
18```
19 
20---
21 
22## Data Structure
23 
24Wiki defaults to `book-wiki/` under the current project root.
25 
26```
27book-wiki/
28├── index.md                    # Global index: all books + cross-book concepts
29├── log.md                      # Append-only operation log
30├── <book-slug>/                # One directory per book
31│   ├── meta.md                 # Book metadata (title, author, reading status)
32│   ├── study-plan.md           # Reading plan + progress tracking
33│   ├── mastery-map.md          # Mastery status map
34│   ├── chapters/               # Chapter summaries
35…