Wiki Query — Knowledge Retrieval You are answering questions against a compiled Obsidian wiki, not raw source documents. The wiki contains pre-synthesized, cross-referenced knowledge. This skill is READ-ONLY answers questions. It MUST NOT create or modify any wiki content. The ONLY write it may perform is the single Step 6 append to . Never, even when a change seems obviously helpful: - create or edit pages under , , , , , , or - modify , , , or If the user's message contains a new finding, an action request ("save this", "ban X", "record that"), or anything implying a change, do not perform…

lex: \u003ckey terms>\\nvec: \u003cquestion rephrased as a description>' -c \"$QMD_WIKI_COLLECTION\" -n 8 --files\n ```\n- `balanced`: hybrid search without LLM reranking; use when `quality` is too slow.\n ```bash\n ${QMD_CLI:-qmd} query

Wiki Query — Knowledge Retrieval You are answering questions against a compiled Obsidian wiki, not raw source documents. The wiki contains pre-synthesized, cross-referenced knowledge. This skill is READ-ONLY answers questions. It MUST NOT create or modify any wiki content. The ONLY write it may perform is the single Step 6 append to . Never, even when a change seems obviously helpful: - create or edit pages under , , , , , , or - modify , , , or If the user's message contains a new finding, an action request ("save this", "ban X", "record that"), or anything implying a change, do not perform…

