| name | ingest-brain-dump |
| description | Full orchestrator for stream-of-consciousness input pasted or dictated into the Claude Code session. Pipeline: explore-second-brain (find related files) → semantic segmentation → verify-idea (dedupe check) → process-content (create Template A files) → validate_template.py → user approval → save. Use when user pastes unstructured text or dictates a voice note into chat and says "brain dump", "process this", "ingest this", "save this", "what should we do with this". One paragraph may contain 3 ideas; 5 paragraphs may be 1 idea — always semantic, never algorithmic chunking. NOT for phone inbox (use a phone-inbox ingest skill if configured). NOT for podcast snips (use a snip-processing skill if configured). NOT for bookmark exports (use a bookmarks-ingest skill if configured). For a LARGE existing source export (notes-app dump, chat history, voice-note archive), use /mine — it triages the source, then calibrates the agent's judgment on small batches before the bulk pass. Preserves the owner's exact language — no paraphrasing. |
| required_context_files | ["Orientation_Docs/INTELLECTUAL_LANDSCAPE.md","Orientation_Docs/COGNITIVE_PROFILE.md","Orientation_Docs/KEYWORD_GUIDE.md","Orientation_Docs/CONTENT_TAXONOMY.md","Orientation_Docs/ORIENTATION.md"] |
Ingest Brain Dump
Step 0 — Silent Context Load
Before doing anything else, silently Read each file in required_context_files (listed in frontmatter) if it is not already in your context. Do NOT announce the reads. Do NOT ask permission. This ensures the skill has the orientation it needs without bloating sessions that don't invoke it.
Files:
Orientation_Docs/INTELLECTUAL_LANDSCAPE.md
Orientation_Docs/COGNITIVE_PROFILE.md
Orientation_Docs/KEYWORD_GUIDE.md
Orientation_Docs/CONTENT_TAXONOMY.md
Orientation_Docs/ORIENTATION.md
Orchestrates brain dump ingestion: explore → classify → verify → create → validate.
Quick Start
- User provides unstructured content
- Search Second Brain for related files
- Separate into distinct ideas (semantic, not algorithmic)
- For each idea: verify not duplicate → create file → validate template
- Present approval proposal → execute approved actions
Workflow Checklist
Copy and track:
- [ ] Step 1: Load context (ORIENTATION.md, KEYWORD_GUIDE.md, CONTENT_TAXONOMY.md)
- [ ] Step 2: Invoke explore-second-brain - find related files
- [ ] Step 3: Classify content semantically - identify distinct ideas
- [ ] Step 4: For each NEW_IDEA:
- [ ] Invoke verify-idea - check duplicates
- [ ] If NOT_FOUND: create Template A
- [ ] Run validate_template.py - confirm compliance
- [ ] Step 5: Present approval proposal (see references/output-templates.md)
- [ ] Step 6: Execute approved actions
- [ ] Step 7: Report summary
Critical Principles
- SEMANTIC SEPARATION - Never algorithmic chunking. Identify ideas by conceptual boundaries.
- PRESERVE EXACT LANGUAGE - The owner's keywords are sacred. No paraphrasing.
- VERIFY BEFORE CREATE - Always check for duplicates first.
- VALIDATE AFTER CREATE - Run template validation on every new file.
Content Classification
Identify type for each segment:
| Type | Action |
|---|
| NEW_IDEA | Create Template A in [Category]/ |
| TODO | Add to project TODO file |
| AUGMENT | Propose addition to existing file |
| PREDICTION | Create in Predictions/ |
| READING_LIST | Add to AA_Lists/READING_LIST.md |
| QUESTION | Log only, don't create file |
See references/routing-rules.md for full routing table.
Source Detection
| Source | Template |
|---|
| Claude Code conversation | A (owner's words THIS conversation) |
| Voice dictation / voice notes | A (owner's words only) |
| External podcast / bookmark | B (external content, attribute) |
Verification Step
After creating any file, validate:
python3 .claude/scripts/validate_template.py "[filepath]"
If invalid: fix issues immediately. Only proceed when all files pass.
Approval Proposal
See references/output-templates.md for format.
Present each idea with:
- Proposed path
- Keywords
- Project connections
- Y/N prompt
Wait for explicit approval before creating files.
Integration
| Skill | When |
|---|
explore-second-brain | Step 2 - find related files |
verify-idea | Step 4 - check duplicates |
process-content | Create Template A (if needed) |
extract-todo | Route TODOs to project files |
Tier 2 Dependencies
Load before processing:
ORIENTATION.md - Templates, golden rules
KEYWORD_GUIDE.md - Vocabulary reference
CONTENT_TAXONOMY.md - Categories, folder mappings