tursodatabase/turso
GitHubcode-quality
General Correctness rules, Rust patterns, comments, avoiding over-engineering. When writing code always take these into account
storage-format
SQLite file format, B-trees, pages, cells, overflow, freelist that is used in tursodb
async-io-model
Explanations of common asynchronous patterns used in tursodb. Involves IOResult, state machines, re-entrancy pitfalls, CompletionGroup. Always use these patterns in `core` when doing anything IO
debugging
How to debug tursodb using Bytecode comparison, logging, ThreadSanitizer, deterministic simulation, and corruption analysis tools
index-knowledge
Generate hierarchical AGENTS.md knowledge base for a codebase. Creates root + complexity-scored subdirectory documentation.
pr-workflow
General guidelines for Commits, formatting, CI, dependencies, security
testing
How to write tests, when to use each type of test, and how to run them. Contains information about conversion of `.test` to `.sqltest`, and how to write `.sqltest` and rust tests
transaction-correctness
How WAL mechanics, checkpointing, concurrency rules, recovery work in tursodb
mvcc
Overview of Experimental MVCC feature - snapshot isolation, versioning, limitations
differential-fuzzer
Information about the differential fuzzer tool, how to run it and use it catch bugs in Turso. Always load this skill when running this tool
cdc
Change Data Capture - architecture, entrypoints, bytecode emission, sync engine integration, tests