feat: add @tanstack/db-playbook package for AI agent documentation

[KyleAMathews]

Summary

Adds @tanstack/db-playbook package - a playbook of AI-agent-optimized skills that helps coding assistants (Claude Code, Cursor, Copilot) build TanStack DB applications effectively.

What is a Playbook?

A playbook is the collection of skills, patterns, and tools someone uses in a vibe-coding context — analogous to "stack" but for the less deliberate, more aesthetic-driven way people assemble their setup now.

Approach

Why a playbook? AI agents struggle with large documentation. Skills provide distilled, task-focused patterns that agents can quickly consume and apply.

Structure: Hierarchical SKILL.md files with progressive disclosure:

• Router skill (tanstack-db/SKILL.md) - Entry point with routing table
• Domain skills - live-queries, mutations, collections, schemas, electric
• References - Deep-dive docs in references/ subdirectories

CLI

# List all available skills
npx @tanstack/db-playbook list

# Show a specific skill
npx @tanstack/db-playbook show tanstack-db
npx @tanstack/db-playbook show tanstack-db/live-queries

Skills Structure

Skill	Purpose	References
tanstack-db	Router/entry point	Routes to sub-skills
tanstack-db/live-queries	Reactive queries	query-builder, joins, aggregations, subqueries, functional-variants, performance
tanstack-db/mutations	Optimistic updates	paced-mutations, handlers, transactions, error-handling, temporary-ids
tanstack-db/collections	Data sources	query-collection, electric-collection, local-collections, sync-modes, custom-collections
tanstack-db/schemas	Validation	validation, transformations, tinput-toutput, error-handling
tanstack-db/electric	Real-time sync	txid-matching, shapes, proxy-setup, debugging

Package Structure

packages/playbook/
├── package.json          # @tanstack/db-playbook
├── bin/cli.js            # CLI tool (db-playbook list/show)
├── README.md
└── skills/
    └── tanstack-db/
        ├── SKILL.md      # Router skill with routing table
        ├── live-queries/
        ├── mutations/
        ├── collections/
        ├── schemas/
        └── electric/

Verification

# Verify CLI
npx @tanstack/db-playbook list
npx @tanstack/db-playbook show tanstack-db/live-queries

# Verify structure
find packages/playbook -name "*.md" | head -20

---

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 688f565

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@tanstack/db-playbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

More templates

• todos
• tanstack-start-example-basic
• @tanstack/db-example-paced-mutations-demo
• tanstack-start-db-projects-example
• @tanstack/db-example-react-todo
• offline-transactions-react-native
• @tanstack/db-example-solid-todo

@tanstack/angular-db

npm i https://pkg.pr.new/@tanstack/angular-db@1206

@tanstack/db

npm i https://pkg.pr.new/@tanstack/db@1206

@tanstack/db-ivm

npm i https://pkg.pr.new/@tanstack/db-ivm@1206

@tanstack/electric-db-collection

npm i https://pkg.pr.new/@tanstack/electric-db-collection@1206

@tanstack/offline-transactions

npm i https://pkg.pr.new/@tanstack/offline-transactions@1206

@tanstack/db-playbook

npm i https://pkg.pr.new/@tanstack/db-playbook@1206

@tanstack/powersync-db-collection

npm i https://pkg.pr.new/@tanstack/powersync-db-collection@1206

@tanstack/query-db-collection

npm i https://pkg.pr.new/@tanstack/query-db-collection@1206

@tanstack/react-db

npm i https://pkg.pr.new/@tanstack/react-db@1206

@tanstack/rxdb-db-collection

npm i https://pkg.pr.new/@tanstack/rxdb-db-collection@1206

@tanstack/solid-db

npm i https://pkg.pr.new/@tanstack/solid-db@1206

@tanstack/svelte-db

npm i https://pkg.pr.new/@tanstack/svelte-db@1206

@tanstack/trailbase-db-collection

npm i https://pkg.pr.new/@tanstack/trailbase-db-collection@1206

@tanstack/vue-db

npm i https://pkg.pr.new/@tanstack/vue-db@1206

commit: 688f565

[github-actions]

Size Change: 0 B

Total Size: 92 kB

ℹ️ View Unchanged

