You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Daniel Covington 8437bb11dd Add first principles thinking summaries 2 days ago
books Add first principles thinking summaries 2 days ago
prompts Add first principles thinking summaries 2 days ago
templates Remove redundant docx/pdf exports, add .gitignore 2 days ago
.gitignore Remove redundant docx/pdf exports, add .gitignore 2 days ago
AGENTS.md init 2 days ago
CLAUDE.md Add first principles thinking summaries 2 days ago
README.md Add first principles thinking summaries 2 days ago

README.md

๐Ÿ“š Book Summarizer โ€” Reading Retention System

A structured system for summarizing books chapter by chapter, powered by AI agents that act as expert summarizers and teachers.


How to Use

Step 1 โ€” Start a New Book

Tell your AI agent:

new book: Atomic Habits by James Clear

The agent will set up a folder under books/ for you. If you provide a PDF, EPUB, TXT, or Markdown file, the original file is moved into that book's folder so the source stays with its notes.

Step 2 โ€” Share a Chapter

Paste the chapter text, or upload a PDF/EPUB/text file and tell the agent which chapter to process:

chapter 1: [paste text here]

or simply upload the file and say process chapter 3.

Step 3 โ€” Get Your Summary Package

The agent produces:

  • ๐Ÿ“– Narrative summary โ€” 2โ€“4 paragraphs of flowing prose
  • ๐Ÿ”‘ Key points โ€” 5โ€“10 bullet-point takeaways
  • ๐Ÿ’ฌ Memorable quotes โ€” direct quotes from the author
  • ๐Ÿ”— Connections โ€” how this chapter links to earlier ones
  • โ“ Review questions โ€” test your understanding
  • ๐Ÿƒ Flashcards โ€” spaced-repetition Q&A pairs

Step 4 โ€” Review Anytime

Command Result
story so far See your growing master summary
quiz me on chapter 3 Interactive quiz on a chapter
flashcards for chapter 2 Drill your flashcards
connections Themes across all chapters

Folder Structure

book-summarizer/
โ”œโ”€โ”€ CLAUDE.md                    # Agent instructions (do not delete)
โ”œโ”€โ”€ README.md                    # This file
โ”œโ”€โ”€ templates/
โ”‚   โ”œโ”€โ”€ chapter-summary.md       # Template for chapter files
โ”‚   โ”œโ”€โ”€ master-summary.md        # Template for the master summary
โ”‚   โ””โ”€โ”€ flashcards.md            # Standalone flashcard template
โ”œโ”€โ”€ prompts/
โ”‚   โ”œโ”€โ”€ start-new-book.md        # Prompt to kick off a new book
โ”‚   โ”œโ”€โ”€ process-chapter.md       # Prompt to process a chapter
โ”‚   โ””โ”€โ”€ review-session.md        # Prompt for review/quiz sessions
โ””โ”€โ”€ books/
    โ””โ”€โ”€ [book-title-slug]/
        โ”œโ”€โ”€ 00-book-overview.md
        โ”œโ”€โ”€ master-summary.md
        โ”œโ”€โ”€ [original-book-file].pdf
        โ”œโ”€โ”€ chapter-01-[slug].md
        โ”œโ”€โ”€ chapter-02-[slug].md
        โ””โ”€โ”€ ...

Tips for Best Results

  • Paste the full chapter text for the richest summary. If the chapter is long, the agent handles it.
  • React and comment โ€” if something surprises you, say so. The agent will engage with your thoughts.
  • Review before reading the next chapter โ€” glance at the flashcards and try the review questions.
  • Use story so far before each new session โ€” it re-orients you to where the book's argument has reached.

Powered by TurnKey Linux.