Imported from vendpark/user-wiki-d7618c23 (wiki/AGENTS.md). Install upstream with npx skills add vendpark/user-wiki-d7618c23 --skill wiki. Copyright stays with the author.

Wiki Maintainer Schema

This is an agent-maintained knowledge wiki. You (the agent) author everything under this directory. raw/ is the ingestion INBOX — material lands there to be processed and is DELETED once transformed; keep it trending to EMPTY and never retain originals longer than necessary. Read this file at the start of every session; wiki_info also returns it.

Directory structure

AGENTS.md (this schema) · index.md (catalog — your map) · log.md (op log) · raw/ (ingestion inbox — transient, drain to empty) · sources/ entities/ concepts/ analyses/ questions/ decisions/ (typed pages).

Page format

Every typed page starts with YAML frontmatter: title, type (source | entity | concept | analysis | question | decision), description, created/updated (YYYY-MM-DD), sources (list of sources/* slugs), tags. Questions add status: open | answered | stale. Decisions add status: proposed | active | superseded, decided, and outcome (starts empty; fill as real results arrive). Bodies are compact structural markdown — headings, bullets, tables. Target 15-30 lines. One concept per page.

Links and slugs

Write [[path/slug]] wikilinks (alias: [[path/slug|label]]) — path from this directory, no .md. Slugs are lowercase kebab-case. Imported pages may use plain markdown links (/concepts/x.md, ./x.md); treat them as equivalent and NEVER rewrite an imported page's links. Link generously; broken links mean not-yet-written knowledge, not errors.

Keep pages fresh

Entity/concept/analysis pages reflect current understanding: overwrite the stale parts, bump updated:, move on — git history is the audit trail. Two exceptions: (1) contradictions between sources — keep both claims cited under a "Contradictions / Open Questions" section until resolved; (2) decision pages accumulate dated Outcome entries.

Attribution

Every factual claim in entity/concept/analysis pages cites a source: According to [[sources/x]], …. External material goes under a # Citations heading. If you cannot cite it, file a question instead of asserting it.

Layers

This wiki is one layer. A read-only universal layer (org-wide knowledge) may also be mounted — never write to it. To propose knowledge for promotion to universal, file a question or decision page HERE tagged promote-universal; a maintainer workflow reviews promotions (mechanism may evolve — check wiki_info).

Workflows

Ingest (new material in raw/, saved via wiki_save_source, or user-queued sources from wiki_ingest_queue — close each with wiki_ingest_complete): read it fully; write sources/<slug>.md (summary, key claims, wikilinks to every entity/concept); create-or-overwrite the entity/concept pages it touches; check open questions (wiki_open_questions) — update/answer any it bears on; check active decisions (wiki_active_decisions) — record outcomes it reveals; file genuinely new questions/decisions; update index.md; append to log.md; then DELETE the ingested raw file — the sources/ page is the PERMANENT record, so capture key claims, verbatim quotes that matter, and the origin (URL/filename) BEFORE deleting. Touching 5-15 pages per ingest is normal.

Query: read index.md first; read the relevant pages; answer with wikilink citations. File substantial answers as analyses/<slug>.md; file unanswerable questions as questions/<slug>.md (status: open). Log as query.

Capture question / decision: questions get why-it-matters + current knowledge; decisions get Context / Options Considered / Decision / Outcome (empty) sections, and cite related past decisions. Update index; log as question / decision.

Lint: report raw/ backlog (files awaiting ingestion — raw should be empty), orphan pages, broken wikilinks, stale pages (older than their newest source), missing pages (mentioned 3+ times, no page), contradictions, unsourced claims, stale questions (open, 60+ days), silent decisions (active, empty outcome, 90+ days), oversized pages (80+ lines). Fix what is confirmed; log as lint.

Log and index

log.md: append entries chronologically (newest at the end) as ## [YYYY-MM-DD] <op> | <title> + a 1-3 line body. Never break the heading format (grep "^## \[" log.md must parse; tail shows recent ops). index.md: sections by type, entries - [Title](path) - description, no frontmatter — update it on EVERY write; it is the map you read first.