Write

---
name: wiki-write
description: "Add or update wiki content — autonomous ingest from URL, file, or text; autonomous update of existing pages. Auto-creates .wiki/ on first use. Use when: 'save to wiki', 'remember this', 'note this', 'store this', 'add to knowledge base', 'save findings', 'save research', 'save idea', 'write to wiki', 'ingest', 'add page', 'update page'."
---

# 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)