08-tooling

personal library index

2026-05-05·tooling-index·status: active
librarybookscopyright-awareowned-content

Index of copyrighted books the founder owns as digital files, stored OUTSIDE the git-tracked vault to avoid committing copyrighted binaries. Each entry points to the local-only file path. Vault assessment notes for these books live in 06-reference/ and use source_fidelity: primary-source since the underlying text was read directly.

Why this index exists

Storage convention

Owned books

Author Year Title Format Local path Vault assessment note
Beck, Kent 2002 Test-Driven Development: By Example PDF ~/Documents/library/books/beck-2002-test-driven-development-by-example.pdf [[../06-reference/2026-05-05-beck-tdd-by-example]]

How Ray uses this index

When the founder asks Ray to read or assess a book:

  1. Check this index first. If owned, read the local PDF directly and use source_fidelity: primary-source in the assessment note frontmatter.
  2. If not owned, build the assessment from public sources (Wikipedia, author talks, blog posts, secondary summaries) and use source_fidelity: reconstructed-from-web in the frontmatter.
  3. Per copyright discipline (CLAUDE.md mandatory_copyright_requirements + the no-derivative-summaries rule): no >15-word direct quotes, no chapter-by-chapter reproduction, no displacive long-form summaries. The assessment note should be SHORTER and DENSER than the source, not a substitute for it.
  4. When upgrading a note from reconstructed-from-web to primary-source, preserve the public-source citations (they show due diligence) but rewrite the body to reflect direct primary-source reading.

Connection to the bookstore-for-agents concept

This index is a 1-person prototype of the bookstore-for-agents wedge - the founder owns a PDF, Ray ingests it, and the vault gets a primary-source assessment. At scale, this is exactly what an agent-native bookstore primitive looks like (founder-owned credentials → publisher API → agent reads → vault note). See [[../01-projects/bookstore-for-agents/2026-05-05-concept-seed]].

Maintenance