Skip to content

csmoya/Open-brain-framework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Open Brain — A Knowledge Management Framework

Open Brain is an opinionated framework for building and maintaining personal knowledge vaults that stay useful as they scale. It addresses the core problem most PKM systems ignore: notes don't just need to be captured — they need to be found, connected, kept alive, tested, and turned into output.

Most knowledge management systems work well at 50 notes. At 500, search gets noisy. At 2,000+, the vault becomes a graveyard of ideas you know you wrote down but can't surface when you need them. And at every scale, without active recall and deliberate output, the knowledge never becomes skill.

Open Brain addresses this with a structured approach across eight modules — from first capture through to published thinking and system automation.


The Eight Modules

Module 1: Knowledge Enrichment

The foundation. Addresses the three failures that compound as a vault grows: notes becoming unfindable, search terms losing discriminative power, and knowledge connections carrying no semantic meaning.

Problems:

Solution:


Module 2: Knowledge Extraction

How raw sources — books, articles, PDFs, web content — become atomic, structured notes. The quality of extraction determines the quality of everything downstream. Includes both passive extraction (from sources you read) and active research (filling gaps you identify).

Problems:

Solutions:


Module 3: Knowledge Maturation

How captured notes become your own ideas. The promotion process that separates storage from understanding.

Problems:

Solutions:

  • The Maturation Ladder — Literature Note → Analyzed → Convergence → Permanent Note → Domain Synthesis
  • Convergence Promotion — The state machine that moves notes from captured to endorsed using convergence signals

Module 4: Active Recall & Practice

How knowledge becomes skill. The practice layer that closes the gap between understanding and doing.

Problems:

  • The Collector's Fallacy — When saving notes feels like learning but produces no retention
  • Skill Stagnation — The gap between understanding a concept and actually doing it well
  • Invisible Progress — Learning without a feedback loop: you don't know if you're improving
  • Course Gate Design — Why linear reading produces recognition but not generation or transfer
  • Context-Absent Output — When AI generates answers without grounding in your actual knowledge
  • The Judgment Gap — The distance between knowing about X and having developed judgment on X
  • Empty Prompting — Using AI as a content dispenser without building judgment: outputs accumulate, capability stays flat

Solutions:

  • The AI-Driven Creation Loop — Delegate Draft → Elevate Output → Challenge Log → Learning Signals → back to vault
  • The Specificity Delta — Measuring the gap between Phase 1 and Phase 2 output as an objective score of how much your knowledge contributes

Module 5: Knowledge Retrieval

How to access what you know — in multiple modes, for different purposes, from any context.

Problems:

Solution:


Module 6: Vault Health & Maintenance

How to keep a large vault reliable. The immune system that prevents structural decay.

Problems:

Solutions:

  • The Vault Immune System — Automated detection, eval scorecard, continuous graph maintenance, periodic review
  • Graph Myelination — Traversal-reinforced edge weights that make the graph self-organize around how you actually think

Module 7: Knowledge Output

How a full vault becomes published thinking. The output layer that closes the loop.

Problems:

Solution:


Module 8: System Automation

How to discover and eliminate manual repetition in your own workflow. The meta-layer that makes the system improve itself over time.

Problems:

Solution:


Framework Context

How Open Brain relates to the traditions it draws from — and where it diverges.


Design Principles

Content is sacred; metadata is the lever. Enrichment and maintenance operations never modify the core insight in a note. They improve the metadata, connections, and structure that make notes findable and usable.

Additive only. The framework adds search terms, connections, and structure. It never silently removes or rewrites existing content.

Human in the loop. The framework proposes changes; the author approves them. No automated edits without consent.

Diagnosis before treatment. Every maintenance operation starts with a scan. Fix what the data says is broken, not what you assume.

Active recall over passive review. Reading notes is not learning. Testing recall, producing answers, and applying knowledge to new cases is learning.

Output closes the loop. Knowledge that never becomes output — writing, decisions, conversations — hasn't been integrated. The vault exists to make you better at thinking, not to make you better at storing.


Who This Is For

Open Brain is built for knowledge workers who:

  • Use Obsidian, Logseq, or any linked-note tool and have outgrown basic tagging
  • Have 500+ notes and notice that search is getting worse, not better
  • Want their vault to function as a retrieval system, not just a storage system
  • Care about the structure of knowledge, not just the volume
  • Want to close the loop from reading → notes → synthesis → skill → output

Repository Structure

