book-tracker阅读追踪

File structure

CODEBLOCK0

What it tracks

In progress: What you're currently reading, where you are, any notes mid-read.

Finished: Rating, key ideas, best quotes, what changed your thinking.

Abandoned: Books you gave up on and why — this data is useful too.

Want to read: Recommendations with context (who recommended it, why it matters to you).

Adding books

Start reading: /book start [title] [author]
Finish reading: /book done [title] — triggers a brief reflection prompt
Add to list: /book want [title] — adds with optional reason
Log a note mid-read: /book note [title] [note]
Abandoned: /book drop [title] [why]

Post-reading reflection

When you mark a book as done, the agent asks 4 questions:

1. 1. What's the one idea from this book you'll actually use or remember?
2. What surprised you?
3. Who would you recommend this to and why?
4. Rating: 1-5

Short answers are fine. One sentence each is enough.
These become the book's entry in library.md.

library.md structure

CODEBLOCK1

Reading list intelligence

INLINECODE5 — suggests what to read next based on:

• - What you've enjoyed most (by rating and genre)
• Themes you've been exploring lately
• Books you've had on the list longest
• Any books that connect to what you're working on or thinking about

Not just a ranked list. A recommendation with a reason:

CODEBLOCK2

Theme tracking

After 10+ books, patterns become visible.

INLINECODE6 — what have you been reading about?

CODEBLOCK3

Book and knowledge-capture integration

When you log a quote or key idea from a book:
INLINECODE7

The skill offers to add it to knowledge-capture:
"Add this to your knowledge base? It'll be searchable there alongside your other notes."

The two skills build on each other. Books feed the knowledge base.
The knowledge base surfaces relevant reading notes when you're thinking about a topic.

Reading goal

Optional. Set a books-per-month target if you want one.

INLINECODE8

At the end of each month, a brief note:
"Read 2 books in March, goal was 3. On track for the year (8 of 10)."
Not a guilt trip. Just a number.

Privacy rules

Reading history is personal and low-stakes, but still private.

Context boundary: Only surface reading lists and notes in the owner's private channel.
Never share what someone is reading or their book notes in a group context.

Approval gate: No book is added to or removed from the library without
the owner's instruction — either explicit command or confirmation of a suggestion.

Management commands

• - /book start [title] [author] — start reading
• INLINECODE10 — mark finished, trigger reflection
• INLINECODE11 — mark abandoned
• INLINECODE12 — add to reading list
• INLINECODE13 — log a note
• INLINECODE14 — get a recommendation
• INLINECODE15 — show reading list
• INLINECODE16 — show all books
• INLINECODE17 — reading pattern analysis
• INLINECODE18 — search your library
• INLINECODE19 — show entry for one book