Use when revising existing wiki pages because knowledge has changed, a new piece of information updates or contradicts existing content, or the user wants to directly edit wiki content with LLM assistance.
Revise existing wiki pages. Always show diffs before writing. Always log. Always cite the source of new information.
Find SCHEMA.md (search from cwd upward, or ~/wikis/). If not found, tell the user to run wiki-init first. Read it to get wiki root path and conventions.
The user may provide:
wiki/index.md to find affected pages, then read those pagesRead the current content in full. Propose the change:
Current: <quote the existing text>
Proposed: <replacement text>
Reason: <why this change is warranted>
Source: <URL, file path, or description of where this information comes from>
Always include Source. An edit without a source citation creates untraceability — future you won't know why the change was made.
Ask for confirmation before writing each page. Do not batch-apply changes without per-page confirmation.
After identifying the primary pages to update, grep for [[slug]] references to those pages across all of wiki/pages/. For each page that links to an updated page:
If the new information contradicts something in the wiki: search all pages for the contradicted claim before updating. It may appear in more than one place. Update all occurrences, not just the most obvious one.
wiki/index.mdIf the one-line summary for any updated page has changed, update it in index.md. Update the updated date in the page's frontmatter.
wiki/overview.mdRe-read overview.md. If the updates shift the overall synthesis (new understanding, resolved open question, changed key claim), propose edits to overview.md using the same confirm-before-write flow.
wiki/log.mdAlways append — do not ask permission, do not skip if log.md exists:
## [<today>] update | <list of updated page slugs>
Reason: <brief description of what changed and why>
Source: <URL or description>
log.md doesn't exist, create it.