Tursodb Kb

The local KB is built from tracked markdown, currently centered on paths such as:

• docs/plan/**/*.md
• docs/report/*.md
• docs/specs/*.md

If a paper, note, or extracted result should become searchable, convert or summarize it into tracked markdown first, then sync that markdown into the KB. Do not claim that tursodb ingests PDFs directly.

Query Modes

Choose the narrowest command that matches the retrieval need.

Maintenance Commands

Use maintenance commands only when the indexed markdown set has changed or when the KB is missing.

1. Full rebuild — devenv shell -- rebuild-kb
   • Recreates .turso/knowledge.db from the tracked markdown sources.
2. Incremental update — devenv shell -- sync-kb [path ...]
   • Upserts tracked markdown changes and removes tracked rows for deleted paths covered by the sync flow.

Workflow

1. Start with KB lookup before broad manual scans of docs/.
2. Pick the query mode that best matches the task:
   • hybrid first for general exploration
   • FTS when exact wording matters
   • vector when concepts matter more than keywords
3. Read the referenced markdown file directly before making any non-trivial claim.
4. If your new markdown should be discoverable later, run sync-kb for the touched file or rebuild-kb when a full refresh is needed.
5. Keep conclusions grounded in the underlying tracked markdown, not just the KB snippet.

Output Contract

When using this skill, return structured retrieval notes with:

• command and query used
• top matching file paths
• the key claim or reason each hit matters
• whether direct file reading is still required
• whether KB maintenance is needed after edits

Stop Conditions

Stop and report instead of guessing when:

• the KB returns no relevant results and the task depends on prior repo docs
• the result snippets conflict and the source markdown needs adjudication
• the KB appears stale and the required markdown has not been synced yet

The correct fallback is to read the relevant tracked markdown directly and, if needed, refresh the KB.