Filename	Size
./packages/db/dist/esm/collection/change-events.js	1.39 kB
./packages/db/dist/esm/collection/changes.js	1.22 kB
./packages/db/dist/esm/collection/events.js	388 B
./packages/db/dist/esm/collection/index.js	3.32 kB
./packages/db/dist/esm/collection/indexes.js	1.1 kB
./packages/db/dist/esm/collection/lifecycle.js	1.75 kB
./packages/db/dist/esm/collection/mutations.js	2.34 kB
./packages/db/dist/esm/collection/state.js	3.49 kB
./packages/db/dist/esm/collection/subscription.js	3.71 kB
./packages/db/dist/esm/collection/sync.js	2.41 kB
./packages/db/dist/esm/deferred.js	207 B
./packages/db/dist/esm/errors.js	4.7 kB
./packages/db/dist/esm/event-emitter.js	748 B
./packages/db/dist/esm/index.js	2.69 kB
./packages/db/dist/esm/indexes/auto-index.js	742 B
./packages/db/dist/esm/indexes/base-index.js	766 B
./packages/db/dist/esm/indexes/btree-index.js	2.17 kB
./packages/db/dist/esm/indexes/lazy-index.js	1.1 kB
./packages/db/dist/esm/indexes/reverse-index.js	538 B
./packages/db/dist/esm/local-only.js	837 B
./packages/db/dist/esm/local-storage.js	2.1 kB
./packages/db/dist/esm/optimistic-action.js	359 B
./packages/db/dist/esm/paced-mutations.js	496 B
./packages/db/dist/esm/proxy.js	3.75 kB
./packages/db/dist/esm/query/builder/functions.js	733 B
./packages/db/dist/esm/query/builder/index.js	4.09 kB
./packages/db/dist/esm/query/builder/ref-proxy.js	1.05 kB
./packages/db/dist/esm/query/compiler/evaluators.js	1.42 kB
./packages/db/dist/esm/query/compiler/expressions.js	430 B
./packages/db/dist/esm/query/compiler/group-by.js	1.81 kB
./packages/db/dist/esm/query/compiler/index.js	2.02 kB
./packages/db/dist/esm/query/compiler/joins.js	2.07 kB
./packages/db/dist/esm/query/compiler/order-by.js	1.45 kB
./packages/db/dist/esm/query/compiler/select.js	1.06 kB
./packages/db/dist/esm/query/expression-helpers.js	1.43 kB
./packages/db/dist/esm/query/ir.js	673 B
./packages/db/dist/esm/query/live-query-collection.js	360 B
./packages/db/dist/esm/query/live/collection-config-builder.js	5.43 kB
./packages/db/dist/esm/query/live/collection-registry.js	264 B
./packages/db/dist/esm/query/live/collection-subscriber.js	2.42 kB
./packages/db/dist/esm/query/live/internal.js	145 B
./packages/db/dist/esm/query/optimizer.js	2.56 kB
./packages/db/dist/esm/query/predicate-utils.js	2.97 kB
./packages/db/dist/esm/query/subset-dedupe.js	921 B
./packages/db/dist/esm/scheduler.js	1.3 kB
./packages/db/dist/esm/SortedMap.js	1.3 kB
./packages/db/dist/esm/strategies/debounceStrategy.js	247 B
./packages/db/dist/esm/strategies/queueStrategy.js	428 B
./packages/db/dist/esm/strategies/throttleStrategy.js	246 B
./packages/db/dist/esm/transactions.js	2.9 kB
./packages/db/dist/esm/utils.js	924 B
./packages/db/dist/esm/utils/browser-polyfills.js	304 B
./packages/db/dist/esm/utils/btree.js	5.61 kB
./packages/db/dist/esm/utils/comparison.js	952 B
./packages/db/dist/esm/utils/cursor.js	457 B
./packages/db/dist/esm/utils/index-optimization.js	1.51 kB
./packages/db/dist/esm/utils/type-guards.js	157 B

_{compressed-size-action::db-package-size}

[github-actions]

Size Change: 0 B

Total Size: 3.7 kB

ℹ️ View Unchanged

Filename	Size
./packages/react-db/dist/esm/index.js	225 B
./packages/react-db/dist/esm/useLiveInfiniteQuery.js	1.17 kB
./packages/react-db/dist/esm/useLiveQuery.js	1.34 kB
./packages/react-db/dist/esm/useLiveSuspenseQuery.js	559 B
./packages/react-db/dist/esm/usePacedMutations.js	401 B

_{compressed-size-action::react-db-package-size}