wiki-ingest

Wiki Ingest

Goal

Convert raw source material into reviewable wiki updates while preserving provenance, uncertainty and human-owned synthesis.

When to use

• A trusted raw source (PDF, article, transcript, notes, repo doc, web capture) should become reviewable wiki pages.
• Sorted inbox material was approved for ingestion after wiki-triage.

Route unsorted captures to wiki-triage first. A filled input-to-output example ships in assets/worked-example.md.

Inputs

• One or more files under raw/ or inbox/.
• Optional user goal: why the source matters.
• Existing wiki/index.md and wiki/log.md.
• Existing AGENTS.md, CLAUDE.md and schemas if present.

Write permissions

Allowed:

• create/update wiki/sources/*;
• create/update wiki/entities/*;
• create/update wiki/concepts/*;
• create/update wiki/comparisons/* when explicitly useful;
• append to wiki/log.md;
• update wiki/index.md;
• write low-confidence material to _agent/drafts/ or mark it review_required: true.

Not allowed unless explicitly requested:

• edit raw/ files;
• delete source material;
• overwrite ## My synthesis or human-owned sections;
• mark generated pages as verified;
• perform bulk rewrites unrelated to the source.

Procedure

1. Read the schema layer

Inspect AGENTS.md, CLAUDE.md, _meta/taxonomy.md, _meta/schemas/* and wiki/index.md when present.

2. Analyze before writing

Produce a short analysis plan before editing:

## Ingest analysis

- Source path:
- Source type:
- Likely page type:
- Candidate entities:
- Candidate concepts:
- Possible existing pages to update:
- Ambiguities:
- Review risks:

3. Extract claims

Classify claims using the shared support vocabulary:

• extracted: directly present in the source;
• inferred: reasoned from the source;
• ambiguous: plausible but unresolved, requires human review;
• synthesis: editorial conclusion — human-owned, do not generate during ingest;
• unsupported: no inspected source currently supports the claim;
• conflicting: inspected sources disagree about the claim.