Wiki Ingest#

Ingest one source into an existing markdown knowledge wiki without turning the wiki into a junk drawer. Read the source, identify durable knowledge, update the right existing pages, and create new pages only when they are clearly warranted.

Workflow#

1. Read the source material
2. Identify core topics, entities, concepts, claims, dates, and open questions
3. Inspect the relevant wiki pages before creating new ones
4. Create or update a source summary page if the wiki uses source pages
5. Update affected topic, concept, entity, and analysis pages
6. Add or repair internal links
7. Update index.md
8. Append a concise ingest entry to log.md
9. Record contradictions, uncertainty, and follow-up questions explicitly

Page creation rule#

Create a new page only when at least one of these is true:

• the concept or entity is likely to recur
• the page can become a meaningful link hub
• the content would make an existing page too broad or noisy

Otherwise, update an existing page.

Source handling#

Treat source material as read-only.

Preserve the distinction between:

• what the source says
• what the wiki already believes
• what the current synthesis suggests after combining multiple sources

Do not silently flatten contradictions.

Required outputs#

For a normal ingest, produce:

• a source summary or source page update
• updates to relevant wiki pages
• an index.md update
• a log.md entry
• a short note on contradictions, ambiguity, or next questions

Quality bar#

A good ingest should:

• increase reuse of knowledge
• strengthen cross-links
• reduce future re-reading
• keep page scope clean
• avoid speculative overreach

References#

Read references/ingest-patterns.md for templates and examples.