Ingestion Instructions

When the author drops material into wiki/raw/ and asks for processing, follow this procedure.

Step 1: Read and understand the source

Read the raw material thoroughly. It could be:

• A voice memo transcript (rambling, non-linear thinking — extract the ideas, don't judge the form)
• A conversation transcript (identify the author's positions vs. others')
• An article or research paper (extract claims, evidence, and relevance to the book)
• Rough notes or bullet points (expand into structured thinking)
• A link (fetch and read the content)

Step 2: Extract ideas

For each distinct idea, argument, or piece of evidence in the source, identify:

• The idea itself — stated clearly and concisely
• How it relates to existing book arguments — does it strengthen, challenge, extend, or introduce something new?
• Where it fits — specific chapter(s) and approximate location within the chapter
• What it replaces or augments — is there a weaker version of this argument already in the manuscript?

Step 3: Create the ingested page

Write a structured page in wiki/ingested/ named with the date and a descriptive slug: ingested/2026-04-15-consciousness-and-identity.md

Include:

• Source metadata (what it was, when ingested)
• Summary of the material
• Each extracted idea with integration mapping
• Cross-references to existing wiki pages

Step 4: Generate queue entries

For each actionable suggestion, create an entry in wiki/queue/. Name format: queue/PRIORITY-chapter-NN-brief-description.md

Example: queue/high-chapter-12-add-reciprocity-dissolution.md

Each queue entry must specify:

• What: the specific change
• Where: chapter number and section/location within the chapter
• Why: what new material motivates this
• How: suggested approach (add section, replace paragraph, extend argument, add evidence, etc.)
• Impact: what this strengthens
• Priority: high/medium/low

Step 5: Update existing wiki pages

If the new material relates to existing concept, evidence, or chapter pages:

• Add cross-references
• Update "open questions" if the new material resolves one
• Flag pages as "needs-review" if the new material contradicts them

Step 6: Update HOT.md

Add a line noting what was ingested and the most important queue entries generated.

Step 7: Rebuild the browser

Run the HTML build script to reflect new pages in the browsable wiki.

Critical rules during ingestion

1. Preserve the author's voice and thinking. When extracting from transcripts, keep the original framing. Don't sanitise rough thinking into conventional language.
2. Never project conventional discourse. If the author argues something that contradicts standard UBI/AI positions, the author is right. The book is original thought.
3. Be specific about chapter placement. "This could go in Chapter 5" is useless. "This strengthens the argument in Chapter 5's section on cascading energy costs, specifically where the current text discusses perovskite solar — the new material adds the efficiency breakthrough data that makes the cost-dissolution argument concrete" is useful.
4. Prioritise honestly. Not everything is high priority. Most things are medium or low. Reserve high for material that fills a genuine gap or significantly strengthens a weak argument.
5. Track what's genuinely new. If the author's transcript contains an idea that doesn't fit anywhere in the current book structure, flag it explicitly. It might represent the book's evolution.