04-tooling

personal library index

Mon May 04 2026 20:00:00 GMT-0400 (Eastern Daylight Time) ·tooling-index ·status: active
librarybookscopyright-awareowned-content

Personal Library Index

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

AuthorYearTitleFormatLocal pathVault assessment note
Beck, Kent2002Test-Driven Development: By ExamplePDF~/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