@tanstack/db-playbook

@tanstack/db-playbook

A playbook of skills for AI agents building with TanStack DB.

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.

This package provides structured documentation designed for AI coding assistants (Claude Code, Cursor, Copilot, etc.) to help them build TanStack DB applications effectively.

Skills are distilled, task-focused patterns that agents can quickly consume and apply — unlike large documentation that often exceeds context limits.

Installation

npm install @tanstack/db-playbook

CLI Usage

# 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
npx @tanstack/db-playbook show tanstack-db/mutations

Skills Structure

Skill	Purpose
tanstack-db	Router/entry point with routing table
tanstack-db/live-queries	Reactive queries, joins, aggregations
tanstack-db/mutations	Optimistic updates, transactions, paced mutations
tanstack-db/collections	QueryCollection, ElectricCollection, sync modes
tanstack-db/schemas	Validation, transformations, TInput/TOutput
tanstack-db/electric	ElectricSQL integration, txid matching

Each skill includes:

• SKILL.md - Common patterns and routing table
• references/ - Deep-dive documentation for specialized topics

For AI Agents

Point your agent to the skills directory or use the CLI to fetch specific skills:

# Get the main routing skill
npx @tanstack/db-playbook show tanstack-db

# Get specific domain skills
npx @tanstack/db-playbook show tanstack-db/live-queries

The router skill (tanstack-db) contains a routing table that helps agents find the right sub-skill for any task.

Learn More

• TanStack DB Documentation
• TanStack DB GitHub