schema: spec-driven

context: |
  Tech stack: Python 3.11+, Click (CLI), SQLite (FTS5 + sqlite-vec), Docling, sentence-transformers
  Distribution: pipx (PyPI package name: kb-search, CLI entry point: kb)
  Storage: Single SQLite database at ~/.kb/kb.db
  Config: TOML at ~/.kb/config.toml with ENV overrides
  Domain: CLI knowledge base / retrieval engine for personal document search
  Primary consumer: Claude Code skills (JSON output), secondary: human terminal use
  Local-first: no cloud dependencies, embedding models downloaded from HuggingFace on init