ingest

Ingest Skill

Ingest meetings, articles, media, documents, and conversations into the brain.

Filing rule: Read skills/_brain-filing-rules.md (via get_skill _brain-filing-rules) before creating any new page.

Contract

• Every fact written to a brain page carries an inline [Source: ...] citation with date and provenance.
• Every entity mention creates a back-link from the entity's page to the page mentioning them (Iron Law).
• Raw sources are preserved for provenance via the put_raw_data tool.
• State sections are rewritten with current best understanding, never appended to.
• Entity detection fires on every inbound message; notable entities get pages or updates.

Convention: See conventions/quality.md (via get_skill conventions/quality) for Iron Law back-linking.

Every mention of a person or company with a brain page MUST create a back-link FROM that entity's page TO the page mentioning them. An unlinked mention is a broken brain. See skills/_brain-filing-rules.md for format.

Citation Requirements (MANDATORY)

Every fact written to a brain page must carry an inline [Source: ...] citation.

• User's statements: [Source: User, {context}, YYYY-MM-DD]
• Meeting data: [Source: Meeting "{title}", YYYY-MM-DD]
• Email/message: [Source: email from {name} re: {subject}, YYYY-MM-DD]
• Web content: [Source: {publication}, {URL}, YYYY-MM-DD]
• Social media: [Source: X/@handle, YYYY-MM-DD](URL) (include link)
• Synthesis: [Source: compiled from {sources}]

Phases

Router note: This skill is a router. For specialized ingestion, see: idea-ingest, media-ingest, meeting-ingestion.

1. Parse the source. Extract people, companies, dates, and events from the input.
2. For each entity mentioned:
   • Read the entity's page with page_get to check if it exists
   • If exists: update compiled_truth (rewrite State section with new info, don't append)
   • If new: check notability gate, then store the page with page_put with the appropriate type and slug
3. Append to timeline. Add a timeline entry with add_timeline_event for each event, with date, summary, and source citation.
4. Create cross-reference links. Use link for every entity pair mentioned together, with the appropriate relationship type.
5. Back-link all entities. Update EVERY mentioned entity's page with a back-link to this page (Iron Law).
6. Timeline merge. The same event appears on ALL mentioned entities' timelines. If Alice met Bob at Acme Corp, the event goes on Alice's page, Bob's page, and Acme Corp's page.