lex: \u003ckey terms>\\nvec: \u003cquestion rephrased as a description>' -c \"$QMD_WIKI_COLLECTION\" -n 8 --no-rerank --files\n ```\n- `fast`: semantic-only recall, or `search` instead when exact names, file paths, or error messages matter.\n ```bash\n ${QMD_CLI:-qmd} vsearch \"\u003cquestion rephrased as a description>\" -c \"$QMD_WIKI_COLLECTION\" -n 8 --files\n ```\n\nUse `${QMD_CLI:-qmd} get \"#docid\"` to retrieve a ranked document by docid when CLI output provides one.\n\nThe returned snippets or ranked files act as pre-read section summaries. If they answer the question fully, skip Step 3 and go straight to Step 4 (reading only the pages QMD ranked highest). If not, use the ranked file list to guide which files to grep or read in Step 3.\n\nFold QMD hits into the same `candidates_seen` count from Step 2 (dedupe by path — a page found by both frontmatter grep and QMD counts once).\n\n**Defensive filter: drop any `_raw/` path from wiki-collection results.** The wiki collection is supposed to index only compiled pages, but a misconfigured collection (see `.env.example`) can end up indexing `_raw/` — including stale drafts sitting in `_raw/_archived/` that were already superseded by a promoted page. Before using a QMD hit from `$QMD_WIKI_COLLECTION`, check its path: if it contains `_raw/`, discard it from the wiki-collection result set (it may still surface legitimately via `$QMD_PAPERS_COLLECTION`, cited as a raw source). This keeps a misconfigured collection degrading to \"missing recall\" rather than \"silently citing a superseded draft as compiled knowledge.\" If you see `_raw/` paths coming back from the wiki collection, mention it in your working update so the user knows their collection scope needs fixing (see `.env.example` QMD section).\n\n**Also search `papers` when the question may have source material in `_raw/`:**\n\nIf `QMD_PAPERS_COLLECTION` is set and the user is asking about a topic likely covered by ingested papers (research, theory, background), run a parallel search against the papers collection. Cite raw sources separately from compiled wiki pages in your answer.\n\n### Step 3: Section Pass (medium cost — only if Steps 2/2b are inconclusive)\n\nFor each of the top candidates, pull the relevant section *without reading the whole page*:\n\n- Use `Grep -A 10 -B 2 \"\u003cquery-term>\" \u003ccandidate-file>` to get just the lines around the match.\n- This usually returns 15–30 lines per hit instead of 100–500.\n- If the section grep gives a clear answer, go straight to Step 5.\n\n### Step 4: Full Read (expensive — last resort)\n\nOnly when Steps 2 and 3 don't answer the question:\n\n- `Read` the top **3** candidates in full. When choosing which 3 to read, apply tier ordering: read `core` pages before `supporting`, and skip `peripheral` pages unless they are the only match.\n- Follow at most one hop of `[[wikilinks]]` from those pages if the answer requires cross-references.\n- **For relationship queries** (\"How does X relate to Y?\" / \"What contradicts X?\"): also read the `relationships:` frontmatter block of the candidate pages. Each entry gives a typed, directional edge (`extends`, `implements`, `contradicts`, `derived_from`, `uses`, `replaces`, `related_to`). Surface these explicitly in your answer — \"Page A *contradicts* Page B (typed edge)\" is more useful than \"Page A links to Page B\".\n- Check \"Open Questions\" sections for known gaps.\n- If you're still short, **then** fall back to a broad content grep across the vault. Tell the user you escalated — this is the expensive path and they should know.\n\n### Step 4b: Multi-hop Graph Traversal (typed edges)\n\nPlain retrieval surfaces pages that *mention* the query terms. It cannot answer **path / multi-hop queries** — \"How is X connected to Y?\", \"What does X depend on transitively?\", \"Trace the chain from X to Z\" — when X and Y never appear on the same page. The answer lives in the *shape* of the typed-edge graph, not in any single page body. This is the step that walks it.\n\nRun this step **only** for path/multi-hop queries (or when a relationship query returns no direct edge between the two pages). It is built entirely from frontmatter — never read page bodies here.\n\n1. **Build the typed-edge adjacency (cheap).** Grep every page's `relationships:` block in one pass — `Grep -A 20 \"^relationships:\" \u003cvault>/**/*.md` (frontmatter only). Each entry yields a directed, typed edge `source —type→ target`. Add the reverse direction as a traversable edge too (mark it `(reverse)`), since \"connected to\" is symmetric even though the typed assertion is directional. Plain body `[[wikilinks]]` count as untyped `related_to` edges only if you need them to complete a path — prefer typed edges first.\n\n2. **Locate the endpoints.** Resolve X (and Y, if the query names two) to page paths using the registry from Step 2. If an endpoint is ambiguous, pick the `tier: core` candidate and note the assumption.\n\n3. **Bounded BFS.** If `obsidian-wiki` is installed, let the CLI do the walk over the wikilink graph first — it is exact and instant:\n\n ```bash\n obsidian-wiki graph-analyse \"$OBSIDIAN_VAULT_PATH\" --path \"\u003cX>\" \"\u003cY>\" # two-endpoint: shortest chain + hop count\n obsidian-wiki graph-analyse \"$OBSIDIAN_VAULT_PATH\" --around \"\u003cX>\" --depth 3 [--direction out|in] # one-endpoint: reachable pages by hop\n ```\n\n `--path` follows links in either direction unless `--direction out`; `--around --direction in` answers \"what depends on X\" (its blast radius). Then decorate the returned chain with the typed edges from step 1 (the CLI sees `[[wikilinks]]`, not relationship types). Otherwise, or to find alternate paths, walk manually:\n - **Max depth 3 hops** by default (the connection is rarely meaningful beyond that). Raise to 4 only if the user says \"deep\" / \"however many hops it takes\".\n - **Frontier cap:** stop expanding a node once the visited set exceeds ~60 pages — report partial results rather than fanning out across the whole vault.\n - For a **two-endpoint query** (X→Y): stop as soon as you find the shortest path; then continue briefly to surface up to 2 alternate paths if they exist.\n - For a **one-endpoint query** (X transitively): collect all nodes reachable within the depth limit, grouped by hop distance.\n\n4. **Report the path(s) with edge types.** Show the chain, not just the endpoints — the typed edges *are* the answer:\n\n ```\n [[concepts/transformers]] —uses→ [[concepts/attention]] —derived_from→ [[concepts/rnn-seq2seq]] —contradicts (reverse)→ [[concepts/lstm]]\n ```\n\n State the hop count and whether any hop is a `(reverse)` traversal or an untyped `related_to` fallback (those chains are weaker — flag them). If no path exists within the depth limit, say so explicitly: \"No typed-edge path from X to Y within 3 hops — they are in disconnected regions of the graph.\" That is itself a useful finding (a graph gap).\n\n**Cost guard:** this step reads only frontmatter via grep. If the adjacency grep returns nothing (no page uses `relationships:` yet), report that the graph has no typed edges to traverse and suggest running `cross-linker` to populate them, then fall back to ordinary one-hop retrieval.\n\n### Step 5: Synthesize an Answer\n\nCompose your answer from wiki content:\n- Cite specific wiki pages using `[[page-name]]` notation\n- Note which step the answer came from (\"found in summary\" vs \"grepped section\" vs \"full page read\") — helps the user understand confidence\n- If the wiki has contradictions, present both sides\n- If the wiki doesn't cover something, say so explicitly\n- Suggest which sources might fill the gap\n\n**Page trust annotations:** For every page cited in your answer, check its `lifecycle` frontmatter and compute `is_stale = (today − updated) > 90 days`. Annotate risky pages inline so the user knows which citations to verify:\n\n| Condition | Annotation |\n|---|---|\n| `lifecycle: archived` | `(ARCHIVED: superseded by [[target]])` — use the successor instead |\n| `lifecycle: disputed` | `(DISPUTED, marked \u003clifecycle_changed>: \u003clifecycle_reason or \"reason unspecified\">)` |\n| `is_stale` + `lifecycle: verified` | `(VERIFIED but stale: last updated \u003cupdated>)` — reader should re-verify before relying |\n| `is_stale` (other lifecycle) | `(stale: last updated \u003cupdated>)` |\n\nExamples in a synthesized answer:\n```\n[[concept-page]] (stale: last updated 2026-01-15) — Original claim was X.\n[[verified-page]] (VERIFIED but stale: last updated 2025-09-10) — Reader should reverify before relying.\n[[disputed-page]] (DISPUTED, marked 2026-04-30: contradicted by [[new-source]]) — Earlier said Y, now uncertain.\n[[old-page]] (ARCHIVED: superseded by [[new-page]]) — Use the successor.\n```\n\nPages with no lifecycle field (legacy pages predating the schema) are treated the same as `draft` — annotate if stale, skip otherwise. Never fabricate a `lifecycle_reason`; if the field is absent, omit the reason from the annotation.\n\n**Surface the project source location (project-scoped queries).** When the cited pages are project-scoped — their path is under `projects/\u003cname>/...`, or their frontmatter carries a `source_path`/`source_repo` field — resolve where the actual code lives so a proposed fix can name real files and a follow-up turn can edit them:\n\n1. Read `$OBSIDIAN_VAULT_PATH/.manifest.json` and look up `.projects.\u003cname>.source_repo` — this is the **authoritative, machine-independent** identity (e.g. `github.com/owner/name`). It is what you report.\n2. Resolve a local checkout root by trying these in order and stopping at the first that exists: `.projects.\u003cname>.source_cwd_hint` (a `~`-relative hint), then a legacy `.projects.\u003cname>.source_cwd` (an absolute path, older manifests only), then the page's `source_path` frontmatter. Expand `~` in any candidate and confirm the directory actually exists before using it. A legacy absolute path is used only as a local convenience — never reported as the project's identity.\n\nReport the **`Source code:`** line using `source_repo`. When a local checkout resolved in step 2, append the concrete path so the reader can act on it (e.g. `\u003crepo> — local checkout at ~/code/name/public/lib/anticheat.js`). When the query implies a code fix is wanted and a local checkout exists, name the specific files to edit and **offer to implement it as an explicit, separate next step** — but never edit during the query itself (see the READ-ONLY guard above). If no local checkout resolves, report the repo and say the code is not checked out on this machine.\n\n**Challenge queries.** The job is to argue with the user using their own notes, not to be agreeable. Run the normal retrieval on the idea's topic, then search further for:\n- earlier decisions on the same question, especially ones that went the other way (`synthesis/`, `projects/`, pages with \"decision\", \"decided\", \"chose\", \"rejected\", \"won't do\");\n- things that failed or were rolled back: post-mortems, \"gotcha\", \"broke\", \"reverted\", `lifecycle: disputed` or `archived` pages, `contradicts` relationships;\n- open questions and constraints the idea would run into.\n\nLead the answer with the strongest counter-evidence, each point quoted or closely paraphrased with its `[[page]]` and date, e.g. *\"[[synthesis/rust-rewrite]] (2025-11-02) says the rewrite was abandoned over build times. What is different now?\"* Then list what the vault says in favour, if anything. End with one or two questions the user should answer before going ahead. If the vault holds nothing against the idea, say so plainly. Never invent an objection the notes don't support: an empty challenge is a useful answer.\n\n### Step 6: Log the Query\n\nThis is the *only* write this skill performs — do not edit anything else, and do not append to `log.md` by hand:\n\n```bash\nobsidian-wiki memory log QUERY \\\n query=\"the user's question\" result_pages=\u003cN> \\\n mode=\u003cnormal|index_only|filtered> escalated=\u003ctrue|false> \\\n candidates_seen=\u003cN> candidates_used=\u003cN> dropped=\u003cN>\n```\n\nThe command takes the memory lock and appends one parseable line; it never touches `index.md` or `hot.md`.\n\nUse the counts tracked since Step 2. If a count wasn't tracked (e.g. index-only mode never built a full candidate set), write `0` rather than omitting the field — the log format should stay parseable.\n\n## Answer Format\n\nStructure answers like this:\n\n> **Based on the wiki:**\n>\n> [Your synthesized answer with [[wikilinks]] to source pages]\n>\n> **Pages consulted:** [[page-a]], [[page-b]], [[page-c]]\n>\n> **Gaps:** [What the wiki doesn't cover that might be relevant]\n>\n> **Retrieval:** N candidates seen, M read, D dropped (untouched matches, if any: [[page-d]], [[page-e]])\n>\n> **Source code:** `\u003csource_repo>` (local checkout at `~/code/\u003cname>`) — to implement, the relevant files are `…`.\n> (Say the word and I'll switch out of query mode to make the change.)\n\nThe **Source code** line is optional — include it only for project-scoped queries where you resolved a `source_repo` (see Step 5). Report the repository, not a machine absolute path; add the local checkout path only when it actually exists on this machine.\n\nThe **Retrieval** line is always included — it's the transparency report from the counts tracked since Step 2 (mirrors the `candidates_seen`/`candidates_used`/`dropped` fields logged in Step 6). In index-only mode, report the counts from the frontmatter scan; if D is 0, drop the parenthetical rather than writing an empty list.","attachment_filenames":[],"attachments":[],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Wiki Query — Knowledge Retrieval","type":"text"}]},{"type":"paragraph","content":[{"text":"You are answering questions against a compiled Obsidian wiki, not raw source documents. The wiki contains pre-synthesized, cross-referenced knowledge.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"This skill is READ-ONLY","type":"text"}]},{"type":"paragraph","content":[{"text":"wiki-query","type":"text","marks":[{"type":"code_inline"}]},{"text":" answers questions. It MUST NOT create or modify any wiki content. The ONLY write it may perform is the single Step 6 append to ","type":"text"},{"text":"log.md","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Never, even when a change seems obviously helpful:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"create or edit pages under ","type":"text"},{"text":"concepts/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"entities/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"skills/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"references/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"synthesis/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"journal/","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"projects/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"modify ","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"hot.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"_insights.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":".manifest.json","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"If the user's message contains a new finding, an action request (\"save this\", \"ban X\", \"record that\"), or anything implying a change, ","type":"text"},{"text":"do not perform it.","type":"text","marks":[{"type":"strong"}]},{"text":" Answer the question, PROPOSE the change, and route the user to the right skill:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"quick note / gotcha → ","type":"text"},{"text":"wiki-capture --quick","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"a full new page → ","type":"text"},{"text":"wiki-capture","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"a project-knowledge sync → ","type":"text"},{"text":"wiki-update","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Before You Start","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Resolve config","type":"text","marks":[{"type":"strong"}]},{"text":" — follow the Config Resolution Protocol in ","type":"text"},{"text":"llm-wiki/SKILL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" (inline ","type":"text"},{"text":"@name","type":"text","marks":[{"type":"code_inline"}]},{"text":" override → walk up CWD for ","type":"text"},{"text":".env","type":"text","marks":[{"type":"code_inline"}]},{"text":" → global config → prompt setup). For cross-project queries without ","type":"text"},{"text":"@name","type":"text","marks":[{"type":"code_inline"}]},{"text":", prefer the global config when present, even if it is a symlink to the vault ","type":"text"},{"text":".env","type":"text","marks":[{"type":"code_inline"}]},{"text":". This gives ","type":"text"},{"text":"OBSIDIAN_VAULT_PATH","type":"text","marks":[{"type":"code_inline"}]},{"text":" and any QMD variables. Works from any project directory.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Load QMD settings from the resolved config","type":"text","marks":[{"type":"strong"}]},{"text":" before deciding retrieval strategy. If ","type":"text"},{"text":"QMD_WIKI_COLLECTION","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set, treat QMD as available subject only to transport/tool checks below. If it is empty or unset, say briefly why QMD is being skipped before using grep/page reads.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"$OBSIDIAN_VAULT_PATH/hot.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" exists, read it first — it gives you instant context on recent activity. If the user's question is about something ingested recently, hot.md may answer it before you even open ","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"$OBSIDIAN_VAULT_PATH/index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" to understand the wiki's scope and structure","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Visibility Filter (optional)","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, ","type":"text"},{"text":"all pages are returned","type":"text","marks":[{"type":"strong"}]},{"text":" regardless of visibility tags. This preserves existing behavior — nothing changes unless the user asks for it.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the user's query includes phrases like ","type":"text"},{"text":"\"public only\"","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"\"user-facing\"","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"\"no internal content\"","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"\"as a user would see it\"","type":"text","marks":[{"type":"strong"}]},{"text":", or ","type":"text"},{"text":"\"exclude internal\"","type":"text","marks":[{"type":"strong"}]},{"text":", activate ","type":"text"},{"text":"filtered mode","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Build a ","type":"text"},{"text":"blocked tag set","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"{visibility/internal, visibility/pii}","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"In the Index Pass (Step 2), skip any candidate whose frontmatter tags contain a blocked tag","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"In Section/Full Read passes (Steps 3–4), do not read or cite any blocked page","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Synthesize the answer ","type":"text"},{"text":"only from allowed pages","type":"text","marks":[{"type":"strong"}]},{"text":" — do not mention that excluded pages exist","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Pages with no ","type":"text"},{"text":"visibility/","type":"text","marks":[{"type":"code_inline"}]},{"text":" tag, or tagged ","type":"text"},{"text":"visibility/public","type":"text","marks":[{"type":"code_inline"}]},{"text":", are always included.","type":"text"}]},{"type":"paragraph","content":[{"text":"In filtered mode, note the filter in the Step 6 log entry: ","type":"text"},{"text":"mode=filtered","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Retrieval Protocol","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow the Retrieval Primitives table in ","type":"text","marks":[{"type":"strong"}]},{"text":"llm-wiki/SKILL.md","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":".","type":"text","marks":[{"type":"strong"}]},{"text":" Reading is the dominant cost of this skill — use the cheapest primitive that answers the question and escalate only when it can't. Never jump straight to full-page reads.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 0: GraphRAG Pre-pass (fast index query — no page reads)","type":"text"}]},{"type":"paragraph","content":[{"text":"Before opening any pages, query the compiled graph index:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"obsidian-wiki graph-query \"$OBSIDIAN_VAULT_PATH\" \"\u003cquestion>\" --pretty","type":"text"}]},{"type":"paragraph","content":[{"text":"Output fields:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"answer_type","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": ","type":"text"},{"text":"direct","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"path","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"list","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"gap","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"impact","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"bridges","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"hubs","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"clusters","type":"text","marks":[{"type":"code_inline"}]},{"text":" | ","type":"text"},{"text":"surprising","type":"text","marks":[{"type":"code_inline"}]},{"text":" — shapes what to do next. The last five are ","type":"text"},{"text":"structural intents","type":"text","marks":[{"type":"strong"}]},{"text":": the question is about the shape of the vault, and the answer comes back fully computed in ","type":"text"},{"text":"graph","type":"text","marks":[{"type":"code_inline"}]},{"text":" (see below) with no page reads at all.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"graph","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": present only for structural intents — the computed answer. ","type":"text"},{"text":"null","type":"text","marks":[{"type":"code_inline"}]},{"text":" otherwise.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"candidates","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": top-ranked pages by title/tag/summary match + degree, with scores and summaries","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"should_read","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": the pages most worth opening — start here instead of speculatively reading many files","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"path","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": for multi-hop queries, the shortest wikilink path between the two concepts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"god_nodes_relevant","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": hub pages related to your query terms — always useful context","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"index_only","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": if ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code_inline"}]},{"text":", the top candidate's summary already answers the question — skip page reads","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"temporal","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":": ","type":"text"},{"text":"as_of","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"retrievable","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"excluded_historical","type":"text","marks":[{"type":"code_inline"}]},{"text":" — how many pages the event-time filter held back (see below)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Structural intents","type":"text","marks":[{"type":"strong"}]},{"text":" — these are answered entirely from the graph. The user's phrasing routes automatically:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The user asks","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"answer_type","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"graph","type":"text","marks":[{"type":"code_inline"}]},{"text":" contains","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"what breaks if I delete X\" / \"what depends on X\" / \"what links to X\"","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"impact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"direct_dependents","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"transitive_dependents","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"total","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"which pages bridge my clusters\" / \"what would fragment my vault\"","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"bridges","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"pages by betweenness, with ","type":"text"},{"text":"label","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"connects_labels","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"what's central\" / \"top hubs\" / \"my main topics\"","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"hubs","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"pages by degree, with in/out split","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"what clusters do I have\" / \"how is my wiki organised\"","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"clusters","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"each cluster's ","type":"text"},{"text":"label","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"size","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"cohesion","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"fragmented","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"surprising connections\" / \"unexpected links\"","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"surprising","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"cross-cluster links, rarest first","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Report the ","type":"text"},{"text":"graph","type":"text","marks":[{"type":"code_inline"}]},{"text":" payload directly — do ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" re-derive it by reading pages. If a structural question names a page that can't be resolved, the CLI falls back to ","type":"text"},{"text":"direct","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"graph","type":"text","marks":[{"type":"code_inline"}]},{"text":" is ","type":"text"},{"text":"null","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Decision tree:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"graph","type":"text","marks":[{"type":"code_inline"}]},{"text":" is non-null → the structural answer is complete. Report it and stop; no page reads.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"index_only: true","type":"text","marks":[{"type":"code_inline"}]},{"text":" → answer directly from ","type":"text"},{"text":"candidates[0].summary","type":"text","marks":[{"type":"code_inline"}]},{"text":". Skip Steps 1–4, go to Step 5.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"answer_type == \"path\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"path","type":"text","marks":[{"type":"code_inline"}]},{"text":" is non-empty → the connection is in ","type":"text"},{"text":"path","type":"text","marks":[{"type":"code_inline"}]},{"text":". Read only those pages.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Otherwise → open only ","type":"text"},{"text":"should_read","type":"text","marks":[{"type":"code_inline"}]},{"text":" pages (not all candidates). This replaces the speculative 5–10 page reads the old flow required.","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"The graph used here excludes vault bookkeeping files (","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"log.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"hot.md","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"_insights.md","type":"text","marks":[{"type":"code_inline"}]},{"text":"). They link to nearly every page, so including them made any two pages look ~2 hops apart and produced meaningless ","type":"text"},{"text":"A → index → B","type":"text","marks":[{"type":"code_inline"}]},{"text":" paths.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Event time.","type":"text","marks":[{"type":"strong"}]},{"text":" Pages may carry ","type":"text"},{"text":"valid_from","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"valid_until","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"superseded_by","type":"text","marks":[{"type":"code_inline"}]},{"text":" frontmatter. A page whose ","type":"text"},{"text":"valid_until","type":"text","marks":[{"type":"code_inline"}]},{"text":" has passed is ","type":"text"},{"text":"historical","type":"text","marks":[{"type":"strong"}]},{"text":": it stays in the vault and in the graph, but drops out of ","type":"text"},{"text":"candidates","type":"text","marks":[{"type":"code_inline"}]},{"text":" by default, so \"which X do we use?\" answers with what is true ","type":"text"},{"text":"now","type":"text","marks":[{"type":"em"}]},{"text":" rather than whatever was written first.","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"When ","type":"text"},{"text":"temporal.excluded_historical","type":"text","marks":[{"type":"code_inline"}]},{"text":" is non-zero, say so if it is material to the answer — the user may be asking about the superseded state.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the question is about the past (\"what did we use in 2025\", \"before the migration\"), re-run with ","type":"text"},{"text":"--as-of YYYY-MM-DD","type":"text","marks":[{"type":"code_inline"}]},{"text":" to retrieve what held then.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"--include-historical","type":"text","marks":[{"type":"code_inline"}]},{"text":" when the user explicitly wants the whole history, or when you are tracing how a decision changed.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"A returned candidate carrying ","type":"text"},{"text":"superseded_by","type":"text","marks":[{"type":"code_inline"}]},{"text":" names its replacement — follow it rather than reporting the stale claim as current.","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"obsidian-wiki graph-query \"$OBSIDIAN_VAULT_PATH\" \"\u003cquestion>\" --as-of 2025-06-01 --pretty\nobsidian-wiki graph-query \"$OBSIDIAN_VAULT_PATH\" \"\u003cquestion>\" --include-historical --pretty","type":"text"}]},{"type":"paragraph","content":[{"text":"The structural intents ignore this filter on purpose: deleting a page still breaks the historical pages that link to it, so a blast radius must not shrink just because a dependent is no longer current.","type":"text"}]},{"type":"paragraph","content":[{"text":"Fallback","type":"text","marks":[{"type":"strong"}]},{"text":" (if ","type":"text"},{"text":"obsidian-wiki","type":"text","marks":[{"type":"code_inline"}]},{"text":" is not installed): proceed with Step 1 as normal using grep and index.md.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1: Understand the Question","type":"text"}]},{"type":"paragraph","content":[{"text":"Classify the query type:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Factual lookup","type":"text","marks":[{"type":"strong"}]},{"text":" — \"What is X?\" → Find the relevant page(s)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Relationship query","type":"text","marks":[{"type":"strong"}]},{"text":" — \"How does X relate to Y?\" / \"What contradicts X?\" → Find both pages, their cross-references, and their ","type":"text"},{"text":"relationships:","type":"text","marks":[{"type":"code_inline"}]},{"text":" frontmatter blocks for typed edges","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Path / multi-hop query","type":"text","marks":[{"type":"strong"}]},{"text":" — \"How is X connected to Y?\" / \"What links X to Y?\" / \"Trace the chain from X to Z\" / \"What does X depend on transitively?\" → X and Y don't link directly; the connection runs through intermediate pages. Use the multi-hop graph traversal in Step 4b.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Synthesis query","type":"text","marks":[{"type":"strong"}]},{"text":" — \"What's the current thinking on X?\" → Find all pages that touch X, synthesize","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Gap query","type":"text","marks":[{"type":"strong"}]},{"text":" — \"What don't I know about X?\" → Find what's missing, check open questions sections","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Challenge query","type":"text","marks":[{"type":"strong"}]},{"text":" — \"challenge this\" / \"argue against X\" / \"poke holes in my plan\" / \"what did I decide about X?\" → The user is about to commit to something. Look for the vault's own evidence ","type":"text"},{"text":"against","type":"text","marks":[{"type":"em"}]},{"text":" it. See \"Challenge queries\" under Step 5.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Also decide the ","type":"text"},{"text":"mode","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Index-only mode","type":"text","marks":[{"type":"strong"}]},{"text":" — triggered by \"quick answer\", \"just scan\", \"don't read the pages\", \"fast lookup\". Stops at Step 3. Answers from frontmatter + ","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" only.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Normal mode","type":"text","marks":[{"type":"strong"}]},{"text":" — the full tiered pipeline below.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2: Index Pass (cheap)","type":"text"}]},{"type":"paragraph","content":[{"text":"Build a candidate set ","type":"text"},{"text":"without opening any page bodies","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"You've already read ","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" above — use it as the first filter. It lists every page with a one-line description and tags.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"Grep","type":"text","marks":[{"type":"code_inline"}]},{"text":" to scan page ","type":"text"},{"text":"frontmatter only","type":"text","marks":[{"type":"strong"}]},{"text":" for title, tag, alias, and summary matches. A pattern like ","type":"text"},{"text":"^(title|tags|aliases|summary):","type":"text","marks":[{"type":"code_inline"}]},{"text":" scoped to vault ","type":"text"},{"text":".md","type":"text","marks":[{"type":"code_inline"}]},{"text":" files is far cheaper than content grep.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Collect the top 5–10 candidate page paths ranked by:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Exact title or alias match","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tag match","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Summary field contains the query term","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" entry contains the query term","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Apply tier ordering within each rank bucket:","type":"text","marks":[{"type":"strong"}]},{"text":" when two candidates score equally, prefer ","type":"text"},{"text":"tier: core","type":"text","marks":[{"type":"code_inline"}]},{"text":" over ","type":"text"},{"text":"tier: supporting","type":"text","marks":[{"type":"code_inline"}]},{"text":" over ","type":"text"},{"text":"tier: peripheral","type":"text","marks":[{"type":"code_inline"}]},{"text":". Read the ","type":"text"},{"text":"tier:","type":"text","marks":[{"type":"code_inline"}]},{"text":" frontmatter field with the same cheap grep as other fields. Pages without a ","type":"text"},{"text":"tier:","type":"text","marks":[{"type":"code_inline"}]},{"text":" field are treated as ","type":"text"},{"text":"supporting","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Track retrieval counts as you go (for the transparency report in Step 5/6):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"candidates_seen","type":"text","marks":[{"type":"code_inline"}]},{"text":" — total distinct pages that matched ","type":"text"},{"text":"any","type":"text","marks":[{"type":"em"}]},{"text":" rank criterion above, before trimming to the top 5–10.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"candidates_used","type":"text","marks":[{"type":"code_inline"}]},{"text":" — how many of those you actually carried forward into Steps 3/4.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"dropped","type":"text","marks":[{"type":"code_inline"}]},{"text":" — ","type":"text"},{"text":"candidates_seen − candidates_used","type":"text","marks":[{"type":"code_inline"}]},{"text":", i.e. matches that existed but were never read. If this is non-zero, name the dropped pages (or the count if there are many) so the user knows retrieval wasn't exhaustive — this is not an error, just an honest accounting of what was left out.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If you're in ","type":"text"},{"text":"index-only mode","type":"text","marks":[{"type":"strong"}]},{"text":", stop here. Answer from ","type":"text"},{"text":"summary:","type":"text","marks":[{"type":"code_inline"}]},{"text":" fields, titles, and ","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" descriptions only. Label the answer clearly: ","type":"text"},{"text":"\"(index-only answer — page bodies not read; facts below are from page summaries and may miss nuance)\"","type":"text","marks":[{"type":"strong"}]},{"text":". Then skip to Step 5.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2b: QMD Semantic Pass (optional — requires ","type":"text"},{"text":"QMD_WIKI_COLLECTION","type":"text","marks":[{"type":"code_inline"}]},{"text":" in resolved config)","type":"text"}]},{"type":"paragraph","content":[{"text":"GUARD: If ","type":"text","marks":[{"type":"strong"}]},{"text":"$QMD_WIKI_COLLECTION","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" is empty or unset after config resolution, skip this entire step and proceed to Step 3. Mention the missing variable in your working update.","type":"text","marks":[{"type":"strong"}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"No QMD?","type":"text","marks":[{"type":"strong"}]},{"text":" Skip to Step 3 and use ","type":"text"},{"text":"Grep","type":"text","marks":[{"type":"code_inline"}]},{"text":" directly on the vault. QMD is faster and concept-aware but the grep path is fully functional. See ","type":"text"},{"text":".env.example","type":"text","marks":[{"type":"code_inline"}]},{"text":" for setup.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"QMD_WIKI_COLLECTION","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set, run QMD before reaching for ","type":"text"},{"text":"Grep","type":"text","marks":[{"type":"code_inline"}]},{"text":" unless the question is already fully answered by ","type":"text"},{"text":"hot.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" metadata. QMD is especially preferred when the question is semantic, project-specific, asks for related context, or uses terms that may not appear verbatim in titles/frontmatter.","type":"text"}]},{"type":"paragraph","content":[{"text":"Choose the QMD transport from ","type":"text"},{"text":"$QMD_TRANSPORT","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"mcp","type":"text","marks":[{"type":"code_inline"}]},{"text":" (default): use the QMD MCP tool configured in the agent.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"cli","type":"text","marks":[{"type":"code_inline"}]},{"text":": run the local qmd CLI. Use ","type":"text"},{"text":"$QMD_CLI","type":"text","marks":[{"type":"code_inline"}]},{"text":" if set; otherwise use ","type":"text"},{"text":"qmd","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For detailed CLI command selection, maintenance, and VM caveats, use the local ","type":"text"},{"text":"$qmd-cli","type":"text","marks":[{"type":"code_inline"}]},{"text":" skill when it is installed.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the selected transport is unavailable (no MCP tool, ","type":"text"},{"text":"qmd","type":"text","marks":[{"type":"code_inline"}]},{"text":" not on PATH, or the command errors), skip QMD and continue with Step 3.","type":"text"}]},{"type":"paragraph","content":[{"text":"For MCP transport:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"mcp__qmd__query:\n collection: \u003cQMD_WIKI_COLLECTION> # e.g. \"knowledge-base-wiki\"\n intent: \u003cthe user's question>\n searches:\n - type: lex # keyword match — good for exact names, file paths, error messages\n query: \u003ckey terms>\n - type: vec # semantic match — good for concepts, patterns, \"what is X like\"\n query: \u003cquestion rephrased as a description>","type":"text"}]},{"type":"paragraph","content":[{"text":"For CLI transport, pick the command from ","type":"text"},{"text":"$QMD_CLI_SEARCH_MODE","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"Keep operator-like or punctuation-heavy tokens such as ","type":"text"},{"text":"no-sudo","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"ansible_become=false","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"~/.local/bin","type":"text","marks":[{"type":"code_inline"}]},{"text":" in the ","type":"text"},{"text":"lex:","type":"text","marks":[{"type":"code_inline"}]},{"text":" line. Rewrite the ","type":"text"},{"text":"vec:","type":"text","marks":[{"type":"code_inline"}]},{"text":" line as plain natural language without hyphenated ","type":"text"},{"text":"-term","type":"text","marks":[{"type":"code_inline"}]},{"text":" words; QMD treats ","type":"text"},{"text":"-term","type":"text","marks":[{"type":"code_inline"}]},{"text":" as negation, and negation is not supported in ","type":"text"},{"text":"vec","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"hyde","type":"text","marks":[{"type":"code_inline"}]},{"text":" queries.","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"quality","type":"text","marks":[{"type":"code_inline"}]},{"text":" (default): best relevance; slower on CPU.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"${QMD_CLI:-qmd} query

Wiki Query — Knowledge Retrieval You are answering questions against a compiled Obsidian wiki, not raw source documents. The wiki contains pre-synthesized, cross-referenced knowledge. This skill is READ-ONLY answers questions. It MUST NOT create or modify any wiki content. The ONLY write it may perform is the single Step 6 append to . Never, even when a change seems obviously helpful: - create or edit pages under , , , , , , or - modify , , , or If the user's message contains a new finding, an action request ("save this", "ban X", "record that"), or anything implying a change, do not perform…

lex: \u003ckey terms>\\nvec: \u003cquestion rephrased as a description>' -c \"$QMD_WIKI_COLLECTION\" -n 8 --files","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"balanced","type":"text","marks":[{"type":"code_inline"}]},{"text":": hybrid search without LLM reranking; use when ","type":"text"},{"text":"quality","type":"text","marks":[{"type":"code_inline"}]},{"text":" is too slow.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"${QMD_CLI:-qmd} query

Wiki Query — Knowledge Retrieval You are answering questions against a compiled Obsidian wiki, not raw source documents. The wiki contains pre-synthesized, cross-referenced knowledge. This skill is READ-ONLY answers questions. It MUST NOT create or modify any wiki content. The ONLY write it may perform is the single Step 6 append to . Never, even when a change seems obviously helpful: - create or edit pages under , , , , , , or - modify , , , or If the user's message contains a new finding, an action request ("save this", "ban X", "record that"), or anything implying a change, do not perform…

lex: \u003ckey terms>\\nvec: \u003cquestion rephrased as a description>' -c \"$QMD_WIKI_COLLECTION\" -n 8 --no-rerank --files","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"fast","type":"text","marks":[{"type":"code_inline"}]},{"text":": semantic-only recall, or ","type":"text"},{"text":"search","type":"text","marks":[{"type":"code_inline"}]},{"text":" instead when exact names, file paths, or error messages matter.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"${QMD_CLI:-qmd} vsearch \"\u003cquestion rephrased as a description>\" -c \"$QMD_WIKI_COLLECTION\" -n 8 --files","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"${QMD_CLI:-qmd} get \"#docid\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" to retrieve a ranked document by docid when CLI output provides one.","type":"text"}]},{"type":"paragraph","content":[{"text":"The returned snippets or ranked files act as pre-read section summaries. If they answer the question fully, skip Step 3 and go straight to Step 4 (reading only the pages QMD ranked highest). If not, use the ranked file list to guide which files to grep or read in Step 3.","type":"text"}]},{"type":"paragraph","content":[{"text":"Fold QMD hits into the same ","type":"text"},{"text":"candidates_seen","type":"text","marks":[{"type":"code_inline"}]},{"text":" count from Step 2 (dedupe by path — a page found by both frontmatter grep and QMD counts once).","type":"text"}]},{"type":"paragraph","content":[{"text":"Defensive filter: drop any ","type":"text","marks":[{"type":"strong"}]},{"text":"_raw/","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" path from wiki-collection results.","type":"text","marks":[{"type":"strong"}]},{"text":" The wiki collection is supposed to index only compiled pages, but a misconfigured collection (see ","type":"text"},{"text":".env.example","type":"text","marks":[{"type":"code_inline"}]},{"text":") can end up indexing ","type":"text"},{"text":"_raw/","type":"text","marks":[{"type":"code_inline"}]},{"text":" — including stale drafts sitting in ","type":"text"},{"text":"_raw/_archived/","type":"text","marks":[{"type":"code_inline"}]},{"text":" that were already superseded by a promoted page. Before using a QMD hit from ","type":"text"},{"text":"$QMD_WIKI_COLLECTION","type":"text","marks":[{"type":"code_inline"}]},{"text":", check its path: if it contains ","type":"text"},{"text":"_raw/","type":"text","marks":[{"type":"code_inline"}]},{"text":", discard it from the wiki-collection result set (it may still surface legitimately via ","type":"text"},{"text":"$QMD_PAPERS_COLLECTION","type":"text","marks":[{"type":"code_inline"}]},{"text":", cited as a raw source). This keeps a misconfigured collection degrading to \"missing recall\" rather than \"silently citing a superseded draft as compiled knowledge.\" If you see ","type":"text"},{"text":"_raw/","type":"text","marks":[{"type":"code_inline"}]},{"text":" paths coming back from the wiki collection, mention it in your working update so the user knows their collection scope needs fixing (see ","type":"text"},{"text":".env.example","type":"text","marks":[{"type":"code_inline"}]},{"text":" QMD section).","type":"text"}]},{"type":"paragraph","content":[{"text":"Also search ","type":"text","marks":[{"type":"strong"}]},{"text":"papers","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" when the question may have source material in ","type":"text","marks":[{"type":"strong"}]},{"text":"_raw/","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":":","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"QMD_PAPERS_COLLECTION","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set and the user is asking about a topic likely covered by ingested papers (research, theory, background), run a parallel search against the papers collection. Cite raw sources separately from compiled wiki pages in your answer.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3: Section Pass (medium cost — only if Steps 2/2b are inconclusive)","type":"text"}]},{"type":"paragraph","content":[{"text":"For each of the top candidates, pull the relevant section ","type":"text"},{"text":"without reading the whole page","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"Grep -A 10 -B 2 \"\u003cquery-term>\" \u003ccandidate-file>","type":"text","marks":[{"type":"code_inline"}]},{"text":" to get just the lines around the match.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"This usually returns 15–30 lines per hit instead of 100–500.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the section grep gives a clear answer, go straight to Step 5.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 4: Full Read (expensive — last resort)","type":"text"}]},{"type":"paragraph","content":[{"text":"Only when Steps 2 and 3 don't answer the question:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Read","type":"text","marks":[{"type":"code_inline"}]},{"text":" the top ","type":"text"},{"text":"3","type":"text","marks":[{"type":"strong"}]},{"text":" candidates in full. When choosing which 3 to read, apply tier ordering: read ","type":"text"},{"text":"core","type":"text","marks":[{"type":"code_inline"}]},{"text":" pages before ","type":"text"},{"text":"supporting","type":"text","marks":[{"type":"code_inline"}]},{"text":", and skip ","type":"text"},{"text":"peripheral","type":"text","marks":[{"type":"code_inline"}]},{"text":" pages unless they are the only match.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Follow at most one hop of ","type":"text"},{"text":"[[wikilinks]]","type":"text","marks":[{"type":"code_inline"}]},{"text":" from those pages if the answer requires cross-references.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For relationship queries","type":"text","marks":[{"type":"strong"}]},{"text":" (\"How does X relate to Y?\" / \"What contradicts X?\"): also read the ","type":"text"},{"text":"relationships:","type":"text","marks":[{"type":"code_inline"}]},{"text":" frontmatter block of the candidate pages. Each entry gives a typed, directional edge (","type":"text"},{"text":"extends","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"implements","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"contradicts","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"derived_from","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"uses","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"replaces","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"related_to","type":"text","marks":[{"type":"code_inline"}]},{"text":"). Surface these explicitly in your answer — \"Page A ","type":"text"},{"text":"contradicts","type":"text","marks":[{"type":"em"}]},{"text":" Page B (typed edge)\" is more useful than \"Page A links to Page B\".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check \"Open Questions\" sections for known gaps.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If you're still short, ","type":"text"},{"text":"then","type":"text","marks":[{"type":"strong"}]},{"text":" fall back to a broad content grep across the vault. Tell the user you escalated — this is the expensive path and they should know.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 4b: Multi-hop Graph Traversal (typed edges)","type":"text"}]},{"type":"paragraph","content":[{"text":"Plain retrieval surfaces pages that ","type":"text"},{"text":"mention","type":"text","marks":[{"type":"em"}]},{"text":" the query terms. It cannot answer ","type":"text"},{"text":"path / multi-hop queries","type":"text","marks":[{"type":"strong"}]},{"text":" — \"How is X connected to Y?\", \"What does X depend on transitively?\", \"Trace the chain from X to Z\" — when X and Y never appear on the same page. The answer lives in the ","type":"text"},{"text":"shape","type":"text","marks":[{"type":"em"}]},{"text":" of the typed-edge graph, not in any single page body. This is the step that walks it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Run this step ","type":"text"},{"text":"only","type":"text","marks":[{"type":"strong"}]},{"text":" for path/multi-hop queries (or when a relationship query returns no direct edge between the two pages). It is built entirely from frontmatter — never read page bodies here.","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Build the typed-edge adjacency (cheap).","type":"text","marks":[{"type":"strong"}]},{"text":" Grep every page's ","type":"text"},{"text":"relationships:","type":"text","marks":[{"type":"code_inline"}]},{"text":" block in one pass — ","type":"text"},{"text":"Grep -A 20 \"^relationships:\" \u003cvault>/**/*.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" (frontmatter only). Each entry yields a directed, typed edge ","type":"text"},{"text":"source —type→ target","type":"text","marks":[{"type":"code_inline"}]},{"text":". Add the reverse direction as a traversable edge too (mark it ","type":"text"},{"text":"(reverse)","type":"text","marks":[{"type":"code_inline"}]},{"text":"), since \"connected to\" is symmetric even though the typed assertion is directional. Plain body ","type":"text"},{"text":"[[wikilinks]]","type":"text","marks":[{"type":"code_inline"}]},{"text":" count as untyped ","type":"text"},{"text":"related_to","type":"text","marks":[{"type":"code_inline"}]},{"text":" edges only if you need them to complete a path — prefer typed edges first.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Locate the endpoints.","type":"text","marks":[{"type":"strong"}]},{"text":" Resolve X (and Y, if the query names two) to page paths using the registry from Step 2. If an endpoint is ambiguous, pick the ","type":"text"},{"text":"tier: core","type":"text","marks":[{"type":"code_inline"}]},{"text":" candidate and note the assumption.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Bounded BFS.","type":"text","marks":[{"type":"strong"}]},{"text":" If ","type":"text"},{"text":"obsidian-wiki","type":"text","marks":[{"type":"code_inline"}]},{"text":" is installed, let the CLI do the walk over the wikilink graph first — it is exact and instant:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"obsidian-wiki graph-analyse \"$OBSIDIAN_VAULT_PATH\" --path \"\u003cX>\" \"\u003cY>\" # two-endpoint: shortest chain + hop count\nobsidian-wiki graph-analyse \"$OBSIDIAN_VAULT_PATH\" --around \"\u003cX>\" --depth 3 [--direction out|in] # one-endpoint: reachable pages by hop","type":"text"}]},{"type":"paragraph","content":[{"text":"--path","type":"text","marks":[{"type":"code_inline"}]},{"text":" follows links in either direction unless ","type":"text"},{"text":"--direction out","type":"text","marks":[{"type":"code_inline"}]},{"text":"; ","type":"text"},{"text":"--around --direction in","type":"text","marks":[{"type":"code_inline"}]},{"text":" answers \"what depends on X\" (its blast radius). Then decorate the returned chain with the typed edges from step 1 (the CLI sees ","type":"text"},{"text":"[[wikilinks]]","type":"text","marks":[{"type":"code_inline"}]},{"text":", not relationship types). Otherwise, or to find alternate paths, walk manually:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Max depth 3 hops","type":"text","marks":[{"type":"strong"}]},{"text":" by default (the connection is rarely meaningful beyond that). Raise to 4 only if the user says \"deep\" / \"however many hops it takes\".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Frontier cap:","type":"text","marks":[{"type":"strong"}]},{"text":" stop expanding a node once the visited set exceeds ~60 pages — report partial results rather than fanning out across the whole vault.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For a ","type":"text"},{"text":"two-endpoint query","type":"text","marks":[{"type":"strong"}]},{"text":" (X→Y): stop as soon as you find the shortest path; then continue briefly to surface up to 2 alternate paths if they exist.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For a ","type":"text"},{"text":"one-endpoint query","type":"text","marks":[{"type":"strong"}]},{"text":" (X transitively): collect all nodes reachable within the depth limit, grouped by hop distance.","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Report the path(s) with edge types.","type":"text","marks":[{"type":"strong"}]},{"text":" Show the chain, not just the endpoints — the typed edges ","type":"text"},{"text":"are","type":"text","marks":[{"type":"em"}]},{"text":" the answer:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"[[concepts/transformers]] —uses→ [[concepts/attention]] —derived_from→ [[concepts/rnn-seq2seq]] —contradicts (reverse)→ [[concepts/lstm]]","type":"text"}]},{"type":"paragraph","content":[{"text":"State the hop count and whether any hop is a ","type":"text"},{"text":"(reverse)","type":"text","marks":[{"type":"code_inline"}]},{"text":" traversal or an untyped ","type":"text"},{"text":"related_to","type":"text","marks":[{"type":"code_inline"}]},{"text":" fallback (those chains are weaker — flag them). If no path exists within the depth limit, say so explicitly: \"No typed-edge path from X to Y within 3 hops — they are in disconnected regions of the graph.\" That is itself a useful finding (a graph gap).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Cost guard:","type":"text","marks":[{"type":"strong"}]},{"text":" this step reads only frontmatter via grep. If the adjacency grep returns nothing (no page uses ","type":"text"},{"text":"relationships:","type":"text","marks":[{"type":"code_inline"}]},{"text":" yet), report that the graph has no typed edges to traverse and suggest running ","type":"text"},{"text":"cross-linker","type":"text","marks":[{"type":"code_inline"}]},{"text":" to populate them, then fall back to ordinary one-hop retrieval.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 5: Synthesize an Answer","type":"text"}]},{"type":"paragraph","content":[{"text":"Compose your answer from wiki content:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Cite specific wiki pages using ","type":"text"},{"text":"[[page-name]]","type":"text","marks":[{"type":"code_inline"}]},{"text":" notation","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Note which step the answer came from (\"found in summary\" vs \"grepped section\" vs \"full page read\") — helps the user understand confidence","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the wiki has contradictions, present both sides","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the wiki doesn't cover something, say so explicitly","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Suggest which sources might fill the gap","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Page trust annotations:","type":"text","marks":[{"type":"strong"}]},{"text":" For every page cited in your answer, check its ","type":"text"},{"text":"lifecycle","type":"text","marks":[{"type":"code_inline"}]},{"text":" frontmatter and compute ","type":"text"},{"text":"is_stale = (today − updated) > 90 days","type":"text","marks":[{"type":"code_inline"}]},{"text":". Annotate risky pages inline so the user knows which citations to verify:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Condition","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Annotation","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"lifecycle: archived","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"(ARCHIVED: superseded by [[target]])","type":"text","marks":[{"type":"code_inline"}]},{"text":" — use the successor instead","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"lifecycle: disputed","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"(DISPUTED, marked \u003clifecycle_changed>: \u003clifecycle_reason or \"reason unspecified\">)","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"is_stale","type":"text","marks":[{"type":"code_inline"}]},{"text":" + ","type":"text"},{"text":"lifecycle: verified","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"(VERIFIED but stale: last updated \u003cupdated>)","type":"text","marks":[{"type":"code_inline"}]},{"text":" — reader should re-verify before relying","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"is_stale","type":"text","marks":[{"type":"code_inline"}]},{"text":" (other lifecycle)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"(stale: last updated \u003cupdated>)","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Examples in a synthesized answer:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"[[concept-page]] (stale: last updated 2026-01-15) — Original claim was X.\n[[verified-page]] (VERIFIED but stale: last updated 2025-09-10) — Reader should reverify before relying.\n[[disputed-page]] (DISPUTED, marked 2026-04-30: contradicted by [[new-source]]) — Earlier said Y, now uncertain.\n[[old-page]] (ARCHIVED: superseded by [[new-page]]) — Use the successor.","type":"text"}]},{"type":"paragraph","content":[{"text":"Pages with no lifecycle field (legacy pages predating the schema) are treated the same as ","type":"text"},{"text":"draft","type":"text","marks":[{"type":"code_inline"}]},{"text":" — annotate if stale, skip otherwise. Never fabricate a ","type":"text"},{"text":"lifecycle_reason","type":"text","marks":[{"type":"code_inline"}]},{"text":"; if the field is absent, omit the reason from the annotation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Surface the project source location (project-scoped queries).","type":"text","marks":[{"type":"strong"}]},{"text":" When the cited pages are project-scoped — their path is under ","type":"text"},{"text":"projects/\u003cname>/...","type":"text","marks":[{"type":"code_inline"}]},{"text":", or their frontmatter carries a ","type":"text"},{"text":"source_path","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"source_repo","type":"text","marks":[{"type":"code_inline"}]},{"text":" field — resolve where the actual code lives so a proposed fix can name real files and a follow-up turn can edit them:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Read ","type":"text"},{"text":"$OBSIDIAN_VAULT_PATH/.manifest.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" and look up ","type":"text"},{"text":".projects.\u003cname>.source_repo","type":"text","marks":[{"type":"code_inline"}]},{"text":" — this is the ","type":"text"},{"text":"authoritative, machine-independent","type":"text","marks":[{"type":"strong"}]},{"text":" identity (e.g. ","type":"text"},{"text":"github.com/owner/name","type":"text","marks":[{"type":"code_inline"}]},{"text":"). It is what you report.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Resolve a local checkout root by trying these in order and stopping at the first that exists: ","type":"text"},{"text":".projects.\u003cname>.source_cwd_hint","type":"text","marks":[{"type":"code_inline"}]},{"text":" (a ","type":"text"},{"text":"~","type":"text","marks":[{"type":"code_inline"}]},{"text":"-relative hint), then a legacy ","type":"text"},{"text":".projects.\u003cname>.source_cwd","type":"text","marks":[{"type":"code_inline"}]},{"text":" (an absolute path, older manifests only), then the page's ","type":"text"},{"text":"source_path","type":"text","marks":[{"type":"code_inline"}]},{"text":" frontmatter. Expand ","type":"text"},{"text":"~","type":"text","marks":[{"type":"code_inline"}]},{"text":" in any candidate and confirm the directory actually exists before using it. A legacy absolute path is used only as a local convenience — never reported as the project's identity.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Report the ","type":"text"},{"text":"Source code:","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" line using ","type":"text"},{"text":"source_repo","type":"text","marks":[{"type":"code_inline"}]},{"text":". When a local checkout resolved in step 2, append the concrete path so the reader can act on it (e.g. ","type":"text"},{"text":"\u003crepo> — local checkout at ~/code/name/public/lib/anticheat.js","type":"text","marks":[{"type":"code_inline"}]},{"text":"). When the query implies a code fix is wanted and a local checkout exists, name the specific files to edit and ","type":"text"},{"text":"offer to implement it as an explicit, separate next step","type":"text","marks":[{"type":"strong"}]},{"text":" — but never edit during the query itself (see the READ-ONLY guard above). If no local checkout resolves, report the repo and say the code is not checked out on this machine.","type":"text"}]},{"type":"paragraph","content":[{"text":"Challenge queries.","type":"text","marks":[{"type":"strong"}]},{"text":" The job is to argue with the user using their own notes, not to be agreeable. Run the normal retrieval on the idea's topic, then search further for:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"earlier decisions on the same question, especially ones that went the other way (","type":"text"},{"text":"synthesis/","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"projects/","type":"text","marks":[{"type":"code_inline"}]},{"text":", pages with \"decision\", \"decided\", \"chose\", \"rejected\", \"won't do\");","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"things that failed or were rolled back: post-mortems, \"gotcha\", \"broke\", \"reverted\", ","type":"text"},{"text":"lifecycle: disputed","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"archived","type":"text","marks":[{"type":"code_inline"}]},{"text":" pages, ","type":"text"},{"text":"contradicts","type":"text","marks":[{"type":"code_inline"}]},{"text":" relationships;","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"open questions and constraints the idea would run into.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Lead the answer with the strongest counter-evidence, each point quoted or closely paraphrased with its ","type":"text"},{"text":"[[page]]","type":"text","marks":[{"type":"code_inline"}]},{"text":" and date, e.g. ","type":"text"},{"text":"\"","type":"text","marks":[{"type":"em"}]},{"type":"wikilink","attrs":{"alias":null,"embed":false,"target":"synthesis/rust-rewrite","blockId":null,"heading":null},"marks":[{"type":"em"}]},{"text":" (2025-11-02) says the rewrite was abandoned over build times. What is different now?\"","type":"text","marks":[{"type":"em"}]},{"text":" Then list what the vault says in favour, if anything. End with one or two questions the user should answer before going ahead. If the vault holds nothing against the idea, say so plainly. Never invent an objection the notes don't support: an empty challenge is a useful answer.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 6: Log the Query","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the ","type":"text"},{"text":"only","type":"text","marks":[{"type":"em"}]},{"text":" write this skill performs — do not edit anything else, and do not append to ","type":"text"},{"text":"log.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" by hand:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"obsidian-wiki memory log QUERY \\\n query=\"the user's question\" result_pages=\u003cN> \\\n mode=\u003cnormal|index_only|filtered> escalated=\u003ctrue|false> \\\n candidates_seen=\u003cN> candidates_used=\u003cN> dropped=\u003cN>","type":"text"}]},{"type":"paragraph","content":[{"text":"The command takes the memory lock and appends one parseable line; it never touches ","type":"text"},{"text":"index.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"hot.md","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the counts tracked since Step 2. If a count wasn't tracked (e.g. index-only mode never built a full candidate set), write ","type":"text"},{"text":"0","type":"text","marks":[{"type":"code_inline"}]},{"text":" rather than omitting the field — the log format should stay parseable.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Answer Format","type":"text"}]},{"type":"paragraph","content":[{"text":"Structure answers like this:","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Based on the wiki:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"[Your synthesized answer with ","type":"text"},{"type":"wikilink","attrs":{"alias":null,"embed":false,"target":"wikilinks","blockId":null,"heading":null}},{"text":" to source pages]","type":"text"}]},{"type":"paragraph","content":[{"text":"Pages consulted:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"type":"wikilink","attrs":{"alias":null,"embed":false,"target":"page-a","blockId":null,"heading":null}},{"text":", ","type":"text"},{"type":"wikilink","attrs":{"alias":null,"embed":false,"target":"page-b","blockId":null,"heading":null}},{"text":", ","type":"text"},{"type":"wikilink","attrs":{"alias":null,"embed":false,"target":"page-c","blockId":null,"heading":null}}]},{"type":"paragraph","content":[{"text":"Gaps:","type":"text","marks":[{"type":"strong"}]},{"text":" [What the wiki doesn't cover that might be relevant]","type":"text"}]},{"type":"paragraph","content":[{"text":"Retrieval:","type":"text","marks":[{"type":"strong"}]},{"text":" N candidates seen, M read, D dropped (untouched matches, if any: ","type":"text"},{"type":"wikilink","attrs":{"alias":null,"embed":false,"target":"page-d","blockId":null,"heading":null}},{"text":", ","type":"text"},{"type":"wikilink","attrs":{"alias":null,"embed":false,"target":"page-e","blockId":null,"heading":null}},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Source code:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"\u003csource_repo>","type":"text","marks":[{"type":"code_inline"}]},{"text":" (local checkout at ","type":"text"},{"text":"~/code/\u003cname>","type":"text","marks":[{"type":"code_inline"}]},{"text":") — to implement, the relevant files are ","type":"text"},{"text":"…","type":"text","marks":[{"type":"code_inline"}]},{"text":". (Say the word and I'll switch out of query mode to make the change.)","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Source code","type":"text","marks":[{"type":"strong"}]},{"text":" line is optional — include it only for project-scoped queries where you resolved a ","type":"text"},{"text":"source_repo","type":"text","marks":[{"type":"code_inline"}]},{"text":" (see Step 5). Report the repository, not a machine absolute path; add the local checkout path only when it actually exists on this machine.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Retrieval","type":"text","marks":[{"type":"strong"}]},{"text":" line is always included — it's the transparency report from the counts tracked since Step 2 (mirrors the ","type":"text"},{"text":"candidates_seen","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"candidates_used","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"dropped","type":"text","marks":[{"type":"code_inline"}]},{"text":" fields logged in Step 6). In index-only mode, report the counts from the frontmatter scan; if D is 0, drop the parenthetical rather than writing an empty list.","type":"text"}]}]},"metadata":{"date":"2026-11-02","name":"wiki-query","author":"@skillopedia","source":{"stars":3661,"repo_name":"obsidian-wiki","origin_url":"https://github.com/Ar9av/obsidian-wiki/blob/HEAD/.skills/wiki-query/SKILL.md","repo_owner":"Ar9av","body_sha256":"000970761924f0374a69009b63c2f2116378260a85d0992d4beb7b37338a83b4","cluster_key":"633d455adf81e10946e4e28cf30f0c104f2e8764d35c4990c7bd6133a70a8eb6","clean_bundle":{"format":"clean-skill-bundle-v1","source":"Ar9av/obsidian-wiki/.skills/wiki-query/SKILL.md","text_bytes":0,"source_commit":"c3ca5df589d5a6c8691d01f578c2e952cdd8f2e1","skills_sh_rank":5716,"attachment_count":0,"text_attachments":0,"attachment_storage":"skill_attachments","binary_attachments":0},"cluster_size":1,"skill_md_path":".skills/wiki-query/SKILL.md","import_metadata":{"date":"2026-11-02","author":"@skillopedia","version":"v1","category":"productivity-workflow","category_label":"Productivity"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"productivity-workflow","import_tag":"skills-sh-top20k-2026-11","description":"Search and synthesize answers from the compiled Obsidian wiki, including cited and multi-hop answers. Use for questions about existing wiki knowledge or fast index-only lookups, and for challenge requests (\"challenge this\", \"argue against X\", \"poke holes in my plan\") that look for the vault's own evidence against a plan. Supports named-vault routing such as wiki-query @work; not for ingesting new sources.\n"}},"renderedAt":1793671732931}

Wiki Query — Knowledge Retrieval You are answering questions against a compiled Obsidian wiki, not raw source documents. The wiki contains pre-synthesized, cross-referenced knowledge. This skill is READ-ONLY answers questions. It MUST NOT create or modify any wiki content. The ONLY write it may perform is the single Step 6 append to . Never, even when a change seems obviously helpful: - create or edit pages under , , , , , , or - modify , , , or If the user's message contains a new finding, an action request ("save this", "ban X", "record that"), or anything implying a change, do not perform…