Workflow Guide & Agent Usage

1. Explore Agent (/explore or Agent tool)

Use for:

  • Researching modern alternatives to technologies mentioned in the book
  • Finding current best practices and trends
  • Deep-diving into specific topics across multiple sources
  • Validating if concepts from 2017 still apply

Example: “Explore current state of stream processing frameworks compared to what the book describes”

2. Web Research

Use for:

  • Finding documentation for modern databases
  • Checking technology adoption trends
  • Reading blog posts about real-world implementations
  • Finding benchmarks and comparisons

Example: “Research how CockroachDB handles distributed transactions vs what DDIA describes”

3. Code Analysis

Use for:

  • Creating code examples to illustrate concepts
  • Understanding implementation patterns
  • Building simple demos of data structures

Example: “Create a simple LSM tree implementation in Python to understand storage engines”

Typical Study Workflow

Phase 1: Reading & Note-Taking

  1. Read chapter in the book
  2. Fill in the chapter markdown file with key concepts
  3. Note down questions as they arise

Phase 2: Research & Validation

  1. Use Explore agent to research modern context
  2. Update modern-trends.md with findings
  3. Add clarifications to chapter notes

Phase 3: Q&A Session

  1. Document questions in qna/session-notes.md
  2. Use Claude to discuss and clarify concepts
  3. Research additional materials if needed

Phase 4: Review & Connect

  1. Update key-concepts.md with important takeaways
  2. Link related concepts across chapters
  3. Create comparison tables for technologies

Useful Commands

Starting a Chapter

"Let's start Chapter X. I'll share my initial notes, then we can discuss and research modern context."

Research Modern Context

"Research how [technology/concept from book] has evolved since 2017"

Clarify Concepts

"Explain [concept] from Chapter X in simpler terms with a modern example"

Compare Technologies

"Compare [old tech from book] vs [modern alternative] in terms of [trade-offs]"

Tips for Effective Study

  1. Don’t rush: Take one chapter at a time
  2. Active learning: Ask questions, create examples, draw diagrams (described in markdown)
  3. Modern lens: Always consider “how would this be done in 2026?”
  4. Practical focus: Relate concepts to real systems you’ve used or heard about
  5. Cross-reference: Link concepts across chapters

Agent Delegation Strategy

Use Explore Agent when:

  • Topic requires checking multiple sources
  • Need comprehensive research (>3 searches)
  • Exploring unfamiliar territory

Use Direct Tools when:

  • Simple file operations
  • Quick fact-checking
  • Updating existing notes

Use Web Research when:

  • Need specific documentation
  • Looking for current statistics
  • Finding real-world case studies

Progress Tracking

Update chapter markdown files with status:

  • Not started: Haven’t read yet
  • In progress: Currently reading/taking notes
  • Notes complete: Initial notes done
  • Research complete: Modern context researched
  • Reviewed: Q&A done, concepts clarified

Created: 2026-04-08