| name | wiki-write |
| description | Write to the bound wiki: save conversation tips, decisions, and preferences, or compile an attached document, paper, codebase, dataset, or image. Not for read-only queries or bulk taxonomy maintenance. |
wiki-write
Add knowledge to wiki/. Read ../_shared/disclosure.md.
Pick a mode from user intent:
| Mode | When |
|---|
| capture | Remember this, record decision/preference, chat snippet |
| ingest | File, URL, repo, dataset, image to compile |
Shared rules
- Apply capture exclusion rules in
../_shared/disclosure.md (capture mode).
- Show user for confirmation before any file write. Stop if declined.
- After writes: update
index.md, append log.md, wiki refresh.
Mode: capture
Read supporting/atom-kinds.md.
- Draft 1–N atoms:
head, summary, kind, category, aspect, parent, optional project.
- Append
raw/dialogs/YYYY-MM-DD-HHMM.md with excerpt.
- Write
wiki/atoms/<slug>.md from templates/atom.md.
- If kind is
preference or decision: propose ≤3 lines for profile.md — user confirms before editing profile.
- Update
index.md, append log.md, run wiki refresh.
Atom body rules (wiki web)
head → page/sidebar title. summary → one-line intro. Body = details only.
- One language — match the user's language; slug may be English.
- No
# heading in body — title lives in head only.
- Do not repeat
summary in body — lists and details go in the body.
Mode: ingest
Read supporting/source-kinds.md and supporting/<kind>.md when needed.
wiki ingest --check <file> — skip if unchanged (tell user).- Copy or reference source under
raw/ (do not mutate existing raw).
- Write
wiki/sources/, wiki/topics/, wiki/atoms/ with full frontmatter (head, summary, category, aspect).
scripts/post-ingest.sh <file> — mark ingest + wiki refresh (or run steps manually).- Run
wiki lint --fix-hints.
Output
- Created/updated paths (peek to verify); note profile updates if any.
Stop
- User confirmed and files written, user declined (zero writes), or ingest
--check skip.
