Second Brain Core

A knowledge management system structure designed for AI-assisted personal knowledge management.

Overview

This repository provides a foundational folder structure for building a "Second Brain" - a personal knowledge management system that leverages AI agents to help you capture, process, synthesize, and publish information.

Folder Structure

Second_Brain_Core/
├── source_documents/       # Raw original materials (PDFs, spreadsheets, downloads)
├── ingested_documents/     # Processed, AI-ready markdown versions
├── user_created_documents/ # Your original analysis, notes, and synthesis
└── published_documents/    # Finalized content ready for sharing

Document Flow

Source → Ingest → Create → Publish

1. SOURCE: Add raw documents (PDFs, Excel, articles)
2. INGEST: Convert to markdown for AI processing
3. CREATE: Write analysis, notes, and insights
4. PUBLISH: Finalize and share externally

Model Instructions

Each folder contains a 1model_instructions.md file that provides:

• Context for AI agents working in that folder
• Workflow guidelines and best practices
• Document templates and naming conventions
• Quality standards and checklists

These instructions help AI assistants (like Claude, GPT, etc.) understand how to work within your knowledge management system.

Getting Started

1. Clone this repository into your working directory
2. Add source documents - Drop PDFs, spreadsheets, or articles into source_documents/
3. Ingest content - Convert sources to markdown in ingested_documents/
4. Create insights - Write your analysis in user_created_documents/
5. Publish - Move finalized work to published_documents/

Recommended Tools

Document Conversion

• PyMuPDF (pymupdf) - PDF to markdown
• OpenPyXL (openpyxl) - Excel to markdown
• Pandoc - Universal document converter

AI Integration

• Claude Code - AI assistant with file access
• Weaviate - Vector database for semantic search
• GPT-4 Vision - OCR for images and screenshots

Example Conversion Script

# convert_pdf_to_md.py
import pymupdf

def convert_pdf(filepath):
    doc = pymupdf.open(filepath)
    markdown = ""
    for i, page in enumerate(doc):
        markdown += f"<!-- Page {i+1} -->\n"
        markdown += page.get_text() + "\n\n"
    return markdown

Philosophy

The Second Brain approach:

1. Capture everything - Don't rely on memory; externalize knowledge
2. Process for understanding - Convert to formats you can search and analyze
3. Synthesize insights - Create original work from your sources
4. Share what's valuable - Publish to help others and solidify understanding

Contributing

Feel free to:

• Fork and customize for your needs
• Submit issues for improvements
• Share your adaptations

License

MIT License - Use freely, modify as needed.

---

Built for the age of AI-assisted knowledge work.