Second Brain Ingest

1---2name: second-brain-ingest3description: >4  Process raw source documents into wiki pages. Use when the user adds5  files to raw/ and wants them ingested, says "process this source",6  "ingest this article", "I added something to raw/", or wants to7  incorporate new material into their knowledge base.8allowed-tools: Bash Read Write Edit Glob Grep9---10 11# Second Brain — Ingest12 13Process raw source documents into structured, interlinked wiki pages.14 15## Identify Sources to Process16 17Determine which files need ingestion:18 191. If the user specifies a file or files, use those202. If the user says "process new sources" or similar, detect unprocessed files:21   - List all files in `raw/` (excluding `raw/assets/`)22   - Read `wiki/log.md` and extract all previously ingested source filenames from `ingest` entries23   - Any file in `raw/` not listed in the log is unprocessed243. If no unprocessed files are found, tell the user25 26## Process Each Source27 28For each source file, follow this workflow:29 30### 1. Read the source completely31 32Read the entire file. If the file contains image references, note them — read the images separately if they contain important information.33 34### 2. Discuss key takeaways with the user35 36Before writing anything, share the 3-5 most important takeaways from the source. Ask the user if they want to emphasize any particular aspects or skip any topics. Wait for confirmation before proceeding.37 38### 3. Create source summary page39 40Create a new file in `wiki/sources/` named after the source (slugified). Include:41 42    ---43    tags: [relevant, tags]44    sources: [original-filename.md]45    created: YYYY-MM-DD46    updated: YYYY-MM-DD47    ---48 49    # Source Title50 51    **Source:** original-filename.md52    **Date ingested:** YYYY-MM-DD53    **Type:** article | paper | transcript | notes | etc.54 55    ## Summary56 57    Structured summary of the source content.58 59    ## Key Claims60 61    - Claim 162    - Claim 263    - ...64 65    ## Entities Mentioned66 67    - [[Entity Name]] — brief context68    - ...69 70    ## Concepts Covered71 72    - [[Concept Name]] — brief context73    - ...74 75### 4. Update entity and concept pages76 77For each entity (person, organization, product, tool) and concept (idea, framework, theory, pattern) mentioned in the source:78 79**If a wiki page already exists:**80- Read the existing page81- Add new information from this source82- Add the source to the `sources:` frontmatter list83- Update the `updated:` date84- Note any contradictions with existing content, citing both sources85 86**If no wiki page exists:**87- Create a new page in the appropriate subdirectory:88  - `wiki/entities/` for people, organizations, products, tools89  - `wiki/concepts/` for ideas, frameworks, theories, patterns90- Include YAML frontmatter with tags, sources, created, and updated fields91- Write a focused summary based on what this source says about the topic92 93### 5. Add wikilinks94 95Ensure all related pages link to each other using `[[wikilink]]` syntax. Every mention of an entity or concept that has its own page should be linked.96 97### 6. Update wiki/index.md98 99For each new page created, add an entry under the appropriate category header:100 101    - [[Page Name]] — one-line summary (under 120 characters)102 103### 7. Update wiki/log.md104 105Append:106 107    ## [YYYY-MM-DD] ingest | Source Title108    Processed source-filename.md. Created N new pages, updated M existing pages.109    New entities: [[Entity1]], [[Entity2]]. New concepts: [[Concept1]].110 111### 8. Report results112 113Tell the user what was done:114- Pages created (with links)115- Pages updated (with what changed)116- New entities and concepts identified117- Any contradictions found with existing content118 119## Conventions120 121- Source summary pages are **factual only**. Save interpretation and synthesis for concept and synthesis pages.122- A single source typically touches **10-15 wiki pages**. This is normal and expected.123- When new information contradicts existing wiki content, **update the wiki page and note the contradiction** with both sources cited.124- **Prefer updating existing pages** over creating new ones. Only create a new page when the topic is distinct enough to warrant its own page.125- Use `[[wikilinks]]` for all internal references. Never use raw file paths.126 127## What's Next128 129After ingesting sources, the user can:130- **Ask questions** with `/second-brain-query` to explore what was ingested131- **Ingest more sources** — clip another article and run `/second-brain-ingest` again132- **Health-check** with `/second-brain-lint` after every 10 ingests to catch gaps