docs/
├── retrieval-decay.md                  # Module 1: Why notes become unfindable
├── term-saturation.md                  # Module 1: When search terms lose power
├── knowledge-graph-signal-noise.md     # Module 1: Why generic links degrade graph value
├── enrichment-pattern.md               # Module 1: The systematic solution (solution doc)
│
├── source-overwhelm.md                 # Module 2: The unprocessed inbox problem
├── atomic-note-decomposition.md        # Module 2: Getting granularity right
├── re-reading-trap.md                  # Module 2: When notes fail as references
├── reactive-knowledge-accumulation.md  # Module 2: Vault mirrors reading history, not knowledge gaps
├── seven-extraction-layers.md          # Module 2: Why single-layer extraction misses most of a source
├── extraction-pipeline.md              # Module 2: Ingest → Index → Extract (solution doc)
├── autonomous-research-loop.md         # Module 2: Filling gaps via targeted multi-round research (solution doc)
│
├── literature-note-graveyard.md        # Module 3: Notes that never become ideas
├── premature-synthesis.md              # Module 3: Building on thin evidence
├── domain-blindness.md                 # Module 3: Not knowing what you know
├── convergence-detection.md            # Module 3: Why two confirming sources beat ten mentioning ones
├── endorsement-gap.md                  # Module 3: Notes that exist vs. notes you trust
├── maturation-ladder.md                # Module 3: From captured to owned (solution doc)
├── convergence-promotion.md            # Module 3: State machine for convergence-based promotion (solution doc)
│
├── collectors-fallacy.md               # Module 4: Saving ≠ learning
├── skill-stagnation.md                 # Module 4: Understanding ≠ doing
├── invisible-progress.md               # Module 4: Learning without feedback
├── course-gate-design.md               # Module 4: Why linear study produces recognition, not transfer
├── context-absent-output.md            # Module 4: AI output without your knowledge context
├── judgment-gap.md                     # Module 4: Knowing about X vs. having judgment on X
├── empty-prompting.md                  # Module 4: Using AI without building judgment — outputs accumulate, capability stays flat
├── practice-loop.md                    # Module 4: Delegate Draft → Elevate Output → Challenge Log → Learning Signals (solution doc)
├── specificity-delta.md                # Module 4: Measuring how much your vault elevates Phase 2 output (solution doc)
├── learning-science-of-courses.md      # Module 4+: Learning science foundations for course design
├── three-gate-progression.md           # Module 4+: Vocabulary → Production → Transfer gate model
│
├── search-box-bottleneck.md            # Module 5: Why text search degrades
├── isolated-retrieval.md               # Module 5: Notes without their context
├── knowledge-portability.md            # Module 5: Vault stranded on one device
├── multi-modal-retrieval.md            # Module 5: Four retrieval modes (solution doc)
│
├── structural-debt.md                  # Module 6: Compounding vault pathologies
├── unmeasured-vault.md                 # Module 6: No metrics, no signal
├── manual-maintenance-ceiling.md       # Module 6: Manual review doesn't scale
├── uniform-graph-traversal.md          # Module 6: Why all-equal edge weights flatten the graph
├── immune-system-pattern.md            # Module 6: Automated health, human judgment (solution doc)
├── myelination-pattern.md              # Module 6: Traversal-reinforced graph self-organization (solution doc)
│
├── blank-page-full-vault.md            # Module 7: Full vault, blank page
├── writing-without-evidence.md         # Module 7: Opinions without vault evidence
├── single-perspective-blindness.md     # Module 7: The limit of self-review
├── knowledge-grounded-output.md        # Module 7: Claim → Evidence → Draft → Review (solution doc)
│
├── manual-repetition-overhead.md       # Module 8: Cost of tasks without recognized patterns
├── automation-discovery-pattern.md     # Module 8: Mining session history for automation candidates (solution doc)
│
└── pkm-genealogy.md                    # Framework Context: How Open Brain extends Forte, Zettelkasten, and Deliberate Practice

Further Reading

  • Ahrens, S. (2017). How to Take Smart Notes. — The Zettelkasten foundation that Open Brain extends.
  • Matuschak, A. Evergreen Notes. — The concept of notes that develop over time, which enrichment operationalizes.
  • Bush, V. (1945). As We May Think. — The original vision of associative trails that typed connections implement.
  • Roediger, H.L. & Karpicke, J.D. (2006). Test-Enhanced Learning. — The science behind active recall over passive review.
  • Wozniak, P. (1990). Optimization of Learning. — The spaced repetition foundation for SM-2 scheduling.

License

MIT — Use it, adapt it, extend it. If it helps you think better, that's the point.

About

The Open Brain Framework — a structured approach to personal knowledge management that scales. Technical docs covering extraction, maturation, active recall, retrieval, vault health, and knowledge output. Built for knowledge workers who use Obsidian or linked-note tools and want their vault to function as a retrieval system, not just storage.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors