--- name: second-brain-ingest description: > Process raw source documents into wiki pages. Use when the user adds files to raw/ and wants them ingested, says "process this source", "ingest this article", "I added something to raw/", or wants to incorporate new material into their knowledge base. allowed-tools: Bash Read Write Edit Glob Grep --- # Second Brain — Ingest Process raw source documents into structured, interlinked wiki pages. ## Identify Sources to Process Determine which files need ingestion: 1. If the user specifies a file or files, use those 2. If the user says "process new sources" or similar, detect unprocessed files: - List all files in `raw/` (excluding `raw/assets/`) - Read `wiki/log.md` and extract all previously ingested source filenames from `ingest` entries - Any file in `raw/` not listed in the log is unprocessed 3. If no unprocessed files are found, tell the user ## Process Each Source For each source file, follow this workflow: ### 1. Read the source completely Read the entire file. If the file contains image references, note them — read the images separately if they contain important information. ### 2. Discuss key takeaways with the user Before 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. ### 3. Create source summary page Create a new file in `wiki/sources/` named after the source (slugified). Include: --- tags: [relevant, tags] sources: [original-filename.md] created: YYYY-MM-DD updated: YYYY-MM-DD --- # Source Title **Source:** original-filename.md **Date ingested:** YYYY-MM-DD **Type:** article | paper | transcript | notes | etc. ## Summary Structured summary of the source content. ## Key Claims - Claim 1 - Claim 2 - ... ## Entities Mentioned - [[Entity Name]] — brief context - ... ## Concepts Covered - [[Concept Name]] — brief context - ... ### 4. Update entity and concept pages For each entity (person, organization, product, tool) and concept (idea, framework, theory, pattern) mentioned in the source: **If a wiki page already exists:** - Read the existing page - Add new information from this source - Add the source to the `sources:` frontmatter list - Update the `updated:` date - Note any contradictions with existing content, citing both sources **If no wiki page exists:** - Create a new page in the appropriate subdirectory: - `wiki/entities/` for people, organizations, products, tools - `wiki/concepts/` for ideas, frameworks, theories, patterns - Include YAML frontmatter with tags, sources, created, and updated fields - Write a focused summary based on what this source says about the topic ### 5. Add wikilinks Ensure 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. ### 6. Update wiki/index.md For each new page created, add an entry under the appropriate category header: - [[Page Name]] — one-line summary (under 120 characters) ### 7. Update wiki/log.md Append: ## [YYYY-MM-DD] ingest | Source Title Processed source-filename.md. Created N new pages, updated M existing pages. New entities: [[Entity1]], [[Entity2]]. New concepts: [[Concept1]]. ### 8. Report results Tell the user what was done: - Pages created (with links) - Pages updated (with what changed) - New entities and concepts identified - Any contradictions found with existing content ## Conventions - Source summary pages are **factual only**. Save interpretation and synthesis for concept and synthesis pages. - A single source typically touches **10-15 wiki pages**. This is normal and expected. - When new information contradicts existing wiki content, **update the wiki page and note the contradiction** with both sources cited. - **Prefer updating existing pages** over creating new ones. Only create a new page when the topic is distinct enough to warrant its own page. - Use `[[wikilinks]]` for all internal references. Never use raw file paths. ## What's Next After ingesting sources, the user can: - **Ask questions** with `/second-brain-query` to explore what was ingested - **Ingest more sources** — clip another article and run `/second-brain-ingest` again - **Health-check** with `/second-brain-lint` after every 10 ingests to catch gaps --- Source attribution: NicholasSpisak Original project: https://github.com/NicholasSpisak/second-brain License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Gabriel Moreira Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: NicholasSpisak Original project: https://github.com/NicholasSpisak/second-brain Attribution basis: Upstream repository explicitly recorded in package mirror path Fields of work: Design, Education & Research, Marketing Roles: Content Marketer, Researcher, UX Writer Specialties: Notion Tools: Bash Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 5257b3b986ab707accda75e03c11bf9de3b3779d955f00c409f783bc564da29a