Imported from hotmeme/vault-search (AGENTS.md). Install upstream with npx skills add hotmeme/vault-search. Copyright stays with the author.

AGENTS.md

Read obsidian_lab_notebook_search_spec.md before doing any work. That file is the source of truth.

Project rules:

• Follow the spec closely.
• Do not redesign the architecture unless the spec is ambiguous.
• Implement one milestone at a time.
• Keep diffs small and reviewable.
• Add tests for each milestone.
• Run tests/lint/typecheck before stopping.
• After each milestone, summarize:
  1. what was implemented
  2. what files changed
  3. what remains
  4. any ambiguities or risks

Important product constraints:

• This is a note retriever, not a chatbot.
• Chunk-level retrieval, note-level return.
• Use QMD as the retrieval engine, wrapped by our code.
• Daily note filename date is authoritative.
• Exclude Excalidraw/, images/, and templates/.
• Do not let many mediocre matches reliably outrank one strong relevant chunk. Oftentimes we are looking for one single note that is the true hit.
• CLI first; tiny local web app later.