wiki-write

Wiki Write

Add or update content in the wiki. Auto-creates .wiki/ if it doesn't exist.

Resolve .wiki/ from plugin install scope. Auto-create if missing.

Auto-Init

If .wiki/ doesn't exist, create it automatically before proceeding:

.wiki/
  pages/
  index.md        (empty: "# Wiki Index\n\nNo pages yet.\n")
  overview.md     (empty: "# Overview\n\nNo content yet.\n")
  log.md          (empty: "# Activity Log\n")
  SCHEMA.md       (evaluation rules — see below)
  config.yaml     (empty)
  cache/
  raw/
    web/ papers/ notes/ transcripts/ code/ feeds/ assets/

Arguments

• /wiki-write <url> — fetch and ingest a web page or paper
• /wiki-write <file-path> — ingest a local file (text, markdown, PDF)
• /wiki-write "text..." — ingest pasted text
• /wiki-write --batch <dir> — ingest all .md files in a directory
• /wiki-write --update <slug> — update an existing page autonomously
• /wiki-write --update <slug> <url> — update page with content from URL
• /wiki-write --refresh-stale — find and refresh stale pages based on freshness tier

Ingest (default — no --update flag)

Launch the wiki-writer agent with mode: ingest:

• Fetches content (via bin/fetch.py chain: cache → Jina → trafilatura → WebFetch)
• Saves raw source to .wiki/raw/
• Writes source summary page and entity/concept pages to .wiki/pages/
• Runs backlink audit via bin/backlinks.py update .wiki/pages
• Updates .wiki/index.md, .wiki/overview.md, .wiki/log.md
• No confirmation pause — runs end-to-end autonomously

Report: pages written, pages updated, confidence assigned.

Update (--update)

Launch the wiki-writer agent with mode: update:

1. Reads current page
2. Generates proposed changes
3. Runs contradiction sweep against high-confidence pages
4. Applies changes directly — same autonomous behavior as ingest
5. Updates index.md and log.md

Refresh Stale (--refresh-stale)

Finds pages past their freshness tier TTL (see freshness tiers in /wiki-maintain). For each: searches for fresh sources → applies updates autonomously.

Batch (--batch)

Sequentially ingest each file in the directory. Report progress.

Custom Page Types

Users can define custom page types by creating template files in .wiki/templates/. Each template is a markdown file with YAML frontmatter that defines default fields and placeholder content.

Creating a custom page type:

1. Create a file in .wiki/templates/<type-name>.md
2. Add YAML frontmatter with default fields (title, type, confidence, dates, custom fields)
3. Add markdown body content with placeholders (e.g., {{title}}, {{date}})

Using a custom page type:

When using /wiki-write with type: custom-type-name, the write operation will:

• Look for .wiki/templates/custom-type-name.md
• Use the template's frontmatter and body as the page skeleton
• Replace placeholders with actual values (dates, title, etc.)
• Proceed with normal page creation

Placeholder variables:

• {{title}} — Page title
• {{date}} — Current date (YYYY-MM-DD)
• {{created}} — Creation timestamp (ISO 8601)
• {{updated}} — Update timestamp (ISO 8601)