| name | wiki-read |
| description | Read from the bound wiki: restore session context before a task, or answer a question from ingested sources and atoms. Uses index, search, peek, and limited full reads. Not for writing to wiki, ingesting files, or taxonomy maintenance. |
wiki-read
Progressive disclosure reads. Read ../_shared/disclosure.md.
Pick a mode from user intent (do not ask which mode unless ambiguous):
| Mode | When | Depth |
|---|
| brief | Session start, "what do I know about X", task prep | peek only |
| query | Specific question needing synthesis | peek → read if needed |
Steps (all modes)
- Run
scripts/gather-brief.sh or scripts/gather-context.sh (includes bound check). Stop if unbound.
- If
profile.md exists, wiki peek profile.md for stable preferences.
Mode: brief
- Run
scripts/gather-brief.sh "<optional topic>" (empty = general refresh).
- For each hit (max 8),
wiki peek <path> — do not wiki read.
- Summarize 3–5 bullets with
[[path]] citations.
Mode: query
- Run
scripts/gather-context.sh "<question>" (or wiki search + wiki index).
wiki peek top atoms/topics (prefer type atom).wiki read --reason only if peek insufficient (max 3 full reads).- Synthesize answer with
[[path]] citations.
- Optionally suggest
/wiki-write to save new conclusions — do not auto-write.
Output
- brief: context bullets + cited paths; note gaps if search empty.
- query: answer with citations; state gaps explicitly.
Stop
- Mode complete, or user only needed status check.
