Wiki Query#
Answer questions from a markdown knowledge wiki by reading the wiki first, synthesizing across relevant pages, and saving durable results back into the wiki when they will be useful later.
Query workflow#
- Read
index.md first when available
- Identify the most relevant topic, concept, entity, source, and analysis pages
- Synthesize from the wiki before falling back to raw source files
- Distinguish direct support, synthesis, and uncertainty
- Cite the relevant wiki pages and, when useful, the supporting source pages
- Decide whether the result should be saved as a durable analysis page
- If a new page is created, update
index.md
- If the wiki tracks query history, append a concise entry to
log.md
Query principles#
Prefer answers that clearly separate:
- facts directly supported by source-backed wiki pages
- synthesis across multiple pages
- speculation, ambiguity, or unresolved questions
Do not present a smooth answer if the wiki evidence is mixed. Surface disagreement and missing evidence explicitly.
When to save the answer#
Save the result back into the wiki when it has durable value, such as:
- a comparison that would be expensive to redo
- a synthesis across many pages or sources
- a decision memo or recommendation the user may revisit
- a new framing that should influence related topic or entity pages
Do not save trivial one-off answers.
Typical outputs#
For a normal wiki query, deliver:
- a concise answer grounded in the wiki
- citations to the relevant wiki pages
- a reusable analysis page when justified
- any related
index.md or log.md updates
Quality bar#
A good wiki query should:
- reduce future repeated work
- preserve traceability back to the wiki
- make uncertainty visible
- improve the wiki when the result is worth keeping
References#
Read references/query-patterns.md for analysis-page templates and filing heuristics.