Wiki Ingest
Ingest a source document into the knowledge wiki — creating structured, interlinked pages that compound over time.
Usage Template
Prompt
Use wiki-ingest on this source. Create source notes, concept pages, entity pages, navigation updates, and a verification summary.
Use Case
- Turning an article, PDF, transcript, or rough note into durable linked knowledge.
Expected Result
- The agent creates an immutable source note, 3-7 key insights, linked wiki pages, and a log entry.
Output Example
sources/src-YYYYMMDD-title.md,wiki/concepts/concept-name.md,wiki/entities/entity-name.md, andsystem/log.mdupdate.
Verification Case
- New wiki pages have frontmatter, source references, at least two
[[wikilinks]], and timeline entries.
Verified Effect
- Knowledge stops being a loose summary: the source becomes traceable, linked, and reusable across future sessions.
V5.2 Closure Add-on
- Classify every input as
external-fact,human-experience,internal-state, orenvironment-signal. - For high-value ingests, decide whether to create one behavior experiment and one creativity experiment.
- Record governance risks: single-source claims, missing provenance, stale-page risk, and review queue items.
When to Use
- User drops a file and says "ingest this"
- User shares a link/article/video/PDF to be processed
- User says "add this to the wiki" or "save this to my knowledge base"
- User mentions a source that should be captured
Workflow
Step 1: Capture
Create an immutable source note in sources/:
---
source_id: "src-YYYYMMDD-short-slug"
title: "Original Source Title"
author: ""
url: ""
created_at: "YYYY-MM-DD"
captured_at: "YYYY-MM-DDTHH:MM:SS"
source_type: "article | book | video-transcript | paper | conversation"
trust_level: "1-unverified | 2-expert-source"
hash: "sha256-16char"
status: "raw | ingested"
---
Rules:
- Never modify source files after creation
- Extract 3-7 Key Insights with block refs (
^ki-short-name) - Flag single-source claims with
> [!warning] Single source - Assign an input class:
external-fact | human-experience | internal-state | environment-signal
Step 2: Auto-create Entity Pages
For every person, company, product, or project mentioned in the source:
---
tags:
- domain/strategy
- type/entity
type: entity
status: seed
created: "YYYY-MM-DD"
knowledge_stage: single-source
evidence_level: single-source
---
# Entity Name
- Check if entity page already exists → update if needed
- Use consistent naming (English for global entities, Chinese for local)
Step 3: Create/Update Concept Pages
For every key concept, framework, or methodology:
- Check if concept page already exists
- If exists: add new source reference, flag contradictions
- If new: create with
status: seed, ≥2[[wikilinks]],knowledge_stage: single-source
Standardized page structure (all concept pages should follow this pattern):
# Title
> Core thesis in one line — what is the single most important thing to know?
> (Source: [[source]])
---
## Core Mechanism
ASCII diagram showing causal relationships.
## Classifications / Comparisons
Tables comparing with related frameworks.
## Key Data (if applicable)
Bulleted list of critical numbers.
## Implications / Applications
What this means for decision-making.
## Connections
- Related concepts with brief explanation of relationship
- Source references
---
## Evolution Timeline
- **YYYY-MM-DD**:Created.
Rules:
- Start every page with a quote block that captures the core thesis
- Use ASCII diagrams for mechanisms (causal chains)
- Use tables for comparisons (frameworks, classifications, data)
- End with connections (grouped wikilinks) + evolution timeline (separated by
---)
Step 4: Update Navigation
- Update the wiki overview / living synthesis
- Update the central index
- Update relevant MOC (map of content) pages
Step 5: Convert to Behavior / Creativity When Warranted
After a high-value ingest, run these checks:
| Check | Create / Update |
|---|---|
| The source implies a habit, action, identity shift, pain point, or repeated decision | 08_behaviors/action-sops/ or 08_behaviors/reviews/ |
| The source suggests a product, content asset, analogy, cross-domain pattern, or minimum test | 09_creativity/experiments/ |
| The source contains single-source claims, missing provenance, or stale-page risk | system/governance-dashboard.md or review queue |
Behavior experiment minimum fields:
- source concept
- behavior hypothesis
- trigger
- 15-minute action
- success metric
- review date
Creativity experiment minimum fields:
- source ingredients
- combination formula
- target user
- hypothesis
- minimum test
- success signal
- next output
Step 6: Append Timeline
After updating or creating any wiki page, append a timeline entry at the bottom (below a --- separator):
---
## 演化时间线
- **YYYY-MM-DD**:创建初始版本。
- **YYYY-MM-DD**:更新了关于 X 的理解(来源:[[source]])。旧观点 Y,新证据表明 Z。
Rules:
- Content above
---is compiled truth — current best understanding, rewritable - Content below
---is the timeline — append-only, never edited or deleted - Add an entry on creation, and every time a core claim changes
Step 7: Log
Append to system/log.md with:
- Source ingested
- Entity pages created/updated
- Concept pages created/updated
- Maps updated
- Behavior / creativity experiments created or explicitly skipped
- Governance risks recorded
Quality Gates
- Source note created with frontmatter
- ≥2 entity pages created or updated
- ≥1 concept page created or updated
- Every wiki page has ≥2
[[wikilinks]] - Navigation (overview + index + maps) updated
- Behavior conversion assessed
- Creativity conversion assessed
- Governance risks recorded
- Log appended
Page Format
Every wiki page uses this frontmatter:
---
tags: [domain/xxx, type/concept|entity|sop]
type: concept | entity | sop
status: seed | growing | evergreen | stale
created: YYYY-MM-DD
knowledge_stage: captured | stored | cross-checked | applied
evidence_level: single-source | multi-source | curated-map
---
Key Principles
- Immutable sources: raw/inbox files are never modified after ingest
- Compound: every new source makes the wiki richer
- Linked: every page ≥2 outbound
[[wikilinks]] - Sourced: every claim cites
(Source: [[source-file#^ref]]) - Contradictions flagged:
> [!warning] Contradictionwhen sources disagree